NAME

cvtenc - file encoding converter

SYNOPSIS

cvtenc [-Encoding encoding] [-EscapeIn yes|NO] [-EscapeOut yes|NO] filename

DESCRIPTION

Converts a file encoded in a specified or default non-unicode encoding to unicode (UTF16), or, if the file is already in unicode, converts it to a specified or default non-unicode encoding. The converted text is printed to standard out. If the filename is a hyphen then this tool reads from standard input.

OPTIONS

-Encoding encoding

Specify non-unicode encoding to be used. The direction of conversion depends on whether the file given as input is recognized as unicode (from the higher order bytes). To get a list of available encodings, enter "list" for the encoding. If this is not specified, the default encoding for the current locale is used.

-EscapeIn YES|NO

Specify '-EscapeIn YES' (the default is 'NO') to parse the input for \u escape sequences (as in property lists).

-EscapeOut YES|NO

Specify '-EscapeOut YES' (the default is 'NO') to generate \u escape sequences (as in property lists) in the output. Note, this might produce unexpected results for some encodings.

-Unicode IN|OUT

Specify '-Unicode IN' (or '-Unicode OUT') to control the direction of conversion rather than having the tool guess it on the basis of the content it reads. Using '-Unicode IN' means that the tool reads UTF16 data and writes C-String data, while using '-Unicode OUT' merans that the tool reads C-String data and writes UTF16 data.

HISTORY

Written in 2002. Minr update in 2010.

This manual page first appeared in gnustep-base 1.9.2 (March 2004).

AUTHORS

cvtenc was written by Richard Frith-Macdonald <rfm@gnu.org>