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 or alike for HTML/LaTeX/BibTeX
61
62 -S, --source[=LN]
63 limit recoding to strings and comments as for LN
64
65 -c, --colons
66 use colons instead of double quotes for diaeresis
67
68 -g, --graphics
69 approximate IBMPC rulers by ASCII graphics
70
71 -x, --ignore=CHARSET
72 ignore CHARSET while choosing a recoding path
73
74 Option -l with no FORMAT nor CHARSET list available charsets and sur‐
75 faces. FORMAT is `decimal', `octal', `hexadecimal' or `full' (or one
76 of `dohf'). Unless DEFAULT_CHARSET is set in environment, CHARSET
77 defaults to the locale dependent encoding, determined by LC_ALL,
78 LC_CTYPE, LANG. With -k, possible before charsets are listed for the
79 given after CHARSET, both being tabular charsets, with PAIRS of the
80 form `BEF1:AFT1,BEF2:AFT2,...' and BEFs and AFTs being codes are given
81 as decimal numbers. LN is some language, it may be `c', `perl' or
82 `po'; `c' is the default.
83
84 REQUEST is SUBREQUEST[,SUBREQUEST]...; SUBREQUEST is ENCODING[..ENCOD‐
85 ING]... ENCODING is [CHARSET][/[SURFACE]]...; REQUEST often looks like
86 BEFORE..AFTER, with BEFORE and AFTER being charsets. An omitted
87 CHARSET implies the usual charset; an omitted [/SURFACE]... means the
88 implied surfaces for CHARSET; a / with an empty surface name means no
89 surfaces at all. See the manual.
90
91 Each FILE is recoded over itself, destroying the original. If no FILE
92 is specified, then act as a filter and recode stdin to stdout.
93
95 Written by Fran??ois Pinard <pinard@iro.umontreal.ca>.
96
98 Report bugs at https://github.com/rrthomas/recode
99
101 Copyright © 1990-2018 Free Software Foundation, Inc.
102 This is free software; see the source for copying conditions. There is
103 NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
104 PURPOSE.
105
107 The full documentation for recode is maintained as a Texinfo manual.
108 If the info and recode programs are properly installed at your site,
109 the command
110
111 info recode
112
113 should give you access to the complete manual.
114
115
116
117recode 3.7.6 September 2019 RECODE(1)