1MAN-RECODE(1) Manual pager utils MAN-RECODE(1)
2
3
4
6 man-recode - convert manual pages to another encoding
7
9 man-recode -t to-code {--suffix=suffix|--in-place} [-dqhV] [filename]
10
12 man-recode converts multiple manual pages from one encoding to another,
13 guessing the appropriate input encoding for each one. It is useful
14 when permanently recoding pages written in legacy character sets, or in
15 build systems that need to recode a set of pages to a single common en‐
16 coding (usually UTF-8) for installation. When converting many manual
17 pages, this program is much faster than running man --recode or manconv
18 on each page.
19
20 If an encoding declaration is found on the first line of a manual page,
21 then that declaration is used as the input encoding for that page.
22 Failing that, the input encoding is guessed based on the file name.
23
24 Encoding declarations have the following form:
25
26 '\" -*- coding: UTF-8 -*-
27
28 or (if manual page preprocessors are also to be declared):
29
30 '\" t -*- coding: ISO-8859-1 -*-
31
33 -t encoding, --to-code=encoding
34 Convert manual pages to encoding.
35
36 --suffix=suffix
37 Form each output file name by appending suffix to the input file
38 name, after removing any compression extension.
39
40 --in-place
41 Overwrite each input file with the output, after removing any
42 compression extension.
43
44 -q, --quiet
45 Do not issue error messages when the page cannot be converted.
46
47 -d, --debug
48 Print debugging information.
49
50 -h, --help
51 Print a help message and exit.
52
53 -V, --version
54 Display version information.
55
57 iconv(1), man(1), manconv(1)
58
60 https://gitlab.com/cjwatson/man-db/-/issues
61 https://savannah.nongnu.org/bugs/?group=man-db
62
64 Colin Watson (cjwatson@debian.org).
65
66
67
682.10.2 2022-03-17 MAN-RECODE(1)