.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" 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 >0, 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 "2021-03-06" "13.3.4" "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. .PP Dans les niveaux de compatibilité 10 et inférieurs, \fBdh_install\fR\|(1) est mieux adapté à la gestion de la documentation si le système de construction amont installe la documentation voulue correctement. Dans ce cas, \&\fBdh_installdocs\fR est toujours utile pour installer la documentation de l'empaquetage (par exemple le fichier \fIdebian/copyright\fR). .PP Depuis la version 11 de debhelper, \fBdh_install\fR cherchera dans l'arborescence \fIdebian/tmp\fR pour trouver les fichiers s'il ne les trouve pas dans le répertoire courant (ou dans celui indiqué par l'utilisation de \&\fB\-\-sourcedir\fR). .PP Dans les niveaux de compatibilité 11 et au delà, \fBdh_installdocs\fR offre la plupart des fonctionnalités de \fBdh_install\fR\|(1). De plus, \fBdh_installdocs\fR prend aussi en charge le profil de construction \fBnodoc\fR pour exclure la documentation (quel que soit le niveau de compatibilité). .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. .Sp Les variables de substitution sont prises en charge dans les niveaux de compatibilité 13 et ultérieurs comme documenté dans \fBdebhelper\fR\|(7). .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. .Sp Soyez conscient que cette déduplication est uniquement réalisée en mémoire actuellement, ce qui fait que pour l'instant il ne faut pas que \&\fBdh_installdocs\fR soit appelé plus d'une fois pendant la construction du paquet. L'appel de \fBdh_installdocs \-p\fR\fIpaquet\fR en combinaison avec l'utilisation de \fIdebian/\fR\fIpaquet\fR\fI.doc\-base.*\fR peut mener à des paquets non installables. Voir pour plus de détails. .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 \&\fBtous\fR 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\-\-sourcedir=\fR\fIrépertoire\fR" 4 .IX Item "--sourcedir=répertoire" Cherche dans le répertoire indiqué les fichiers à installer. Cette option nécessite le niveau de compatibilité 11 ou supérieur (et sera silencieusement ignorée en version 10 et avant). .Sp Nota : cette option ne fait pas la même chose que \fB\-\-sourcedirectory\fR utilisée par \fBdh_auto_\fR\fI*\fR. Il est rare d'avoir besoin d'utiliser cette option puisque \fBdh_installman\fR cherche automatiquement les fichiers dans \&\fIdebian/tmp\fR depuis le niveau de compatibilité 11 de debhelper. .IP "\fB\-\-doc\-main\-package=\fR\fIpaquet-principal\fR" 4 .IX Item "--doc-main-package=paquet-principal" Définit le paquet principal pour un paquet de documentation. Cela est utilisé pour installer la documentation du paquet de documentation dans \fI/usr/share/doc/\fIpaquet-principal\fI\fR comme recommandé par la Charte Debian 3.9.7 au paragraphe 12.3. .Sp Dans les niveaux de compatibilité 11 ou suivants, cette option n'est utile que si l'auto\-détection du paquet principal de debhelper est erronée. Cette option peut aussi être utilisée pour masquer un avertissement de debhelper lorsque l'auto\-détection échoue mais que le comportement par défaut est correct. .Sp Cette option ne peut pas être utilisée lorsque \fBdh_installdocs\fR doit agir sur plusieurs paquets. Si vous avez besoin de cette option, vous devrez généralement l'associer à \fB\-p\fR pour vous assurer de n'agir que sur un paquet. .Sp Veuillez garder à l'esprit que certains documents (les fichiers copyright, \&\s-1README\s0.Debian, etc.) ne seront pas affectés par cette option. .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.) .Sp Veuillez noter que cette option ne s'applique qu'au répertoire de documentation du paquet lui\-même. Lorsque le paquet fournit de la documentation pour un autre (voir par exemple \fB\-\-doc\-main\-package\fR), il n'utilisera pas de lien symbolique pour la documentation de l'autre paquet. .Sp \&\fB\s-1AVERTISSEMENT 1\s0\fR : si une version précédente du paquet était construite sans cette option et qu'elle est maintenant construite avec (ou vice-versa), une migration est nécessaire, « répertoire vers lien symbolique » (« dir to symlink ») ou « lien symbolique vers répertoire » (« symlink to dir »). Puisque debhelper n'a aucune connaissance des versions précédentes, vous devez activer cette migration vous\-même. .Sp Cela peut être effectué en fournissant un fichier « debian/\fIpaquet\fR.maintscript » et en utilisant \fBdh_installdeb\fR\|(1) pour fournir les extraits des scripts de maintenance correspondants. .Sp \&\fB\s-1AVERTISSEMENT 2\s0\fR : \fB\-\-link\-doc\fR ne doit être utilisé que lorsque les paquets ont la même « architecture ». Un lien depuis un paquet indépendant de l'architecture vers un paquet dépendant de l'architecture (ou vice-versa) ne fonctionnera pas. Depuis la version 10, debhelper rejette activement les combinaisons non prises en charge. .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. .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fBdebhelper\fR\|(7) .PP Ce programme fait partie de debhelper. .SH "AUTEUR" .IX Header "AUTEUR" Joey Hess .SH "TRADUCTION" .IX Header "TRADUCTION" Cette traduction est maintenue à l'aide de l'outil po4a par l'équipe francophone de traduction de Debian. .PP Veuillez signaler toute erreur de traduction en écrivant à ou par un rapport de bogue sur le paquet debhelper. .PP Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man \-L C
 ».