.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "INSTALL-DOCS 8" .TH INSTALL-DOCS 8 "21 January 2024" "doc-base v0.11.2" Debian .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NOME .IX Header "NOME" install-docs \- gere documentação online de Debian .SH SUMÁRIO .IX Header "SUMÁRIO" .Vb 1 \& install\-docs [options] \-i,\-\-install | \-r,\-\-remove | \-c,\-\-check file [ file ... ] \& \& install\-docs [options] \-I,\-\-install\-all | \-C,\-\-install\-changed | \-R,\-\-remove\-all \& \& install\-docs [options] \-s,\-\-status docid [ docid ... ] \& \& install\-docs [options] \-\-dump\-db dbname \& \& install\-docs \-h,\-\-help | \-V,\-\-version .Ve .SH DESCRIÇÃO .IX Header "DESCRIÇÃO" \&\fBinstall-docs\fR é uma ferramenta que permite a maintainers de pacotes Debian registarem documentação em vários sistemas de documentação. Actualmente suporta os navegadores \fBdhelp\fR, \fBdwww\fR, \fBdochelp\fR, e \fBdoc-central\fR. .PP Este manual fornece um sumário rápido da utilização de \fBinstall-docs\fR. A documentação completa pode ser encontrada na documentação, incluindo a descrição da sintaxe e gramática do ficheiro de controle. .SH OPÇÕES .IX Header "OPÇÕES" .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4 .IX Item "-v, --verbose" Opera em modo detalhado. .IP "\fB\-d\fR, \fB\-\-debug\fR" 4 .IX Item "-d, --debug" Escreve alguma informação de depuração. .IP \fB\-\-no\-update\-menus\fR 4 .IX Item "--no-update-menus" Inibe a execução de \fBdwww\-build\-menu\fR\|(8), e \fBdhelp_parse\fR\|(8). .IP "\fB\-\-rootdir\fR \fIdir\fR" 4 .IX Item "--rootdir dir" Define o directório raiz para \fIdir\fR em vez de `\fI/\fR'. Útil e válido apenas com a opção \fB\-\-check\fR. .SH ACÇÕES .IX Header "ACÇÕES" Em baixo está uma lista de possíveis acções que o \fBinstall-docs\fR pode manusear. Só pode existir uma opção de acção passada ao install-docs, mais ainda, a acção e os seus argumentos têm de ser a última opção passada. .PP Cada argumento \fIfile\fR deve ser o caminho completo para o ficheiro de controle do doc-base (isto é, `/usr/share/doc\-base/some_file' ou `/etc/doc\-base/documents/some_file'), e cada \fIdocid\fR deve ser o identificador do documento (Identificadores de documentos são definidos no campo `Document' do ficheiro de controle, e geralmente correspondem ao nome do pacote.) .PP Se \fIfile\fR ou \fIdocid\fR for igual a `\fB\-\fR' (o sinal menos), a lista de argumentos é lida a partir da entrada standard (cada nome de ficheiro ou documento numa linha separada). .IP "\fB\-i\fR \fIfile\fR [\fIfile\fR ...], \fB\-\-install\fR \fIfile\fR [\fIfile\fR ...]" 4 .IX Item "-i file [file ...], --install file [file ...]" Instala a documentação descrita pelo ficheiro de controle \fIfile\fR. .IP "\fB\-r\fR \fIfile\fR [\fIfile\fR ...], \fB\-\-remove\fR \fIfile\fR [\fIfile\fR ...]" 4 .IX Item "-r file [file ...], --remove file [file ...]" Remove a documentação identificada pelo ficheiro de controle \fIfile\fR. .IP "\fB\-c\fR \fIfile\fR [\fIfile\fR ...], \fB\-\-check\fR \fIfile\fR [\fIfile\fR ...]" 4 .IX Item "-c file [file ...], --check file [file ...]" Verifica o ficheiro de controle \fIfile\fR e mostra número de possíveis problemas encontrados. Use com \fI\-\-verbose\fR para obter as localizações actuais dos erros e avisos. Se for também dado \fI\-\-rootdir\fR, os seus argumentos serão juntados aos nomes dos ficheiros dados nos campos `Files' e `Index' de \fIfile\fR. .IP "\fB\-R\fR, \fB\-\-remove\-all\fR" 4 .IX Item "-R, --remove-all" Apaga o registo de todos os documentos registados. .IP "\fB\-I\fR, \fB\-\-install\-all\fR" 4 .IX Item "-I, --install-all" (Re)regista todos os documentos de \fI/usr/share/doc\-base\fR e \fI/etc/doc\-base/documents\fR. .IP "\fB\-C\fR, \fB\-\-install\-changed\fR" 4 .IX Item "-C, --install-changed" Compara o conteúdo dos directórios \fI/usr/share/doc\-base\fR e \fI/etc/doc\-base/documents\fR com a base de dados de documentos registados e apaga o registo de quaisquer ficheiros que estejam em falta e re-regista apenas os ficheiros alterados ou novos. .IP "\fB\-s\fR \fIdocid\fR [\fIdocid\fR ...], \fB\-\-status\fR \fIdocid\fR [\fIdocid\fR ...]" 4 .IX Item "-s docid [docid ...], --status docid [docid ...]" Mostra o estado do identificador do documento \fIdocid\fR. .IP "\fB\-L\fR \fIdocid\fR [\fIdocid\fR ...], \fB\-\-listfiles\fR \fIdocid\fR [\fIdocid\fR ...]" 4 .IX Item "-L docid [docid ...], --listfiles docid [docid ...]" Opção descontinuada. Nada faz. .IP "\fB\-\-dump\-db\fR \fIdbname\fR" 4 .IX Item "--dump-db dbname" Despeja o conteúdo das bases de dados internas, para objectivos de depuração. \fIdbname\fR pode ser ou \fBfiles.db\fR ou \fBstatus.db\fR. .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" Mostra uma mensagem curta de ajuda. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" Mostra informação da versão. .SH "PROBLEMAS DE COMPATIBILIDADE" .IX Header "PROBLEMAS DE COMPATIBILIDADE" As seguintes funcionalidades foram adicionadas na versão 0.8.4, por favor certifique-se de adicionar as linhas `\fIConflicts\fR' ou `\fIDepends\fR' apropriadas se deseja usa-las nos scripts do seu pacote: .IP \(bu 4 suporte para passar mais do que um argumento às acções \fB\-i\fR e \fB\-r\fR, .IP \(bu 4 lendo argumentos a partir da entrada standard, .IP \(bu 4 acções \fB\-I\fR,\fB\-\-install\-all\fR, \fB\-R\fR, \fB\-\-\-remove\-all\fR, \fB\-c\fR, \fB\-\-check\fR, .IP \(bu 4 opções \fB\-d\fR, \fB\-\-debug\fR, \fB\-h\fR, \fB\-\-help\fR. .PP As opções \fB\-C\fR, \fB\-\-install\-changed\fR, \fB\-\-dump\-db\fR, \fB\-V\fR, \fB\-\-version\fR foram adicionadas em 0.8.12. .SH FICHEIROS .IX Header "FICHEIROS" .IP \fI/usr/share/doc\-base/\fR 4 .IX Item "/usr/share/doc-base/" A localização de ficheiros de controle doc-base fornecidos por vários pacotes. .IP \fI/etc/doc\-base/documents/\fR 4 .IX Item "/etc/doc-base/documents/" A localização de ficheiros de controle doc-base fornecidos pelo administrador local. .IP \fI/var/lib/doc\-base/info/documents/\fR 4 .IX Item "/var/lib/doc-base/info/documents/" A localização de ficheiros de controle registados. .IP \fI/var/lib/doc\-base/info/status.db\fR 4 .IX Item "/var/lib/doc-base/info/status.db" Estados dos documentos registados. .IP \fI/var/lib/doc\-base/info/files.db\fR 4 .IX Item "/var/lib/doc-base/info/files.db" Carimbos temporais e ids de documentos de ficheiros doc-base registados. .SH BUGS .IX Header "BUGS" Veja . .SH "VEJA TAMBÉM" .IX Header "VEJA TAMBÉM" \&\fBdhelp\fR\|(1), \fBdoccentral\fR\|(1), \fBdochelp\fR\|(1), \fBdwww\fR\|(7), Manual doc-base de Debian \fI/usr/share/doc/doc\-base/doc\-base.html/index.html\fR .SH AUTOR .IX Header "AUTOR" Este programa foi originalmente escrito por Christian Schwarz , para o sistema Debian GNU/Linux, e o seguinte responsável de manutenção foi Adam Di Carlo . Robert Luberda é actualmente quem o mantêm e expande. .PP Este software foi destinado ao benefício da inteira comunidade de desenvolvedores e utilizadores de Debian. Se você está interessado em envolver-se com este software, por favor junte-se à lista de mail .