NOM
dh_installdocs - installe la documentation dans le rpertoire de
construction du paquet
SYNOPSIS
dh_installdocs [optionsdedebhelper] [-A] [-Xlment] [fichier...]
dh_installdocs est le programme de la suite debhelper charg de
l'installation de la documentation dans le rpertoire
usr/share/doc/paquet du rpertoire de construction du paquet.
FICHIERS
debian/paquet.docs
List documentation files to be installed into package.
debian/copyright
debian/README.Debian
debian/TODO
debian/paquet.copyright
debian/paquet.README.Debian
debian/paquet.TODO
Chacun de ces fichiers est automatiquement install, s'ils existent.
Utilise le nom du paquet si paquet ncessite une version diffrente
du fichier.
Nota: debian/README.debian est install sous README.Debian et
debian/TODO sous TODO.Debian dans les paquets non natifs.
debian/paquet.doc-base
Installs en tant que fichiers de contrle doc-base. Nota:
L'identifiant de documentation (doc-id) sera fix d'aprs
l'indication du champ Document: du fichier de contrle doc-base en
question.
debian/paquet.doc-base.*
Si le paquet ncessite l'inscription de plus d'un document, il
faudra utiliser plusieurs fichiers doc-base et les nommer de cette
faon.
OPTIONS
-A, --all
Installe l'ensemble des fichiers indiqus sur la ligne de commande
dans TOUS les paquets construits.
-Xlment, --exclude=lment
Exclut les fichiers qui comportent lment, n'importe o dans leur
nom, de l'installation. Il est noter que cela inclut les fichiers
doc-base.
--link-doc=paquet
Transforme le rpertoire de documentation de chacun des paquets
traits en lien symbolique vers le rpertoire de documentation de
paquet. Cette option est sans effet pour la construction du paquet
lui-mme ou si le rpertoire de documentation crer existe dj lorsque
dh_installdocs est lanc. Pour tre conforme la charte, paquet doit
tre un paquet binaire provenant du mme paquet source.
debhelper essayera d'viter l'installation de fichiers, dans les
rpertoires de la documentation lie, qui causerait des conflits avec
le paquet li. L'option B <-A option> n'aura aucun effet sur les
paquets avec des rpertoires de documentation lis et les fichiers
copyright, changelog, README.Debian et TODO ne seront pas installs.
(Une autre mthode, pour raliser la mme chose, qui reste toujours
possible, est de faire du rpertoire de documentation un lien
symbolique en l'air avant l'appel dh_installdocs.)
fichier ...
Installe les fichiers indiqus en tant que documentation du premier
paquet trait (ou de tous les paquets traits si -A est indiqu).
EXEMPLES
Voici un exemple de fichier debian/paquet.docs:
README
TODO
debian/notes-for-maintainers.txt
docs/manual.txt
docs/manual.pdf
docs/manual-html/
REMARQUES
Nota: Heureusement, dh_installdocs sait copier des hirarchies entires
de rpertoire (comme un cp -a). Si on lui demande d'installer un
rpertoire, il installera le contenu complet du rpertoire.
Nota: Ce programme n'est pas idempotent. Un dh_prep(1) doit tre ralis
entre chaque excution de ce programme. Sinon, il risque d'y avoir
plusieurs occurrences des mmes lignes de code dans les scripts de
maintenance du paquet.
VOIR AUSSI
debhelper(7)
Ce programme fait partie de debhelper.
AUTEUR
Joey Hess <joeyh@debian.org>
TRADUCTION
Valry Perrin <valery.perrin.debian@free.fr> le 17 septembre 2005.
Dernire mise jour le 29 septembre 2009.
L'quipe de traduction a fait le maximum pour raliser une adaptation
franaise de qualit.
Cette traduction est gre dynamiquement par po4a. Certains paragraphes
peuvent, ventuellement, apparatre en anglais. Ils correspondent des
modifications ou des ajouts rcents du mainteneur, non encore incorpors
dans la traduction franaise.
La version originale anglaise de ce document est toujours consultable
via la commande man-Lennom_du_man.
N'hsitez pas signaler l'auteur ou au traducteur, selon le cas, toute
erreur dans cette page de manuel.