.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" 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 .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . 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 "25 January 2021" "doc-base v0.11.1" "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 "NOMBRE" .IX Header "NOMBRE" install-docs \- gestión de documentación de Debian en línea .SH "SINOPSIS" .IX Header "SINOPSIS" .Vb 1 \& install\-docs [opciones] \-i,\-\-install | \-r,\-\-remove | \-c,\-\-check file [ archivo ] \& \& install\-docs [opciones] \-I,\-\-install\-all | \-C,\-\-install\-changed | \-R,\-\-remove\-all \& \& install\-docs [opciones] \-s,\-\-status iddoc [ id_del_documento ... ] \& \& install\-docs [opciones] \-\-dump\-db nombre_de_la_base_de_datos \& \& install\-docs \-h,\-\-help | \-V,\-\-version .Ve .SH "DESCRIPCIÓN" .IX Header "DESCRIPCIÓN" \&\fBinstall-docs\fR es una herramienta que permite a los responsables de paquetes de Debian registrar documentación en varios sistemas de documentación. Es compatible con los navegadores \fBdhelp\fR, \fBdwww\fR, \&\fBdochelp\fR, y \fBdoc-central\fR. .PP Esta página de manual ofrece una corta sinopsis del uso de \&\fBinstall-docs\fR. Encontrará información completa en la documentación, incluyendo una descripción de la sintaxis y la gramática del archivo de control. .SH "OPCIONES" .IX Header "OPCIONES" .IP "\fB\-v\fR, \fB\-\-verbose\fR" 4 .IX Item "-v, --verbose" Ejecutarse con verbosidad. .IP "\fB\-d\fR, \fB\-\-debug\fR" 4 .IX Item "-d, --debug" Muestra información de depuración de fallos. .IP "\fB\-\-no\-update\-menus\fR" 4 .IX Item "--no-update-menus" Impide que se ejecuten \fBdwww\-build\-menu\fR\|(8) y \fBdhelp_parse\fR\|(8). .IP "\fB\-\-rootdir\fR \fIdir\fR" 4 .IX Item "--rootdir dir" Configura el directorio raíz como \fIdir\fR en lugar de «\fI/\fR». Útil y válido solo junto con la acción \fB\-\-check\fR. .SH "ACCIONES" .IX Header "ACCIONES" A continuación hay una lista de las acciones posibles que \fBinstall-docs\fR ofrece. Sólo se puede introducir una opción de acción a «install\-docs», y más aún, la acción y sus argumentos deben ser la última opción introducida. .PP Cada argumento \fIarchivo\fR debería ser la ruta absoluta del archivo de control de doc-base (p. ej., «/usr/share/doc\-base/archivo» o «/etc/doc\-base/documents/archivo»), y cada \fIiddoc\fR debería ser la identificación del documento (Los identificadores de documentos se definen en el campo de «Document» en el archivo de control, y normalmente se corresponden con el nombre del paquete). .PP Si \fIarchivo\fR o \fIiddoc\fR equivalen a «\fB\-\fR», la lista de argumentos se leerá por la entrada estándar (cada nombre de archivo o id de documento debe estar en una línea separada). .IP "\fB\-i\fR \fIarchivo\fR [\fIarchivo\fR ...], \fB\-\-install\fR \fIarchivo\fR [\fIarchivo\fR ...]" 4 .IX Item "-i archivo [archivo ...], --install archivo [archivo ...]" Instala la documentación que se describe en el archivo de control \&\fIarchivo\fR. .IP "\fB\-r\fR \fIarchivo\fR [\fIarchivo\fR ...], \fB\-\-remove\fR \fIarchivo\fR [\fIarchivo\fR ...]" 4 .IX Item "-r archivo [archivo ...], --remove archivo [archivo ...]" Elimina la documentación identificada por el archivo de control \fIarchivo\fR. .IP "\fB\-c\fR \fIarchivo\fR [\fIarchivo\fR ...], \fB\-\-check\fR \fIarchivo\fR [\fIarchivo\fR ...]" 4 .IX Item "-c archivo [archivo ...], --check archivo [archivo ...]" Revisa el archivo de control \fIarchivo\fR y muestra el número de los posibles problemas encontrados. Úselo con \fI\-\-verbose\fR para obtener la ubicación real de los errores y avisos. Si también se introduce \fI\-\-rootdir\fR, su argumento se anexará a los nombres de los archivos presentes en los campos de «Files» e «Index» del \fIarchivo\fR. .IP "\fB\-R\fR, \fB\-\-remove\-all\fR" 4 .IX Item "-R, --remove-all" Elimina del registro todos los documentos registrados. .IP "\fB\-I\fR, \fB\-\-install\-all\fR" 4 .IX Item "-I, --install-all" Registrar nuevamente todos los documentos en «\fI/usr/share/doc\-base\fR» y «\fI/etc/doc\-base/documents\fR». .IP "\fB\-C\fR, \fB\-\-install\-changed\fR" 4 .IX Item "-C, --install-changed" Compara los contenidos de los directorios «\fI/usr/share/doc\-base\fR» y «\fI/etc/doc\-base/documents\fR» con la base de datos de los documentos registrados, elimina del registro todo archivo ausente y registra nuevamente solo los archivos nuevos o modificados. .IP "\fB\-s\fR \fIiddoc\fR [\fIiddoc\fR ...], \fB\-\-status\fR \fIiddoc\fR [\fIiddoc\fR ...]" 4 .IX Item "-s iddoc [iddoc ...], --status iddoc [iddoc ...]" Muestra el estado del identificador del documento \fIiddoc\fR. .IP "\fB\-L\fR \fIiddoc\fR [\fIiddoc\fR ...], \fB\-\-listfiles\fR \fIiddoc\fR [\fIiddoc\fR ...]" 4 .IX Item "-L iddoc [iddoc ...], --listfiles iddoc [iddoc ...]" Esta opción está obsoleta. No hace nada. .IP "\fB\-\-dump\-db\fR \fInombrebd\fR" 4 .IX Item "--dump-db nombrebd" Vuelca los contenidos de las bases de datos internas, por razones de depuración de fallos. \fInombrebd\fR puede ser \fBfiles.db\fR o \fBstatus.db\fR. .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" Muestra un corto mensaje de ayuda. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" Muestra la versión. .SH "PROBLEMAS DE COMPATIBILIDAD" .IX Header "PROBLEMAS DE COMPATIBILIDAD" Las siguientes características se añadieron en la versión 0.8.4., asegúrese de añadir las líneas apropiadas de «\fIConflicts\fR» o «\fIDepends\fR» si desea utilizarlas en los scripts de su paquete: .IP "\(bu" 4 soporte para introducir más de un argumento en las acciones \fB\-i\fR y \fB\-r\fR. .IP "\(bu" 4 leyendo los argumentos por la entrada estándar, .IP "\(bu" 4 acciones \fB\-I\fR,\fB\-\-install\-all\fR, \fB\-R\fR, \fB\-\-\-remove\-all\fR, \fB\-c\fR, \fB\-\-check\fR, .IP "\(bu" 4 opciones \fB\-d\fR, \fB\-\-debug\fR, \fB\-h\fR, \fB\-\-help\fR. .PP Las opciones \fB\-C\fR, \fB\-\-install\-changed\fR, \fB\-\-dump\-db\fR, \fB\-V\fR, \fB\-\-version\fR se añadieron en la versión 0.8.12. .SH "ARCHIVOS" .IX Header "ARCHIVOS" .IP "\fI/usr/share/doc\-base/\fR" 4 .IX Item "/usr/share/doc-base/" La ubicación de los archivos de control de doc-base que los paquetes han proporcionado. .IP "\fI/etc/doc\-base/documents/\fR" 4 .IX Item "/etc/doc-base/documents/" La ubicación de los archivos de control de doc-base facilitados por el administrador local. .IP "\fI/var/lib/doc\-base/info/documents/\fR" 4 .IX Item "/var/lib/doc-base/info/documents/" La ubicación de los archivos de control registrados. .IP "\fI/var/lib/doc\-base/info/status.db\fR" 4 .IX Item "/var/lib/doc-base/info/status.db" Los estados de los documentos registrados. .IP "\fI/var/lib/doc\-base/info/files.db\fR" 4 .IX Item "/var/lib/doc-base/info/files.db" Las marcas de código de tiempo y las id de los documentos .SH "FALLOS" .IX Header "FALLOS" Véase . .SH "VÉASE TAMBIÉN" .IX Header "VÉASE TAMBIÉN" \&\fBdhelp\fR\|(1), \fBdoccentral\fR\|(1), \fBdochelp\fR\|(1), \fBdwww\fR\|(7), Manual de doc-base para Debian «\fI/usr/share/doc/doc\-base/doc\-base.html/index.html\fR» .SH "AUTOR" .IX Header "AUTOR" Este programa fue originalmente escrito por Christian Schwarz schwarz@debian.org para el sistema Debian GNU/Linux, seguido de Adam Di Carlo . Actualmente, lo desarrolla y extiende Robert Luberda . .PP Este software se diseñó para el beneficio de toda la comunidad de usuarios y desarrolladores de Debian. Si está interesado en contribuir a este proyecto, únase a la lista de correo .