Provided by:
doc-base_0.10.2_all 
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>.