diff options
| author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-05-06 01:16:24 +0000 |
|---|---|---|
| committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-05-06 01:16:24 +0000 |
| commit | 9221dca64f0c8b5de72727491e41cf63e902eaab (patch) | |
| tree | d8cbbf520eb4b5c656a54b2e36947008dcb751ad /man/man1/manconv.man1 | |
| parent | Initial commit. (diff) | |
| download | man-db-9221dca64f0c8b5de72727491e41cf63e902eaab.tar.xz man-db-9221dca64f0c8b5de72727491e41cf63e902eaab.zip | |
Adding upstream version 2.8.5.upstream/2.8.5upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man/man1/manconv.man1')
| -rw-r--r-- | man/man1/manconv.man1 | 78 |
1 files changed, 78 insertions, 0 deletions
diff --git a/man/man1/manconv.man1 b/man/man1/manconv.man1 new file mode 100644 index 0000000..7731575 --- /dev/null +++ b/man/man1/manconv.man1 @@ -0,0 +1,78 @@ +.\" 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 +.IR 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. +.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) +.SH AUTHOR +.nf +.if !'po4a'hide' Colin Watson (cjwatson@debian.org). +.fi |