1MAN-RECODE(1)                 Manual pager utils                 MAN-RECODE(1)
2
3
4

NAME

6       man-recode - convert manual pages to another encoding
7

SYNOPSIS

9       man-recode -t to-code {--suffix=suffix|--in-place} [-dqhV] [filename]
10

DESCRIPTION

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

OPTIONS

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

SEE ALSO

57       iconv(1), man(1), manconv(1)
58

BUGS

60       https://gitlab.com/cjwatson/man-db/-/issues
61       https://savannah.nongnu.org/bugs/?group=man-db
62

AUTHOR

64       Colin Watson (cjwatson@debian.org).
65
66
67
682.10.0                            2022-02-04                     MAN-RECODE(1)