Provided by: doc-base_0.10.3_all bug

NOMBRE

       install-docs - gestion de documentacion de Debian en linea

SINOPSIS

        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

DESCRIPCI'ON

       install-docs es una herramienta que permite a los responsables de
       paquetes de Debian registrar documentacion en varios sistemas de
       documentacion. Es compatible con los navegadores dhelp, dwww, doc-
       central, y scrollkeeper.

       Esta pagina de manual ofrece una corta sinopsis del uso de install-
       docs. Encontrara informacion completa en la documentacion, incluyendo
       una descripcion de la sintaxis y la gramatica del archivo de control.

OPCIONES

       -v, --verbose
           Ejecutarse con verbosidad.

       -d, --debug
           Muestra informacion de depuracion de fallos.

       --no-update-menus
           Impide que se ejecuten dwww-build-menu(8), dhelp_parse(8) y
           scrollkeeper-update(8).

       --rootdir dir
           Configura el directorio raiz como dir en lugar de <</>>. Util y
           valido solo junto con la accion --check.

ACCIONES

       A continuacion hay una lista de las acciones posibles que install-docs
       ofrece. Solo se puede introducir una opcion de accion a
       <<install-docs>>, y mas aun, la accion y sus argumentos deben ser la
       ultima opcion introducida.

       Cada argumento archivo deberia 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 iddoc deberia  ser la
       identificacion 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).

       Si archivo o iddoc equivalen a <<->>, la lista de argumentos se leera
       por la entrada estandar (cada nombre de archivo o id de documento debe
       estar en una linea separada).

       -i archivo [archivo ...], --install archivo [archivo ...]
           Instala la documentacion que se describe en el archivo de control
           archivo.

       -r archivo [archivo ...], --remove archivo [archivo ...]
           Elimina la documentacion identificada por el archivo de control
           archivo.

       -c archivo [archivo ...], --check archivo [archivo ...]
           Revisa el archivo de control archivo y muestra el numero de los
           posibles problemas encontrados. Uselo con --verbose para obtener la
           ubicacion real de los errores y avisos. Si tambien se introduce
           --rootdir, su argumento se anexara a los nombres de los archivos
           presentes en los campos de <<Files>> e <<Index>> del archivo.

       -R, --remove-all
           Elimina del registro todos los documentos registrados.

       -I, --install-all
           Registrar nuevamente todos los documentos en
           <</usr/share/doc-base>> y <</etc/doc-base/documents>>.

       -C, --install-changed
           Compara los contenidos de los directorios <</usr/share/doc-base>> y
           <</etc/doc-base/documents>> con la base de datos de los documentos
           registrados, elimina del registro todo archivo ausente y registra
           nuevamente solo los archivos nuevos o modificados.

       -s iddoc [iddoc ...], --status iddoc [iddoc ...]
           Muestra el estado del identificador del documento iddoc.

       -L iddoc [iddoc ...], --listfiles iddoc [iddoc ...]
           Esta opcion esta obsoleta. No hace nada.

       --dump-db nombrebd
           Vuelca los contenidos de las bases de datos internas, por razones
           de depuracion de fallos. nombrebd puede ser files.db o status.db.

       -h, --help
           Muestra un corto mensaje de ayuda.

       -V, --version
           Muestra la version.

PROBLEMAS DE COMPATIBILIDAD

       Las siguientes caracteristicas se anadieron en la version 0.8.4.,
       asegurese de anadir las lineas apropiadas de <<Conflicts>> o
       <<Depends>> si desea utilizarlas en los scripts de su paquete:

       o   soporte para introducir mas de un argumento en las acciones -i y
           -r.

       o   leyendo los argumentos por la entrada estandar,

       o   acciones -I,--install-all, -R, ---remove-all, -c, --check,

       o   opciones -d, --debug, -h, --help.

       Las opciones -C, --install-changed, --dump-db, -V, --version se
       anadieron en la version 0.8.12.

ARCHIVOS

       /usr/share/doc-base/
           La ubicacion de los archivos de control de doc-base que los
           paquetes han proporcionado.

       /etc/doc-base/documents/
           La ubicacion de los archivos de control de doc-base facilitados por
           el administrador local.

       /var/lib/doc-base/info/documents/
           La ubicacion de los archivos de control registrados.

       /var/lib/doc-base/info/status.db
           Los estados de los documentos registrados.

       /var/lib/doc-base/info/files.db
           Las marcas de codigo de tiempo y las id de los documentos

       /var/lib/doc-base/omf/
           La ubicacion de los archivos OMF generados por scrollkeeper. Nota:
           <</usr/share/omf/doc-base>> deberia ser un enlace simbolico
           apuntando a un directorio.

FALLOS

       Vease http://bugs.debian.org/doc-base <http://bugs.debian.org/doc-
       base>.

V'EASE TAMBI'EN

       dhelp(1), doccentral(1), dwww(7), scrollkeeper(7), Manual de doc-base
       para Debian <</usr/share/doc/doc-base/doc-base.html/index.html>>

AUTOR

       Este programa fue originalmente escrito por Christian Schwarz
       schwarz@debian.org para el sistema Debian GNU/Linux, seguido de Adam Di
       Carlo <aph@debian.org>. Actualmente, lo desarrolla y extiende Robert
       Luberda <robert@debian.org>.

       Este software se diseno para el beneficio de toda la comunidad de
       usuarios y desarrolladores de Debian. Si esta interesado en contribuir
       a este proyecto, unase a la lista de correo
       <debian-doc@lists.debian.org>.