1RECODE(1) User Commands RECODE(1)
2
3
4
6 recode - converts files between character sets
7
9 recode [OPTION]... [ [CHARSET] | REQUEST [FILE]... ]
10
12 Recode converts files between various character sets and surfaces.
13
14 If a long option shows an argument as mandatory, then it is mandatory
15 for the equivalent short option also. Similarly for optional argu‐
16 ments.
17
18 Listings:
19 -l, --list[=FORMAT]
20 list one or all known charsets and aliases
21
22 -k, --known=PAIRS
23 restrict charsets according to known PAIRS list
24
25 -h, --header[=[LN/]NAME]
26 write table NAME on stdout using LN, then exit
27
28 -T, --find-subsets
29 report all charsets being subset of others
30
31 -C, --copyright
32 display Copyright and copying conditions
33
34 --help display this help and exit
35
36 --version
37 output version information and exit
38
39 Operation modes:
40 -v, --verbose
41 explain sequence of steps and report progress
42
43 -q, --quiet, --silent
44 inhibit messages about irreversible recodings
45
46 -f, --force
47 force recodings even when not reversible
48
49 -t, --touch
50 touch the recoded files after replacement
51
52 -i, -p, --sequence=STRATEGY
53 ignored for backwards compatibility
54
55 Fine tuning:
56 -s, --strict
57 use strict mappings; discard untranslatable characters
58
59 -d, --diacritics
60 convert only diacritics and special characters for HTML/La‐
61 TeX/BibTeX
62
63 -S, --source[=LN]
64 limit recoding to strings and comments as for LN
65
66 -c, --colons
67 use colons instead of double quotes for diaeresis
68
69 -g, --graphics
70 approximate IBMPC rulers by ASCII graphics
71
72 -x, --ignore=CHARSET
73 ignore CHARSET while choosing a recoding path
74
75 -I, --prefer-iconv
76 use iconv if possible
77
78 Option -l with no FORMAT nor CHARSET list available charsets and sur‐
79 faces. FORMAT is `decimal', `octal', `hexadecimal' or `full' (or one
80 of `dohf'). Unless DEFAULT_CHARSET is set in environment, CHARSET de‐
81 faults to the locale dependent encoding, determined by LC_ALL,
82 LC_CTYPE, LANG. With -k, possible before charsets are listed for the
83 given after CHARSET, both being tabular charsets, with PAIRS of the
84 form `BEF1:AFT1,BEF2:AFT2,...' and BEFs and AFTs being codes are given
85 as decimal numbers. LN is some language, it may be `c', `perl' or
86 `po'; `c' is the default.
87
88 REQUEST is SUBREQUEST[,SUBREQUEST]...; SUBREQUEST is ENCODING[..ENCOD‐
89 ING]... ENCODING is [CHARSET][/[SURFACE]]...; REQUEST often looks like
90 BEFORE..AFTER, with BEFORE and AFTER being charsets. An omitted
91 CHARSET implies the usual charset; an omitted [/SURFACE]... means the
92 implied surfaces for CHARSET; a / with an empty surface name means no
93 surfaces at all. See the manual.
94
95 Each FILE is recoded over itself, destroying the original. If no FILE
96 is specified, then act as a filter and recode stdin to stdout.
97
99 Written by François Pinard <pinard@iro.umontreal.ca>.
100
102 Report bugs at https://github.com/rrthomas/recode
103
105 Copyright © 1990-2022 Free Software Foundation, Inc.
106 This is free software; see the source for copying conditions. There is
107 NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
108 PURPOSE.
109
111 The full documentation for recode is maintained as a Texinfo manual.
112 If the info and recode programs are properly installed at your site,
113 the command
114
115 info recode
116
117 should give you access to the complete manual.
118
119
120
121recode 3.7.12 February 2022 RECODE(1)