.\" 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.
.pc
.TH %thmanconv% 1 "%date%" "%version%" "Manual pager utils"
.SH NAME
%manconv% \- convert manual page from one encoding to another
.SH SYNOPSIS
.B %manconv%
.B \-f
.RI [\| from-code \|[: from-code \|.\|.\|.]\|]
.B \-t
.I to-code
.RB [\| \-dqhV \|]
.RI [\| filename \|]
.SH DESCRIPTION
.B %manconv%
converts a manual page from one encoding to another, like
.BR iconv .
Unlike
.BR 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.
.PP
If an encoding declaration is found on the first line of the manual page,
that declaration overrides any input encodings specified on
.BR %manconv% 's
command line.
Encoding declarations have the following form:
.PP
.RS
.nf
.if !'po4a'hide' \&\(aq\e" \-*\- coding: UTF\-8 \-*\-
.fi
.RE
.PP
or (if manual page preprocessors are also to be declared):
.PP
.RS
.nf
.if !'po4a'hide' \&\(aq\e" t \-*\- coding: ISO\-8859\-1 \-*\-
.fi
.RE
.SH OPTIONS
.TP
\fB\-f\fP \fIencodings\fP, \fB\-\-from\-code\fP \fIencodings\fP
Try each of
.I encodings
(a colon-separated list) in sequence as the input encoding.
The default is to guess likely input encodings based on the file name.
.TP
\fB\-t\fP \fIencoding\fP, \fB\-\-to\-code\fP \fIencoding\fP
Convert the manual page to
.IR encoding .
.TP
.if !'po4a'hide' .BR \-q ", " \-\-quiet
Do not issue error messages when the page cannot be converted.
.TP
.if !'po4a'hide' .BR \-d ", " \-\-debug
Print debugging information.
.TP
.if !'po4a'hide' .BR \-h ", " \-\-help
Print a help message and exit.
.TP
.if !'po4a'hide' .BR \-V ", " \-\-version
Display version information.
.SH "SEE ALSO"
.if !'po4a'hide' .IR iconv (1),
.if !'po4a'hide' .IR %man% (1),
.if !'po4a'hide' .IR %man_recode% (1)
.SH AUTHOR
.nf
.if !'po4a'hide' Colin Watson (cjwatson@debian.org).
.fi
.SH BUGS
.if !'po4a'hide' https://gitlab.com/cjwatson/man-db/-/issues
.br
.if !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man-db
