2005-07-01 21:00:04 +00:00
|
|
|
.\"Copyright (C) 2005 Free Software Foundation, Inc.
|
2005-07-15 22:51:23 +00:00
|
|
|
.\"Copying and distribution of this file, with or without modification,
|
|
|
|
|
.\"are permitted in any medium without royalty provided the copyright
|
|
|
|
|
.\"notice and this notice are preserved.
|
2004-03-31 19:29:50 +00:00
|
|
|
.TH CVTENC "1" "February 2004" "GNUstep" "GNUstep System Manual"
|
|
|
|
|
.SH NAME
|
|
|
|
|
cvtenc \- file encoding converter
|
|
|
|
|
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B cvtenc
|
|
|
|
|
[\fB-Encoding\fR \fIencoding\fR]
|
|
|
|
|
[\fB-EscapeIn\fR \fIyes|NO\fR]
|
|
|
|
|
[\fB-EscapeOut\fR \fIyes|NO\fR]
|
|
|
|
|
\fIfilename\fR
|
|
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.P
|
|
|
|
|
Converts a file encoded in a specified or default non-unicode encoding to
|
2010-08-31 12:14:07 +00:00
|
|
|
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.
|
2004-03-31 19:29:50 +00:00
|
|
|
|
|
|
|
|
.SH OPTIONS
|
|
|
|
|
.IP "\fB\-Encoding\fR \fI encoding\fR" 4
|
|
|
|
|
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.
|
|
|
|
|
.IP "\fB\-EscapeIn\fR \fIYES|NO\fR" 4
|
2014-02-02 07:20:51 +00:00
|
|
|
Specify '\-EscapeIn YES' (the default is 'NO') to parse the input for \\u
|
2004-03-31 19:29:50 +00:00
|
|
|
escape sequences (as in property lists).
|
|
|
|
|
.IP "\fB\-EscapeOut\fR \fIYES|NO\fR" 4
|
2014-02-02 07:20:51 +00:00
|
|
|
Specify '\-EscapeOut YES' (the default is 'NO') to generate \\u escape
|
2004-03-31 19:29:50 +00:00
|
|
|
sequences (as in property lists) in the output. Note, this might produce
|
|
|
|
|
unexpected results for some encodings.
|
2010-08-31 12:14:07 +00:00
|
|
|
.IP "\fB\-Unicode\fR \fIIN|OUT\fR" 4
|
2014-02-02 07:20:51 +00:00
|
|
|
Specify '\-Unicode IN' (or '\-Unicode OUT') to control the direction of
|
2010-08-31 12:14:07 +00:00
|
|
|
conversion rather than having the tool guess it on the basis of the content
|
2014-02-02 07:20:51 +00:00
|
|
|
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
|
2010-08-31 12:14:07 +00:00
|
|
|
C-String data and writes UTF16 data.
|
2004-03-31 19:29:50 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
.SH HISTORY
|
|
|
|
|
.RS 0
|
|
|
|
|
Written in 2002.
|
2010-08-31 12:14:07 +00:00
|
|
|
Minr update in 2010.
|
2004-03-31 19:29:50 +00:00
|
|
|
.P
|
|
|
|
|
This manual page first appeared in gnustep-base 1.9.2 (March 2004).
|
|
|
|
|
.P
|
|
|
|
|
.SH AUTHORS
|
|
|
|
|
.B cvtenc
|
2010-08-31 11:41:49 +00:00
|
|
|
was written by Richard Frith-Macdonald <rfm@gnu.org>
|
