.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{ . if \nF \{ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "DH_INSTALLDOCS 1" .TH DH_INSTALLDOCS 1 "2016-07-24" "9.20150101+deb8u2" "Debhelper" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NOM" .IX Header "NOM" dh_installdocs \- Installer la documentation dans le répertoire de construction du paquet .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBdh_installdocs\fR [\fIoptions de debhelper\fR] [\fB\-A\fR] [\fB\-X\fR\fIélément\fR] [\fIfichier\fR ...] .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBdh_installdocs\fR est le programme de la suite debhelper chargé de l'installation de la documentation dans le répertoire \&\fIusr/share/doc/paquet\fR du répertoire de construction du paquet. .SH "FICHIERS" .IX Header "FICHIERS" .IP "debian/\fIpaquet\fR.docs" 4 .IX Item "debian/paquet.docs" Liste les fichiers de documentation à installer dans \fIpaquet\fR. .IP "\fIdebian/copyright\fR" 4 .IX Item "debian/copyright" Le fichier de copyright est installé dans tous les paquets sauf si un fichier de copyright plus spécifique est disponible. .IP "debian/\fIpaquet\fR.copyright" 4 .IX Item "debian/paquet.copyright" .PD 0 .IP "debian/\fIpaquet\fR.README.Debian" 4 .IX Item "debian/paquet.README.Debian" .IP "debian/\fIpaquet\fR.TODO" 4 .IX Item "debian/paquet.TODO" .PD Chacun de ces fichiers est automatiquement installé s'il existe pour un \&\fIpaquet\fR. .IP "\fIdebian/README.Debian\fR" 4 .IX Item "debian/README.Debian" .PD 0 .IP "\fIdebian/TODO\fR" 4 .IX Item "debian/TODO" .PD Ces fichiers sont installés dans le premier paquet binaire listé dans \&\fIdebian/control\fR. .Sp Nota : les fichiers \fI\s-1README\s0.debian\fR sont également installés en tant que \&\fI\s-1README\s0.Debian\fR et les fichiers \fI\s-1TODO\s0\fR seront installés en tant que \&\fI\s-1TODO\s0.Debian\fR dans les paquets non natifs. .IP "debian/\fIpaquet\fR.doc\-base" 4 .IX Item "debian/paquet.doc-base" Installés en tant que fichiers de contrôle doc-base. Remarque : l'identifiant de documentation (doc-id) sera défini d'après l'indication du champ \fBDocument:\fR du fichier de contrôle doc-base en question. Au cas où plusieurs fichiers doc-base d'un seul paquet source partagent le même identifiant de documentation, ils seront installés dans usr/share/doc\-base/\fIpaquet\fR au lieu de usr/share/doc\-base/\fIdoc-id\fR. .IP "debian/\fIpaquet\fR.doc\-base.*" 4 .IX Item "debian/paquet.doc-base.*" Si le paquet doit enregistrer plus d'un document, plusieurs fichiers doc-base sont nécessaires, et peuvent être nommés comme cela. Au cas où plusieurs fichiers doc-base de ce genre dans un seul paquet source partagent le même identifiant de documentation, ils seront installés dans usr/share/doc\-base/\fIpaquet\-*\fR au lieu de usr/share/doc\-base/\fIdoc-id\fR. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-A\fR, \fB\-\-all\fR" 4 .IX Item "-A, --all" Installe l'ensemble des fichiers indiqués sur la ligne de commande dans \s-1TOUS\s0 les paquets construits. .IP "\fB\-X\fR\fIélément\fR, \fB\-\-exclude=\fR\fIélément\fR" 4 .IX Item "-Xélément, --exclude=élément" Exclut les fichiers qui comportent \fIélément\fR, n'importe où dans leur nom, de l'installation. Il est à noter que cela inclut les fichiers doc-base. .IP "\fB\-\-link\-doc=\fR\fIpaquet\fR" 4 .IX Item "--link-doc=paquet" Transforme le répertoire de documentation de chacun des paquets traités en lien symbolique vers le répertoire de documentation de \fIpaquet\fR. Cette option est sans effet pour la construction du \fIpaquet\fR lui\-même ou si le répertoire de documentation à créer existe déjà lorsque \fBdh_installdocs\fR est lancé. Pour être conforme à la charte, \fIpaquet\fR doit être un paquet binaire provenant du même paquet source. .Sp debhelper essayera d'éviter l'installation de fichiers, dans les répertoires de la documentation liée, qui causerait des conflits avec le paquet lié. L'option \fB\-A\fR n'aura aucun effet sur les paquets avec des répertoires de documentation liés et les fichiers \fIcopyright\fR, \fIchangelog\fR, \&\fI\s-1README\s0.Debian\fR et \fI\s-1TODO\s0\fR ne seront pas installés. .Sp (Une autre méthode, pour réaliser la même chose, qui reste toujours possible, est de faire du répertoire de documentation un lien symbolique « en l'air » avant l'appel à \fBdh_installdocs\fR.) .IP "\fIfichier\fR ..." 4 .IX Item "fichier ..." Installe les fichiers indiqués en tant que documentation du premier paquet traité (ou de tous les paquets traités si \fB\-A\fR est indiqué). .SH "EXEMPLES" .IX Header "EXEMPLES" Voici un exemple de fichier \fIdebian/paquet.docs\fR : .PP .Vb 6 \& README \& TODO \& debian/notes\-for\-maintainers.txt \& docs/manual.txt \& docs/manual.pdf \& docs/manual\-html/ .Ve .SH "REMARQUES" .IX Header "REMARQUES" Nota : Heureusement, \fBdh_installdocs\fR sait copier des hiérarchies entières de répertoire (comme un \fBcp \-a\fR). Si on lui demande d'installer un répertoire, il installera le contenu complet du répertoire. .PP Nota : Ce programme n'est pas idempotent. Un \fIdh_prep\fR\|(1) doit être réalisé entre chaque exécution de ce programme. Sinon, il risque d'y avoir plusieurs occurrences des mêmes lignes de code dans les scripts de maintenance du paquet. .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fIdebhelper\fR\|(7) .PP Ce programme fait partie de debhelper. .SH "AUTEUR" .IX Header "AUTEUR" Joey Hess .SH "TRADUCTION" .IX Header "TRADUCTION" Valéry Perrin le 17 septembre 2005. Dernière mise à jour le 3 avril 2011. .PP L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. .PP Cette traduction est gérée dynamiquement par po4a. Certains paragraphes peuvent, éventuellement, apparaître en anglais. Ils correspondent à des modifications ou des ajouts récents du mainteneur, non encore incorporés dans la traduction française. .PP La version originale anglaise de ce document est toujours consultable via la commande man \-L en nom_du_man. .PP N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.