.\" $$Id: cceconv.1 1.0 1998/03/31 01:50:37 blin Exp blin $$
.TH cceconv 1 "cceconv v1.0" "2003.08.09"

.SH NAME

cceconv \- CCE GB2312/GBK/Big5/JIS/ShiftJIS/KSC/UHC DOS/Unix Universal Convertor 

.SH SYNOPSYS

cceconv [options] <CONVOPTION> [-o file ...] [-n infile outfile ...]
.PP
Options:
.PP
[-hkqV] [--help] [--keepdate] [--keepperm] [--quiet] [--version]
.PP
<CONVOPTION>  -gb2big|-big2gb|-gbk2big|-big2gbk|-gb2sjis|-sjis2gb|-sjis2euc|-euc2sjis|-gb2ksc|-ksc2gb|...
.PP
<CONVOPTION>  -dos2unix|-unix2dos|-d2u|-u2d

.SH DESCRIPTION
The program is a universal encoding convertor which can convert
encodings between Chinese(GB2312/GBK/Big5) Japanese(JIS/ShiftJIS) and Korean(KSC/UHC). 
It is a internal code convertor for hanzis in different encoding systems. GBK is a superset
of GB and UHC is a superset of KSC, so no need to do gb2gbk or ksc2uhc conversion.
Also, it can convert DOS and Unix files. It can operate in stream(stdin/stdout)
mode, old file mode(will overwrite old file) and new file mode(assign
new filename).

.SH OPTIONS

The following options are available:
.TP
.B \-h --help
Print online help.

.TP
.B \-k --keepdate
Keep the date stamp of output file same as input file.

.TP
.B \-p --keepperm
Keep the permision mode of output file same as input file.

.TP
.B \-q --quiet
Quiet mode. Suppress all warning and messages.

.TP
.B \-V --version
Prints version information.

.TP
.B \-o --oldfile file ...
Old file mode. Convert the file and write output to it. The program 
default to run in this mode. Wildcard names may be used.

.TP 
.B \-n --newfile infile outfile ...
New file mode. Convert the infile and write output to outfile. File names
must be given in pairs and wildcard names should NOT be used or you WILL 
lost your files. 

.TP
.B \-gb2big|-big2gb|-gbk2big|-big2gbk ...
Conversion between Chinese encoding, basically you can use any combination
from gb,gbk,big,jis,sjis,shiftjis,ksc,uhc. The half-width Japanese kanas will 
be converted to full-width kanas if it's not a conversion between EUC-JP and Shift-JIS
(Shift-JIS uses 0xA0-0xDF for half-width kanas).

.TP
.B \-sjis2jis|-jis2sjis|-gb2jis|-jis2gb|-jis2ksc|-ksc2jis ...
Conversion between Japanese encoding EUC-JP, Shift-JIS and Chinese/Korean. Half-width kanas will be
keeped in EUC-JP(preceded by 0x8E) and Shift-JIS(0xA0-DF).

.TP
.B \-gb2ksc|-ksc2gb|-gbk2uhc|-uhc2gbk ...
Conversion between Korean, Chinese and Japanese hanzis. Currently, UHC is not fully supported yet(it is the same as KSC).


.SH EXAMPLES

.LP
Get input from stdin and write output to stdout.
.IP
.B cceconv

.LP
Convert and replace a.txt. Convert and replace b.txt.
.IP
.B cceconv a.txt b.txt
.IP
.B cceconv -o a.txt b.txt

.LP
Convert and replace a.txt while keeping original date stamp.
.IP
.B cceconv -k a.txt
.IP
.B cceconv -k -o a.txt

.LP
Convert a.txt and write to e.txt.
.IP
.B cceconv -n a.txt e.txt

.LP
Convert a.txt and write to e.txt, keep date stamp of e.txt same as a.txt.
.IP
.B cceconv -k -n a.txt e.txt 

.LP
Convert and replace a.txt. Convert b.txt and write to e.txt.
.IP
.B cceconv a.txt -n b.txt e.txt
.IP
.B cceconv -o a.txt -n b.txt e.txt

.LP
Convert c.txt and write to e.txt. Convert and replace a.txt.
Convert and replace b.txt. Convert d.txt and write to f.txt.
.IP
.B cceconv -n c.txt e.txt -o a.txt b.txt -n d.txt f.txt

.SH SEE ALSO
cce(1)