recode1
Converts files between character sets
Usage
recode [OPTION] ...
[{[CHARSET] | REQUEST
[FILE] ...}]
Overview
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
-
-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, -p, --sequence=STRATEGY -
ignored for backwards compatibility
Fine tuning:
-
-s, --strict -
use strict mappings; discard untranslatable characters
-
-d, --diacritics -
convert only diacritics and special characters for HTML/LaTeX/BibTeX
-
-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
-
-I, --prefer-iconv -
use iconv if possible
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.
Each FILE is recoded over itself, destroying the original. If no FILE is specified, then act as a filter and recode stdin to stdout.
Maintainer
Maintained by Reuben Thomas <[email protected]>.
Releases
17 releases since Debian 1.3 (Bo); the text changed 11 times.
--colons since Debian 2.2 (Potato);
--copyright since Debian 2.2 (Potato);
--diacritics since Debian 2.2 (Potato);
--find-subsets since Debian 2.2 (Potato);
--force since Debian 2.2 (Potato);
--graphics since Debian 2.2 (Potato);
--help since Debian 2.2 (Potato);
--ignore since Debian 2.2 (Potato);
--known since Debian 2.2 (Potato);
--list since Debian 2.2 (Potato);
--prefer-iconv since Debian 13 (Trixie);
--quiet since Debian 2.2 (Potato);
--sequence since Debian 2.2 (Potato);
--silent since Debian 2.2 (Potato);
--source since Debian 2.2 (Potato);
--strict since Debian 2.2 (Potato);
--touch since Debian 2.2 (Potato);
--verbose since Debian 2.2 (Potato);
--version since Debian 2.2 (Potato);
-C since Debian 2.2 (Potato);
-I since Debian 13 (Trixie);
-S since Debian 2.2 (Potato);
-T since Debian 2.2 (Potato);
-c since Debian 2.2 (Potato);
-d since Debian 2.2 (Potato);
-f since Debian 2.2 (Potato);
-g since Debian 2.2 (Potato);
-i since Debian 2.2 (Potato);
-k since Debian 2.2 (Potato);
-l since Debian 2.2 (Potato);
-p since Debian 2.2 (Potato);
-q since Debian 2.2 (Potato);
-s since Debian 2.2 (Potato);
-t since Debian 2.2 (Potato);
-v since Debian 2.2 (Potato);
-x since Debian 2.2 (Potato).
--freeze-tables until Debian 12 (Bookworm);
-F until Debian 12 (Bookworm).