265 lines
8.5 KiB
HTML
265 lines
8.5 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of INSTALL-DOCS</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>INSTALL-DOCS</H1>
|
|
Section: Debian (8)<BR>Updated: 06 August 2019<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NOMBRE</H2>
|
|
|
|
|
|
|
|
install-docs - gestión de documentación de Debian en línea
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SINOPSIS</H2>
|
|
|
|
|
|
|
|
|
|
|
|
<PRE>
|
|
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
|
|
|
|
</PRE>
|
|
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPCIÓN</H2>
|
|
|
|
|
|
|
|
<B>install-docs</B> 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 <B>dhelp</B>, <B>dwww</B>,
|
|
<B>doc-central</B>, y <B>scrollkeeper</B>.
|
|
<P>
|
|
|
|
Esta página de manual ofrece una corta sinopsis del uso de
|
|
<B>install-docs</B>. Encontrará información completa en la documentación,
|
|
incluyendo una descripción de la sintaxis y la gramática del archivo de
|
|
control.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPCIONES</H2>
|
|
|
|
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-v</B>, <B>--verbose</B><DD>
|
|
|
|
|
|
Ejecutarse con verbosidad.
|
|
<DT id="2"><B>-d</B>, <B>--debug</B><DD>
|
|
|
|
|
|
Muestra información de depuración de fallos.
|
|
<DT id="3"><B>--no-update-menus</B><DD>
|
|
|
|
|
|
Impide que se ejecuten <B><A HREF="/cgi-bin/man/man2html?8+dwww-build-menu">dwww-build-menu</A></B>(8), <B><A HREF="/cgi-bin/man/man2html?8+dhelp_parse">dhelp_parse</A></B>(8) y
|
|
<B><A HREF="/cgi-bin/man/man2html?8+scrollkeeper-update">scrollkeeper-update</A></B>(8).
|
|
<DT id="4"><B>--rootdir</B> <I>dir</I><DD>
|
|
|
|
|
|
Configura el directorio raíz como <I>dir</I> en lugar de «<I>/</I>». Útil y válido
|
|
solo junto con la acción <B>--check</B>.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>ACCIONES</H2>
|
|
|
|
|
|
|
|
A continuación hay una lista de las acciones posibles que <B>install-docs</B>
|
|
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.
|
|
<P>
|
|
|
|
Cada argumento <I>archivo</I> 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 <I>iddoc</I> 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).
|
|
<P>
|
|
|
|
Si <I>archivo</I> o <I>iddoc</I> equivalen a «<B>-</B>», 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).
|
|
<DL COMPACT>
|
|
<DT id="5"><B>-i</B> <I>archivo</I> [<I>archivo</I> ...], <B>--install</B> <I>archivo</I> [<I>archivo</I> ...]<DD>
|
|
|
|
|
|
Instala la documentación que se describe en el archivo de control
|
|
<I>archivo</I>.
|
|
<DT id="6"><B>-r</B> <I>archivo</I> [<I>archivo</I> ...], <B>--remove</B> <I>archivo</I> [<I>archivo</I> ...]<DD>
|
|
|
|
|
|
Elimina la documentación identificada por el archivo de control <I>archivo</I>.
|
|
<DT id="7"><B>-c</B> <I>archivo</I> [<I>archivo</I> ...], <B>--check</B> <I>archivo</I> [<I>archivo</I> ...]<DD>
|
|
|
|
|
|
Revisa el archivo de control <I>archivo</I> y muestra el número de los posibles
|
|
problemas encontrados. Úselo con <I>--verbose</I> para obtener la ubicación real
|
|
de los errores y avisos. Si también se introduce <I>--rootdir</I>, su argumento
|
|
se anexará a los nombres de los archivos presentes en los campos de «Files»
|
|
e «Index» del <I>archivo</I>.
|
|
<DT id="8"><B>-R</B>, <B>--remove-all</B><DD>
|
|
|
|
|
|
Elimina del registro todos los documentos registrados.
|
|
<DT id="9"><B>-I</B>, <B>--install-all</B><DD>
|
|
|
|
|
|
Registrar nuevamente todos los documentos en «<I>/usr/share/doc-base</I>» y
|
|
«<I>/etc/doc-base/documents</I>».
|
|
<DT id="10"><B>-C</B>, <B>--install-changed</B><DD>
|
|
|
|
|
|
Compara los contenidos de los directorios «<I>/usr/share/doc-base</I>» y
|
|
«<I>/etc/doc-base/documents</I>» con la base de datos de los documentos
|
|
registrados, elimina del registro todo archivo ausente y registra nuevamente
|
|
solo los archivos nuevos o modificados.
|
|
<DT id="11"><B>-s</B> <I>iddoc</I> [<I>iddoc</I> ...], <B>--status</B> <I>iddoc</I> [<I>iddoc</I> ...]<DD>
|
|
|
|
|
|
Muestra el estado del identificador del documento <I>iddoc</I>.
|
|
<DT id="12"><B>-L</B> <I>iddoc</I> [<I>iddoc</I> ...], <B>--listfiles</B> <I>iddoc</I> [<I>iddoc</I> ...]<DD>
|
|
|
|
|
|
Esta opción está obsoleta. No hace nada.
|
|
<DT id="13"><B>--dump-db</B> <I>nombrebd</I><DD>
|
|
|
|
|
|
Vuelca los contenidos de las bases de datos internas, por razones de
|
|
depuración de fallos. <I>nombrebd</I> puede ser <B>files.db</B> o <B>status.db</B>.
|
|
<DT id="14"><B>-h</B>, <B>--help</B><DD>
|
|
|
|
|
|
Muestra un corto mensaje de ayuda.
|
|
<DT id="15"><B>-V</B>, <B>--version</B><DD>
|
|
|
|
|
|
Muestra la versión.
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>PROBLEMAS DE COMPATIBILIDAD</H2>
|
|
|
|
|
|
|
|
Las siguientes características se añadieron en la versión 0.8.4., asegúrese
|
|
de añadir las líneas apropiadas de «<I>Conflicts</I>» o «<I>Depends</I>» si desea
|
|
utilizarlas en los scripts de su paquete:
|
|
<DL COMPACT>
|
|
<DT id="16">•<DD>
|
|
soporte para introducir más de un argumento en las acciones <B>-i</B> y <B>-r</B>.
|
|
<DT id="17">•<DD>
|
|
leyendo los argumentos por la entrada estándar,
|
|
<DT id="18">•<DD>
|
|
acciones <B>-I</B>,<B>--install-all</B>, <B>-R</B>, <B>---remove-all</B>, <B>-c</B>, <B>--check</B>,
|
|
<DT id="19">•<DD>
|
|
opciones <B>-d</B>, <B>--debug</B>, <B>-h</B>, <B>--help</B>.
|
|
</DL>
|
|
<P>
|
|
|
|
Las opciones <B>-C</B>, <B>--install-changed</B>, <B>--dump-db</B>, <B>-V</B>, <B>--version</B>
|
|
se añadieron en la versión 0.8.12.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>ARCHIVOS</H2>
|
|
|
|
|
|
|
|
<DL COMPACT>
|
|
<DT id="20"><I>/usr/share/doc-base/</I><DD>
|
|
|
|
|
|
La ubicación de los archivos de control de doc-base que los paquetes han
|
|
proporcionado.
|
|
<DT id="21"><I>/etc/doc-base/documents/</I><DD>
|
|
|
|
|
|
La ubicación de los archivos de control de doc-base facilitados por el
|
|
administrador local.
|
|
<DT id="22"><I>/var/lib/doc-base/info/documents/</I><DD>
|
|
|
|
|
|
La ubicación de los archivos de control registrados.
|
|
<DT id="23"><I>/var/lib/doc-base/info/status.db</I><DD>
|
|
|
|
|
|
Los estados de los documentos registrados.
|
|
<DT id="24"><I>/var/lib/doc-base/info/files.db</I><DD>
|
|
|
|
|
|
Las marcas de código de tiempo y las id de los documentos
|
|
<DT id="25"><I>/var/lib/doc-base/omf/</I><DD>
|
|
|
|
|
|
La ubicación de los archivos <FONT SIZE="-1">OMF</FONT> generados por scrollkeeper. Nota:
|
|
«<I>/usr/share/omf/doc-base</I>» debería ser un enlace simbólico apuntando a un
|
|
directorio.
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>FALLOS</H2>
|
|
|
|
|
|
|
|
Véase <<A HREF="http://bugs.debian.org/doc-base">http://bugs.debian.org/doc-base</A>>.
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>VÉASE TAMBIÉN</H2>
|
|
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+dhelp">dhelp</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+doccentral">doccentral</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?7+dwww">dwww</A></B>(7), <B><A HREF="/cgi-bin/man/man2html?7+scrollkeeper">scrollkeeper</A></B>(7), Manual de doc-base para
|
|
Debian «<I>/usr/share/doc/doc-base/doc-base.html/index.html</I>»
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTOR</H2>
|
|
|
|
|
|
|
|
Este programa fue originalmente escrito por Christian Schwarz
|
|
<A HREF="mailto:schwarz@debian.org">schwarz@debian.org</A> para el sistema Debian GNU/Linux, seguido de Adam Di
|
|
Carlo <<A HREF="mailto:aph@debian.org">aph@debian.org</A>>. Actualmente, lo desarrolla y extiende Robert Luberda
|
|
<<A HREF="mailto:robert@debian.org">robert@debian.org</A>>.
|
|
<P>
|
|
|
|
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 <<A HREF="mailto:debian-doc@lists.debian.org">debian-doc@lists.debian.org</A>>.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="26"><A HREF="#lbAB">NOMBRE</A><DD>
|
|
<DT id="27"><A HREF="#lbAC">SINOPSIS</A><DD>
|
|
<DT id="28"><A HREF="#lbAD">DESCRIPCIÓN</A><DD>
|
|
<DT id="29"><A HREF="#lbAE">OPCIONES</A><DD>
|
|
<DT id="30"><A HREF="#lbAF">ACCIONES</A><DD>
|
|
<DT id="31"><A HREF="#lbAG">PROBLEMAS DE COMPATIBILIDAD</A><DD>
|
|
<DT id="32"><A HREF="#lbAH">ARCHIVOS</A><DD>
|
|
<DT id="33"><A HREF="#lbAI">FALLOS</A><DD>
|
|
<DT id="34"><A HREF="#lbAJ">VÉASE TAMBIÉN</A><DD>
|
|
<DT id="35"><A HREF="#lbAK">AUTOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:00 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|