NAME

       recode - converts files between character sets

SYNOPSIS

       recode [OPTION]... [ [CHARSET] | REQUEST [FILE]... ]

DESCRIPTION

       Free `recode' converts files between various character sets and surfaces.

       If  a  long option shows an argument as mandatory, then it is mandatory for the equivalent
       short option also.  Similarly for optional arguments.

   Listings:
       -l, --list[=FORMAT]
              list one or all known charsets and aliases

       -k, --known=PAIRS
              restrict charsets according to known PAIRS list

       -h, --header[=[LN/]NAME]
              write table NAME on stdout using LN, then exit

       -F, --freeze-tables
              write out a C module holding all tables

       -T, --find-subsets
              report all charsets being subset of others

       -C, --copyright
              display Copyright and copying conditions

       --help display this help and exit

       --version
              output version information and exit

   Operation modes:
       -v, --verbose
              explain sequence of steps and report progress

       -q, --quiet, --silent
              inhibit messages about irreversible recodings

       -f, --force
              force recodings even when not reversible

       -t, --touch
              touch the recoded files after replacement

       -i, --sequence=files
              use intermediate files for sequencing passes

       --sequence=memory
              use memory buffers for sequencing passes

       -p, --sequence=pipe
              use pipe machinery for sequencing passes

   Fine tuning:
       -s, --strict
              use strict mappings, even loose characters

       -d, --diacritics
              convert only diacritics or alike for HTML/LaTeX

       -S, --source[=LN]
              limit recoding to strings and comments as for LN

       -c, --colons
              use colons instead of double quotes for diaeresis

       -g, --graphics
              approximate IBMPC rulers by ASCII graphics

       -x, --ignore=CHARSET
              ignore CHARSET while choosing a recoding path

       Option -l 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 -k, 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.

       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.

       If none of -i and -p are given, presume -p if no FILE, else -i.  Each FILE is recoded over
       itself, destroying the original.  If no FILE is specified, then act as a filter and recode
       stdin to stdout.

AUTHOR

       Written by Franc,ois Pinard <pinard@iro.umontreal.ca>.

REPORTING BUGS

       Report bugs to <recode-bugs@iro.umontreal.ca>.

COPYRIGHT

       Copyright © 1990, 92, 93, 94, 96, 97, 99 Free Software Foundation, Inc.
       This is free software; see the source for copying conditions.  There is NO  warranty;  not
       even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

       The  full  documentation  for  recode  is maintained as a Texinfo manual.  If the info and
       recode programs are properly installed at your site, the command

              info recode

       should give you access to the complete manual.