.\" Man page for man-recode
.\"
.\" Copyright (C) 2019 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 ""
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH MAN-RECODE 1 2021-02-08 2.9.4 手册分页显示工具
.SH 名称
man-recode \- 将手册页转换为另一种编码
.SH 概述
\fBman-recode\fP \fB\-t\fP \fI目标编码\fP
{\|\fB\-\-suffix=\fP\fIsuffix\/\fP\||\|\fB\-\-in\-place\fP\|} [\|\fB\-dqhV\fP\|] [\|\fI文件名\fP\|]
.SH 描述
\fBman-recode\fP 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 \fBman \-\-recode\fP or \fBmanconv\fP on
each page.
.PP
如果在手册页的第一行找到了编码声明，该声明将作为处理该手册页所使用的编码。否则将基于文件名猜测输入的编码方式。
.PP
编码的声明应使用如下的格式：
.PP
.RS
.nf
.if  !'po4a'hide' \&\(aq\e" \-*\- coding: UTF\-8 \-*\-
.fi
.RE
.PP
或(如果手册页预处理器也要声明)：
.PP
.RS
.nf
.if  !'po4a'hide' \&\(aq\e" t \-*\- coding: ISO\-8859\-1 \-*\-
.fi
.RE
.SH 选项
.TP 
\fB\-t\fP \fIencoding\/\fP, \fB\-\-to\-code=\fP\fI编码\fP
将手册页转换为制定 \fI编码\fP。
.TP 
\fB\-\-suffix=\fP\fI后缀\fP
Form each output file name by appending \fIsuffix\fP to the input file name,
after removing any compression extension.
.TP 
.if  !'po4a'hide' .B \-\-in\-place
Overwrite each input file with the output, after removing any compression
extension.
.TP 
.if  !'po4a'hide' .BR \-q ", " \-\-quiet
在页面无法转换时不显示错误消息。
.TP 
.if  !'po4a'hide' .BR \-d ", " \-\-debug
打印调试信息。
.TP 
.if  !'po4a'hide' .BR \-h ", " \-\-help
打印帮助消息并退出。
.TP 
.if  !'po4a'hide' .BR \-V ", " \-\-version
显示版本信息。
.SH 亦见
.if  !'po4a'hide' .IR iconv (1),
.if  !'po4a'hide' .IR man (1),
.if  !'po4a'hide' .IR manconv (1)
.SH BUGS
.if  !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man-db
.SH 作者
.nf
.if  !'po4a'hide' Colin Watson (cjwatson@debian.org).
.fi