manconv (1)

Leading comments

Man page for manconv

Copyright (c) 2007, 2008 Colin Watson <cjwatson@debian.org>

You may distribute under the terms of the GNU General Public
License as specified in the file COPYING that comes with the
man-db distribution.

(The comments found at the beginning of the groff file "man1/manconv.1".)

NAME

manconv - convert manual page from one encoding to another

SYNOPSIS

manconv -f from-code[:from-code...] -t to-code [-dqhV] [filename]

DESCRIPTION

manconv converts a manual page from one encoding to another, like iconv. Unlike iconv, it can try multiple possible input encodings in sequence. This is useful for manual pages installed in directories without an explicit encoding declaration, since they may be in UTF-8 or in a legacy character set.

If an encoding declaration is found on the first line of the manual page, that declaration overrides any input encodings specified on manconv's command line. Encoding declarations have the following form:

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

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

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

OPTIONS

-f encodings, --from-code encodings

Try each of encodings (a colon-separated list) in sequence as the input encoding.

-t encoding, --to-code encoding

Convert the manual page to encoding.

-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

iconv(1), man(1)

AUTHOR

Colin Watson (cjwatson@debian.org).