Provided by: recode_3.6-21_i386 bug

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.