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.