Re: [rfr] man://dpkg/install-info.8
Bonjour,
voici la mise à jour de dpkg-source.1.
Merci à Jean-Luc pour sa relecture.
a+
--
Philippe Batailler
.\" This file was generated with po4a. Translate the source file.
.\"
.\" Install-info and this manpage are Copyright 1994 by Ian Jackson.
.\"
.\" This is free software; see the GNU General Public Licence version 2
.\" or later for copying conditions. There is NO warranty.
.TH INSTALL\-INFO 8 "29 Novembre 1995" "Projet Debian" "Utilitaires de dpkg"
.SH NOM
install\-info \- création ou mise à jour d'une entrée dans le répertoire
Info
.SH SYNOPSIS
\fBinstall\-info\fR [\-\-version] [\-\-help] [\-\-debug] [\-\-maxwidth=nnn]
[\-\-section regexp title] [\-\-infodir=xxx] [\-\-align=nnn] [\-\-quiet]
[\-\-menuentry=xxx] [\-\-description=xxx] [\-\-remove | \-\-remove-exactly ]
[\-\-] nom-de-fichier
.SH DESCRIPTION
.PP
\fBinstall\-info\fR crée, met à jour ou supprime des entrées dans le fichier
\fBdir\fR du répertoire Info. Quand, pour la création ou la mise à jour d'une
entrée, on ne donne aucune description sur la ligne de commande ou dans le
fichier Info, \fBinstall\-info\fR essaye d'en deviner une à travers le contenu
du fichier.
Voyez la description de l'option \fB\-\-section\fR pour des précisions sur
l'emplacement choisi pour l'entrée et sur le format attendu du fichier
.B dir.
.SS OPTIONS
.TP
.BI "[\-\-] " nom-de-fichier
Donne le nom du fichier Info dont l'entrée de menu doit être créée, mise à
jour ou supprimée. Si l'option \fB\-\-remove\-exactly\fR est précisée,
\fInom-de-fichier sera le nom exact de l'entrée à supprimer (p. ex.\fR «\
emacs-20/emacs\ » ou «\ gcc\ »)\ ; dans les autres cas, la partie principale
de ce nom sert de référent pour l'entrée de menu qui est créée, à moins
qu'il y ait, dans le fichier donné, une entrée START-INFO-DIR. Ce fichier
doit donc exister (ou bien être sur le point d'être installé, ou bien doit
avoir existé en cas de suppression d'entrée) dans le même répertoire que le
fichier \fBdir (voyez l'option\fR \fB\-\-infodir).\fR
Quand \fInom-de-fichier\fR se termine par \fB.gz\fR on considère qu'il renvoie à
un fichier comprimé avec «\ GNU gzip\ »\ ; s'il n'existe pas, mais qu'il y a
un \fInom-de-fichier\fR\fB.gz\fR on utilisera ce dernier.
Quand on ajoute ou on met à jour des entrées, ce fichier doit exister dans
le chemin spécifié (si possible avec l'extension \fB.gz\fR supplémentaire).
.TP
.B \-\-remove
Demande que l'entrée pour le fichier \fInom-de-fichier\fR soit détruite\ ; par
défaut les entrées sont créées ou mises à jour.
Quand la suppression d'une entrée vide une section, l'en-tête (et la ligne
blanche détachée) de la section est supprimée aussi, à moins que ce ne soit
la dernière section du fichier ou bien que l'option \fB\-\-keep\-old\fR soit
indiquée. Voyez l'option \fB\-\-section\fR pour des précisions sur le format
attendu du fichier \fBdir.\fR
Quand il y a plusieurs entrées possibles dans le fichier \fBdir,\fR seules
celles qui appartiennent au premier groupe contigu correspondant sont
supprimées\ ; les autres sont silencieusement ignorées.
Ne pas trouver d'entrée possible n'est pas une erreur, bien que
\fBinstall\-info\fR avertisse du problème quand l'option \fB\-\-quiet\fR n'a pas
été demandée.
Quand \fB\-\-remove\fR est spécifié, les options de formatage \fB\-\-maxwidth\fR,
\fB\-\-align\fR et \fB\-\-calign\fR sont silencieusement ignorées.
.TP
.B \-\-remove-exactly
Cette option est pratiquement identique à \fB\-\-remove\fR mais
\fInom-de-fichier\fR est compris comme le nom exact de l'entrée à supprimer
plutôt que comme le nom d'un fichier existant. Cela peut être important
quand on essaye de supprimer des entrées pour des fichiers info dans des
sous-répertoires (p.\ ex. «\ emacs-20/emacs\ »)\ : \fB\-\-remove\fR opère sur
la partie principale du \fInom-de-fichier\fR plutôt que sur le nom exact. (p.\
ex. \fB\-\-remove\fR «\ emacs\-20/emacs\ » forcerait \fBinstall\-info\fR à
chercher «\ emacs\ », pas «\ emacs\-20/emacs\ »).
.TP
.BI "\-\-section " "exp\-reg titre"
Indique que l'entrée qui doit être créée sera placée dans la section du
fichier \fBdir\fR dont le titre correspond à \fIexp\-reg\fR. Si une telle section
n'existe pas, une nouvelle dernière section (voyez ci-après) est créée dans
le fichier, avec un titre égal à \fItitre.\fR Une section est un choix possible
dans le menu de \fBdir\fR\ ; les choix sont séparés par des lignes blanches\ ;
la première ligne est supposée représenter le titre.
Quand une nouvelle entrée doit être créée, \fBinstall\-info\fR essaye de
l'insérer dans la section selon l'ordre alphabétique ; si les entrées de la
section ne sont pas déjà triées, on ne peut prévoir l'emplacement qui sera
choisi. L'ordre existant des entrées n'est pas modifié.
Par défaut, les entrées nouvelles sont ajoutées à la fin du fichier. La
dernière section doit toujours exister (même si elle consiste en une simple
ligne de titre) de manière que les nouvelles sections puissent être créées
au bon endroit. Le titre de la dernière section devrait refléter le fait que
des fichiers Info sans emplacement bien défini sont ajoutés à la fin de
cette section.
Quand le fichier Info que l'on doit installer possède déjà une entrée,
celle-ci est remplacée in situ par la nouvelle entrée.
Quand on supprime une entrée, une section spécifiée est ignorée et un
avertissement est produit.
Quand on ajoute une entrée et qu'une section est spécifiée, mais que le
fichier ne contient aucun en-tête de section, \fBinstall-info\fR crée à la fois
la section demandée et une section «\ Miscellaneous\ » à la fin du fichier.
.TP
.BI \-\-infodir= rep\-info
Spécifie que le fichier \fBdir\fR est situé dans \fIrep\-info\fR, ou que la copie
installée du nouveau fichier Info était, est ou sera située dans
\fIrep\-info\fR. Par défaut, c'est \fB/usr/info\fR.
.TP
.BI \-\-align= nnn " [déconseillé]"
Précise que l'espace d'indentation de la première ligne de la description
sera d'au moins \fInnn\fR caractères\ ; des espaces supplémentaires peuvent
être ajoutées. Quand la longueur des éléments de l'entrée du menu \fBdir\fR le
demande, on peut le décaler davantage. Par défaut ce nombre est égal à 27.
.TP
.BI \-\-calign= nnn " [déconseillé]"
Précise que l'espace d'indentation de la deuxième ligne et des lignes
suivantes de la description sera d'au moins \fInnn\fR caractères. Par défaut ce
nombre est égal à 29.
.TP
.BI \-\-maxwidth= nnn " [déconseillé]"
Précise que la largeur maximale d'une ligne du fichier Info est de
\fInnn\fR. Cela sert pour «\ couper\ » automatiquement les lignes du texte
descriptif. Par défaut ce nombre est égal à 79.
.TP
.B \-\-quiet
Empêche l'affichage normal de la nouvelle entrée du menu juste avant qu'elle
soit insérée et l'affichage de messages annonçant le remplacement ou la
suppression d'entrées existantes ou la création ou la suppression de
section.
.TP
.B \-\-help
Option pour afficher une aide sur l'utilisation de \fBinstall\-info\fR
.TP
.B \-\-version
Option pour afficher la version et le copyright de \fBinstall\-info\fR
.TP
.BI \-\-description= xxx
Précise que la description employée après l'entrée du menu pour une nouvelle
entrée ou bien pour une entrée mise à jour sera \fIxxx\fR. Par défaut, on
emploie la valeur indiquée par le fichier Info lui-même\ ; on peut la
trouver en cherchant une section de la forme suivante\ :
.br
.B START\-INFO\-DIR\-ENTRY
.br
.B * Auto-PGP: (auto-pgp). PGP under GNU Emacs.
.br
.B END\-INFO\-DIR\-ENTRY
Quand l'entrée trouvée dans le fichier Info lui-même s'étend sur plusieurs
lignes, chacune donnant une entrée du menu, on reprend le texte trouvé «\
verbatim\ ». Dans ce cas, on ne tient pas compte de l'ordre alphabétique et
les entrées sont insérées au début de la section en question. Et les
options \fB\-\-menuentry\fR, \fB\-\-maxwidth\fR, \fB\-\-align\fR, \fB\-\-calign\fR sont
ignorées.
Quand il n'y a pas d'entrée pour \fBdir\fR dans le fichier, le programme essaye
de trouver un paragraphe au début du fichier qui commence par \fBthis file
documents\fR. Il met une capitale au premier caractère de la suite et
l'utilise comme description.
C'est une erreur si aucune de ces méthodes ne peut donner une description.
Quand l'option \fB\-\-remove\fR est donnée, l'argument pour l'option «
description » est ignoré et un avertissement est produit.
.TP
.BI \-\-menuentry= xxx
Précise que l'entrée de menu sera \fIxxx\fR. Par défaut, on emploie la valeur
indiquée par le fichier Info lui-même. Quand elle n'est pas présente, la
partie principale du nom du fichier Info est utilisée (tout fichier \fB.info
\fRest supprimé et la première lettre de l'entrée est capitalisée). Voyez
ci-dessus pour des précisions sur le format attendu pour l'entrée de menu
dans le fichier Info.
Quand on supprime des entrées, la valeur de l'option \fB\-\-menuentry\fR doit
correspondre au champ réel de l'entrée de menu qui doit être supprimée (peu
importe la casse). Quand l'option \fB\-\-menuentry\fR est omise, aucune
vérification sur l'entrée de menu n'est faite.
.TP
.B \-\-keep\-old
Empêche le remplacement d'entrées existantes et la suppression des sections
vides.
Quand le fichier qu'on doit installer possède déjà une entrée dans le
répertoire, l'ancienne entrée est laissée seule plutôt que remplacée. Par
défaut, toute entrée ancienne trouvée est remplacée par la nouvelle.
Quand l'option \fB\-\-remove\fR est indiquée \fB,\fR\-\-keep\-old empêche la
suppression de l'en-tête de section qui sans cela serait supprimé si la
suppression vidait la section.
.TP
.B \-\-test
Met en mode test, lequel empêche la mise à jour du fichier dir.
.TP
.B \-\-debug
Met en mode débogage, lequel montre les résultats de certaines étapes du
traitement.
.SH "VOIR AUSSI"
emacs(1), info(1), gzip(1)
.SH COPYRIGHT
Copyright 1994, Ian Jackson. \fBinstall\-info\fR est un logiciel libre\ ; voyez
la «\ GNU General Public Licence\ » version 2 ou supérieure pour le
copyright. Il \fIn'y a pas\fR de garantie.
.SH TRADUCTION
Philippe Batailler, 2004.
Veuillez signaler toute erreur à <debian-l10-french@lists.debian.org>.
dpkg, version 1.10.23.
Reply to: