.\" 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 docs/COPYING.GPLv2 that comes with the
.\" man-db distribution.
.pc ""
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH MAN-RECODE 1 2023-09-23 2.12.0 "Utilidades do paginador do manual"
.SH NOME
man-recode \- converte páginas do manual para outra codificação
.SH SINOPSE
\fBman-recode\fP \fB\-t\fP \fIpara\-código\fP
{\|\fB\-\-suffix=\fP\fIsufixo\/\fP\||\|\fB\-\-in\-place\fP\|} [\|\fB\-dqhV\fP\|]
[\|\fInomefich\fP\|]
.SH DESCRIÇÃO
\fBman-recode\fP converte múltiplas páginas do manual de uma codificação para
outra, adivinhando a codificação de entrada apropriada para cada uma. É útil
ao recodificar permanentemente páginas escritas em conjuntos de caracteres
ultrapassados, ou em sistemas de construção que precisam de recodificar um
grupo de páginas numa única codificação comum (habitualmente UTF\-8) para
instalação. Ao converter várias páginas do manual, este programa é muito
mais rápido que executar \fBman \-\-recode\fP ou \fBmanconv\fP em cada página.
.PP
Se for encontrada uma declaração de codificação na primeira linha da página
do manual, essa declaração é usada como codificação de entrada dessa
página. Se isto falhar, a codificação de entrada é adivinhada com base no
nome do ficheiro.
.PP
As declarações de codificação têm a seguinte forma:
.PP
.RS
.nf
.if  !'po4a'hide' \&\(aq\e" \-*\- coding: UTF\-8 \-*\-
.fi
.RE
.PP
ou (se os pré\-processadores de páginas do manual também forem declarados):
.PP
.RS
.nf
.if  !'po4a'hide' \&\(aq\e" t \-*\- coding: ISO\-8859\-1 \-*\-
.fi
.RE
.SH OPÇÕES
.TP 
\fB\-t\fP \fIcodificação\/\fP, \fB\-\-to\-code=\fP\fIcodificação\fP
Converte páginas do manual para \fIcodificação\fP
.TP 
\fB\-\-suffix=\fP\fIsufixo\fP
Forma cada nome de ficheiros de saída acrescentando \fIsuffix\fP ao nome do
ficheiro de entrada, após remover qualquer extensão de compressão.
.TP 
.if  !'po4a'hide' .B \-\-in\-place
Sobrepõe cada ficheiro de entrada com a saída, após remover qualquer
extensão de compressão.
.TP 
.if  !'po4a'hide' .BR \-q ", " \-\-quiet
Não emite mensagens de erro quando a página não puder ser convertida.
.TP 
.if  !'po4a'hide' .BR \-d ", " \-\-debug
imprime informação de depuração.
.TP 
.if  !'po4a'hide' .BR \-h ", " \-\-help
mostra uma mensagem de ajuda e sai.
.TP 
.if  !'po4a'hide' .BR \-V ", " \-\-version
mostra informação da versão.
.SH "VEJA TAMBÉM"
.if  !'po4a'hide' .IR iconv (1),
.if  !'po4a'hide' .IR man (1),
.if  !'po4a'hide' .IR manconv (1)
.SH ERROS
.if  !'po4a'hide' https://gitlab.com/man-db/man-db/-/issues
.br
.if  !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man-db
.SH AUTOR
.nf
.if  !'po4a'hide' Colin Watson (cjwatson@debian.org).
.fi