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 Option -l with no FORMAT nor CHARSET list available charsets and sur‐
76 faces. FORMAT is `decimal', `octal', `hexadecimal' or `full' (or one
77 of `dohf'). Unless DEFAULT_CHARSET is set in environment, CHARSET de‐
78 faults to the locale dependent encoding, determined by LC_ALL,
79 LC_CTYPE, LANG. With -k, possible before charsets are listed for the
80 given after CHARSET, both being tabular charsets, with PAIRS of the
81 form `BEF1:AFT1,BEF2:AFT2,...' and BEFs and AFTs being codes are given
82 as decimal numbers. LN is some language, it may be `c', `perl' or
83 `po'; `c' is the default.
84
85 REQUEST is SUBREQUEST[,SUBREQUEST]...; SUBREQUEST is ENCODING[..ENCOD‐
86 ING]... ENCODING is [CHARSET][/[SURFACE]]...; REQUEST often looks like
87 BEFORE..AFTER, with BEFORE and AFTER being charsets. An omitted
88 CHARSET implies the usual charset; an omitted [/SURFACE]... means the
89 implied surfaces for CHARSET; a / with an empty surface name means no
90 surfaces at all. See the manual.
91
92 Each FILE is recoded over itself, destroying the original. If no FILE
93 is specified, then act as a filter and recode stdin to stdout.
94
96 Written by François Pinard <pinard@iro.umontreal.ca>.
97
99 Report bugs at https://github.com/rrthomas/recode
100
102 Copyright © 1990-2018 Free Software Foundation, Inc.
103 This is free software; see the source for copying conditions. There is
104 NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
105 PURPOSE.
106
108 The full documentation for recode is maintained as a Texinfo manual.
109 If the info and recode programs are properly installed at your site,
110 the command
111
112 info recode
113
114 should give you access to the complete manual.
115
116
117
118recode 3.7.9 June 2021 RECODE(1)