man-recode(1) — Linux manual page

MAN-RECODE(1)               Manual pager utils              MAN-RECODE(1)

NAME         top

       man-recode - convert manual pages to another encoding

SYNOPSIS         top

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

DESCRIPTION         top

       man-recode converts multiple manual pages from one encoding to
       another, guessing the appropriate input encoding for each one.  It
       is useful when permanently recoding pages written in legacy
       character sets, or in build systems that need to recode a set of
       pages to a single common encoding (usually UTF-8) for
       installation.  When converting many manual pages, this program is
       much faster than running man --recode or manconv on each page.

       If an encoding declaration is found on the first line of a manual
       page, then that declaration is used as the input encoding for that
       page.  Failing that, the input encoding is guessed based on the
       file name.

       Encoding declarations have the following form:

              '\" -*- coding: UTF-8 -*-

       or (if manual page preprocessors are also to be declared):

              '\" t -*- coding: ISO-8859-1 -*-

OPTIONS         top

       -t encoding, --to-code=encoding
              Convert manual pages to encoding.

       --suffix=suffix
              Form each output file name by appending suffix to the input
              file name, after removing any compression extension.

       --in-place
              Overwrite each input file with the output, after removing
              any compression extension.

       -q, --quiet
              Do not issue error messages when the page cannot be
              converted.

       -d, --debug
              Print debugging information.

       -h, --help
              Print a help message and exit.

       -V, --version
              Display version information.

SEE ALSO         top

       iconv(1), man(1), manconv(1)

BUGS         top

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

AUTHOR         top

       Colin Watson ([email protected]).

COLOPHON         top

       This page is part of the man-db (manual pager suite) project.
       Information about the project can be found at 
       ⟨http://www.nongnu.org/man-db/⟩.  If you have a bug report for this
       manual page, send it to [email protected].  This page was
       obtained from the project's upstream Git repository
       ⟨https://gitlab.com/cjwatson/man-db⟩ on 2025-08-11.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2025-05-19.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       [email protected]

2.13.1                          2025-05-02                  MAN-RECODE(1)

Pages that refer to this page: man(1),  manconv(1)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.