.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.022.
.TH RECODE "1" "January 2001" "Free recode 3.6" FSF
.SH NAME
recode \- converts files between character sets
.SH SYNOPSIS
.B recode
[\fIOPTION\fR]... [ [\fICHARSET\fR] \fI| REQUEST \fR[\fIFILE\fR]... ]
.SH DESCRIPTION
Free `recode' converts files between various character sets and surfaces.
.PP
If a long option shows an argument as mandatory, then it is mandatory
for the equivalent short option also.  Similarly for optional arguments.
.SS "Listings:"
.TP
\fB\-l\fR, \fB\-\-list\fR[=\fIFORMAT\fR]
list one or all known charsets and aliases
.TP
\fB\-k\fR, \fB\-\-known\fR=\fIPAIRS\fR
restrict charsets according to known PAIRS list
.TP
\fB\-h\fR, \fB\-\-header[\fR=\fI[LN\fR/]NAME]
write table NAME on stdout using LN, then exit
.TP
\fB\-F\fR, \fB\-\-freeze\-tables\fR
write out a C module holding all tables
.TP
\fB\-T\fR, \fB\-\-find\-subsets\fR
report all charsets being subset of others
.TP
\fB\-C\fR, \fB\-\-copyright\fR
display Copyright and copying conditions
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.SS "Operation modes:"
.TP
\fB\-v\fR, \fB\-\-verbose\fR
explain sequence of steps and report progress
.TP
\fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR
inhibit messages about irreversible recodings
.TP
\fB\-f\fR, \fB\-\-force\fR
force recodings even when not reversible
.TP
\fB\-t\fR, \fB\-\-touch\fR
touch the recoded files after replacement
.TP
\fB\-i\fR, \fB\-\-sequence\fR=\fIfiles\fR
use intermediate files for sequencing passes
.TP
\fB\-\-sequence\fR=\fImemory\fR
use memory buffers for sequencing passes
.TP
\fB\-p\fR, \fB\-\-sequence\fR=\fIpipe\fR
use pipe machinery for sequencing passes
.SS "Fine tuning:"
.TP
\fB\-s\fR, \fB\-\-strict\fR
use strict mappings, even loose characters
.TP
\fB\-d\fR, \fB\-\-diacritics\fR
convert only diacritics or alike for HTML/LaTeX
.TP
\fB\-S\fR, \fB\-\-source\fR[=\fILN\fR]
limit recoding to strings and comments as for LN
.TP
\fB\-c\fR, \fB\-\-colons\fR
use colons instead of double quotes for diaeresis
.TP
\fB\-g\fR, \fB\-\-graphics\fR
approximate IBMPC rulers by ASCII graphics
.TP
\fB\-x\fR, \fB\-\-ignore\fR=\fICHARSET\fR
ignore CHARSET while choosing a recoding path
.PP
Option \fB\-l\fR with no FORMAT nor CHARSET list available charsets and surfaces.
FORMAT is `decimal', `octal', `hexadecimal' or `full' (or one of `dohf').
Unless DEFAULT_CHARSET is set in environment, CHARSET defaults to the locale
dependent encoding, determined by LC_ALL, LC_CTYPE, LANG.
With \fB\-k\fR, possible before charsets are listed for the given after CHARSET,
both being tabular charsets, with PAIRS of the form `BEF1:AFT1,BEF2:AFT2,...'
and BEFs and AFTs being codes are given as decimal numbers.
LN is some language, it may be `c', `perl' or `po'; `c' is the default.
.PP
REQUEST is SUBREQUEST[,SUBREQUEST]...; SUBREQUEST is ENCODING[..ENCODING]...
ENCODING is [CHARSET][/[SURFACE]]...; REQUEST often looks like BEFORE..AFTER,
with BEFORE and AFTER being charsets.  An omitted CHARSET implies the usual
charset; an omitted [/SURFACE]... means the implied surfaces for CHARSET; a /
with an empty surface name means no surfaces at all.  See the manual.
.PP
If none of \fB\-i\fR and \fB\-p\fR are given, presume \fB\-p\fR if no FILE, else \fB\-i\fR.
Each FILE is recoded over itself, destroying the original.  If no
FILE is specified, then act as a filter and recode stdin to stdout.
.SH AUTHOR
Written by Franc,ois Pinard <pinard@iro.umontreal.ca>.
.SH "REPORTING BUGS"
Report bugs to <recode-bugs@iro.umontreal.ca>.
.SH COPYRIGHT
Copyright \(co 1990, 92, 93, 94, 96, 97, 99 Free Software Foundation, Inc.
.br
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.SH "SEE ALSO"
The full documentation for
.B recode
is maintained as a Texinfo manual.  If the
.B info
and
.B recode
programs are properly installed at your site, the command
.IP
.B info recode
.PP
should give you access to the complete manual.