Provided by: debhelper_8.9.0ubuntu1_all bug

NOM

       dh_installdocs - installe la documentation dans le repertoire de
       construction du paquet

SYNOPSIS

       dh_installdocs [optionsdedebhelper] [-A] [-X'el'ement] [fichier...]

DESCRIPTION

       dh_installdocs est le programme de la suite debhelper charge de
       l'installation de la documentation dans le repertoire
       usr/share/doc/paquet du repertoire de construction du paquet.

FICHIERS

       debian/paquet.docs
           Liste les fichiers de documentation a installer dans paquet.

       debian/copyright
           Le fichier de copyright est installe dans tous les paquets sauf si
           un fichier de copyright plus specifique est disponible.

       debian/paquet.copyright
       debian/paquet.README.Debian
       debian/paquet.TODO
           Chacun de ces fichiers est automatiquement installe s'il existe
           pour un paquet.

       debian/README.Debian
       debian/TODO
           Ces fichiers sont installes dans le premier paquet binaire liste
           dans debian/control.

           Nota: les fichiers README.debian sont egalement installes en tant
           que README.Debian et les fichiers  TODO seront installes en tant
           que TODO.Debian dans les paquets non natifs.

       debian/paquet.doc-base
           Installes en tant que fichiers de controle doc-base. Nota:
           L'identifiant de documentation (doc-id) sera fixe d'apres
           l'indication du champ Document: du fichier de controle doc-base en
           question.

       debian/paquet.doc-base.*
           Si le paquet necessite l'inscription de plus d'un document, il
           faudra utiliser plusieurs fichiers doc-base et les nommer de cette
           facon.

OPTIONS

       -A, --all
           Installe l'ensemble des fichiers indiques sur la ligne de commande
           dans TOUS les paquets construits.

       -X'el'ement, --exclude='el'ement
           Exclut les fichiers qui comportent 'el'ement, n'importe ou dans leur
           nom, de l'installation. Il est a noter que cela inclut les fichiers
           doc-base.

       --link-doc=paquet
           Transforme le repertoire de documentation de chacun des paquets
           traites en lien symbolique vers le repertoire de documentation de
           paquet. Cette option est sans effet pour la construction du paquet
           lui-meme ou si le repertoire de documentation a creer existe deja
           lorsque dh_installdocs est lance. Pour etre conforme a la charte,
           paquet doit etre un paquet binaire provenant du meme paquet source.

           debhelper essayera d'eviter l'installation de fichiers, dans les
           repertoires de la documentation liee, qui causerait des conflits
           avec le paquet lie. L'option B <-A> n'aura aucun effet sur les
           paquets avec des repertoires de documentation lies et les fichiers
           copyright, changelog, README.Debian et TODO ne seront pas
           installes.

           (Une autre methode, pour realiser la meme chose, qui reste toujours
           possible, est de faire du repertoire de documentation un lien
           symbolique <<en l'air>> avant l'appel a dh_installdocs.)

       fichier ...
           Installe les fichiers indiques en tant que documentation du premier
           paquet traite (ou de tous les paquets traites si -A est indique).

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 hierarchies entieres
       de repertoire (comme un cp -a). Si on lui demande d'installer un
       repertoire, il installera le contenu complet du repertoire.

       Nota: Ce programme n'est pas idempotent. Un dh_prep(1) doit etre
       realise entre chaque execution de ce programme. Sinon, il risque d'y
       avoir plusieurs occurrences des memes 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

       Valery Perrin <valery.perrin.debian@free.fr> le 17 septembre 2005.
       Derniere mise a jour le 3 avril 2011.

       L'equipe de traduction a fait le maximum pour realiser une adaptation
       francaise de qualite.

       Cette traduction est geree dynamiquement par po4a. Certains paragraphes
       peuvent, eventuellement, apparaitre en anglais. Ils correspondent a des
       modifications ou des ajouts recents du mainteneur, non encore
       incorpores dans la traduction francaise.

       La version originale anglaise de ce document est toujours consultable
       via la commande  man-Lennom_du_man.

       N'hesitez pas a signaler a l'auteur ou au traducteur, selon le cas,
       toute erreur dans cette page de manuel.