Provided by:
doc-base_0.10.3_all 
NOM
install-docs - gestion de la documentation en ligne de Debian
R'ESUM'E
install-docs [options] -i, --install | -r, --remove | -c, --check fichier [ fichier... ]
install-docs [options] -I, --install-all | -C, --install-changed | -R, --remove-all
install-docs [options] -s, --status id_doc [id_doc ... ]
install-docs [options] --dump-db nom-base-donnees
install-docs -h, --help | -V,--version
DESCRIPTION
install-docs est un outil qui permet aux responsables de paquets Debian
d'enregistrer de la documentation dans divers systemes de
documentation. Il prend actuellement en charge les navigateurs dhelp,
dwww, doc-central, et scrollkeeper.
Cette page de manuel fournit un court resume de l'utilisation
d'install-docs. Une documentation complete se trouve dans la
documentation, elle comprend une description de la syntaxe et de la
grammaire du fichier de controle.
OPTIONS
-v, --verbose
Fonctionnement bavard
-d, --debug
Afficher certaines informations de debogage.
--no-update-menus
Interdire le lancement de dwww-build-menu(8), dhelp_parse(8), et
scrollkeeper-update(8).
--rootdir r'epertoire
Definir le repertoire racine a r'epertoire au lieu de <</>>. Utile
et valable uniquement avec l'action --check.
ACTIONS
Vous trouverez ci-dessous la liste des actions possibles que peut
prendre en charge install-docs. Il ne peut y avoir qu'une seule option
d'action passee a install-docs. De plus, l'action, avec ses parametres,
doit etre la derniere option passee.
Chaque parametre fichier doit etre le chemin complet vers le fichier de
controle de doc-base (par ex. <</usr/share/doc-base/some_file>> ou
<</etc/doc-base/documents/un_fichier>>), et chaque id_doc doit etre
l'identifiant du document (les identifiants de document sont definis
dans le champ <<Document>> du fichier de controle, ils correspondent
habituellement au nom du paquet).
Si fichier ou id_doc est egal a <<->> (le signe moins), la liste des
parametres sera lue depuis l'entree standard (chaque nom de fichier ou
chaque identifiant de document se trouvant sur une ligne separee).
-i fichier [fichier ...], --install fichier [fichier ...]
Installer la documentation decrite par le fichier de controle
fichier.
-r fichier [fichier ...], --remove fichier [fichier ...]
Supprimer la documentation identifiee par le fichier de controle
fichier.
-c fichier [fichier ...], --check fichier [fichier ...]
Verifier le fichier de controle fichier et afficher le nombre de
problemes potentiels trouves. Utilise avec --verbose, il permet de
trouver la position reelle des erreurs et des avertissements. Si
--rootdir est aussi indique, son parametre sera ajoute en tete des
noms de fichiers indiques dans les champs <<Files>> et <<Index>> de
fichier.
-R, --remove-all
Desenregistrer tous les documents enregistres.
-I, --install-all
Reenregistrer tous les documents de /usr/share/doc-base et
/etc/doc-base/documents.
-C, --install-changed
Comparer le contenu des repertoires /usr/share/doc-base et
/etc/doc-base/documents avec la base de donnees des documents
enregistres et desenregistrer tous les fichiers manquants et
n'enregistrer ou ne reenregistrer que les fichiers nouveaux ou
ayant ete modifies.
-s id_doc [id_doc ...], --status id_doc [id_doc ...]
Afficher l'etat de l'identifiant de document id_doc.
-L id_doc [id_doc ...], --listfiles id_doc [id_doc ...]
Option obsolete. N'effectue rien.
--dump-db nom_base_de_donn'ees
Vider le contenu des bases de donnees internes pour des besoins de
debogage. nom_base_de_donn'ees peut etre soit files.db ou status.db.
-h, --help
Afficher un court message d'aide.
-V, --version
Afficher les informations de version.
PROBL`EMES DE COMPATIBILIT'E
Les fonctions suivantes ont ete ajoutees dans la version 0.8.4,
veuillez vous assurer d'avoir ajoute les lignes <<Conflicts>> ou
<<Depends>> si vous voulez les utiliser dans les scripts de vos
paquets:
o prise en compte du passage de plus d'un seul parametre aux actions
-i et -r,
o lecture des parametres depuis l'entree standard.
o actions -I, --install-all, -R, ---remove-all, -c, --check,
o option -d, --debug, -h, --help.
Les options -C, --install-changed, --dump-db, -V, --version ont ete
ajoutees dans la version 0.8.12.
FICHIERS
/usr/share/doc-base/
Emplacement des fichiers de controle de documentation fournis par
differents paquets.
/etc/doc-base/documents/
Emplacement des fichiers de controle de documentation fournis par
l'administrateur local.
/var/lib/doc-base/info/documents/
Emplacement des fichiers de controle enregistres.
/var/lib/doc-base/info/status.db
Etat des documents enregistres.
/var/lib/doc-base/info/files.db
Horodatage et identifiants des documents des fichiers de
documentation enregistres.
/var/lib/doc-base/omf/
Emplacement des fichiers OMF crees par scrollkeeper. Note:
/usr/share/omf/doc-base doit etre un lien symbolique pointant vers
le repertoire.
BOGUES
Voir http://bugs.debian.org/doc-base <http://bugs.debian.org/doc-base>.
VOIR AUSSI
dhelp(1), doccentral(1), dwww(7), scrollkeeper(7), Debian doc-base
Manual /usr/share/doc/doc-base/doc-base.html/index.html
AUTEUR
Ce programme a ete initialement ecrit par Christian Schwarz
<schwarz@debian.org>, pour le systeme Debian GNU/Linux, il a ensuite
ete maintenu par Adam Di Carlo <aph@debian.org>. Il est actuellement
maintenu et developpe par Robert Luberda <robert@debian.org>.
Ce logiciel a ete developpe au profit de la communaute toute entiere
des utilisateurs et developpeurs de Debian. Si vous desirez etre tenu
au courant des evolutions de ce logiciel, veuillez nous rejoindre sur
la liste de diffusion <debian-doc@lists.debian.org>.