Provided by: dpkg_1.14.20ubuntu6_i386 bug

NOM

       install-info - Création ou mise à jour d’une entrée dans le fichier dir
       du système Info.

SYNOPSIS

       install-info [--version] [--help] [--debug] [--maxwidth=nnn] [--section
       regexp title] [--infodir=xxx] [--align=nnn] [--quiet] [--menuentry=xxx]
       [--description=xxx] [--remove|--remove-exactly] [--] fichier

DESCRIPTION

       install-info crée, met à jour ou supprime des entrées dans  le  fichier
       dir  d’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,  install-info  essaye  d’en  deviner  une à travers le contenu du
       fichier.

       Voyez la description de l’option  --section  pour  des  précisions  sur
       l’emplacement  choisi pour l’entrée et sur le format attendu du fichier
       dir.

OPTIONS

       [--] nom-de-fichier
              Gives the filename of the Info file whose menu entry  is  to  be
              created,  updated  or removed. If --remove-exactly is specified,
              then filename should be the exact entry name to be removed (e.g.
              "emacs-20/emacs"  or  "gcc"),  otherwise  the  basename  of this
              filename is used as the referent of  the  menu  entry  which  is
              created,  unless  there’s  an  overriding  START-INFO-DIR  entry
              inside the given file. This file must  therefore  exist  (or  be
              about  to be installed, or have previously existed when removing
              an entry) in the  same  directory  as  the  dir  file  (see  the
              --infodir option).

              If  filename  ends  in  .gz,  it  is  taken  to  refer to a file
              compressed with gzip; if it doesn’t exist, but  a  corresponding
              filename.gz does, the latter is used instead.

              Quand  on  ajoute  ou on met à jour des entrées, ce fichier doit
              exister dans le chemin spécifié (si  possible  avec  l’extension
              .gz supplémentaire).

       --remove
              Demande   que  l’entrée  pour  le  fichier  nom-de-fichier  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  --keep-old  soit  indiquée.  Voyez l’option
              --section pour des précisions sur le format attendu  du  fichier
              dir.

              Quand  il  y  a plusieurs entrées possibles dans le fichier dir,
              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
              install-info  avertisse  du  problème quand l’option --quiet n’a
              pas été demandée.

              Quand  --remove  est  spécifié,   les   options   de   formatage
              --maxwidth, --align et --calign sont silencieusement ignorées.

       --remove-exactly
              This  option  is  essentially  the  same as --remove except that
              filename is taken as the exact entry to be removed, rather  than
              as  the  name  of  an  existing file. This can be important when
              trying  to  remove  entries  that  refer  to   info   files   in
              subdirectories  (e.g.  "emacs-20/emacs")  because  --remove will
              operate on the basename of the given filename  rather  than  the
              exact  name  given. (i.e.  --remove "emacs-20/emacs" would cause
              install-info to look for "emacs", not "emacs-20/emacs").

       --section exp-reg titre
              Indique que l’entrée qui doit être créée  sera  placée  dans  la
              section  du  fichier  dir dont le titre correspond à exp-reg. 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 à
              titre. Une section est un choix possible dans le menu  de  dir ;
              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,  install-info  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é.

              Si  l’option  --section  n’est   pas   spécifiée,   install-info
              recherchera   un   titre  dans  le  fichier  Info  lui-même,  en
              recherchant une entrée de la forme :

              INFO-DIR-SECTION titre

              Par défaut, si aucun titre de section n’est trouvé, 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,
              install-info crée à la fois la section demandée et  une  section
              « Miscellaneous » à la fin du fichier.

       --infodir=rep-info
              Spécifie  que  le  fichier dir est situé dans infodir, ou que la
              copie installée du nouveau  fichier  Info  était,  est  ou  sera
              située dans infodir. Par défaut, c’est /usr/share/info.

       --align=nnn [déconseillé]
              Précise  que  l’espace  d’indentation de la première ligne de la
              description  sera  d’au  moins  nnn  caractères ;  des   espaces
              supplémentaires  peuvent  être  ajoutées.  Quand la longueur des
              éléments de l’entrée du menu dir le demande, on peut le  décaler
              davantage. Par défaut ce nombre est égal à 27.

       --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   nnn
              caractères. Par défaut ce nombre est égal à 29.

       --maxwidth=nnn [déconseillé]
              Précise  que la largeur maximale d’une ligne du fichier Info est
              de nnn. Cela sert pour « couper » automatiquement les lignes  du
              texte descriptif. Par défaut ce nombre est égal à 79.

       --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.

       --help Option pour afficher une aide sur l’utilisation de install-info

       --version
              Option pour afficher la version et le copyright de install-info

       --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
              xxx. 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 :
              START-INFO-DIR-ENTRY
              * Auto-PGP: (auto-pgp). PGP under GNU Emacs.
              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  --menuentry,
              --maxwidth, --align, --calign sont ignorées.

              Quand  il  n’y  a  pas  d’entrée  pour  dir  dans le fichier, le
              programme essaye de trouver un paragraphe au  début  du  fichier
              qui  commence  par  this  file documents. 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  --remove est donnée, l’argument pour l’option «
              description » est ignoré et un avertissement est produit.

       --menuentry=xxx
              Précise que l’entrée de menu sera xxx. 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 .info est 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 --menuentry
              doit  correspondre  au  champ  réel de l’entrée de menu qui doit
              être  supprimée  (peu  importe   la   casse).   Quand   l’option
              --menuentry  est omise, aucune vérification sur l’entrée de menu
              n’est faite.

       --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 fichier dir d’Info, 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 --remove  est  indiquée,  --keep-old  empêche  la
              suppression  de  l’en-tête  de  section  qui  sans  cela  serait
              supprimé si la suppression vidait la section.

       --test Met en mode test, lequel empêche la mise à jour du  fichier  dir
              d’Info.

       --debug
              Met  en  mode débogage, lequel montre les résultats de certaines
              étapes du traitement.

VOIR AUSSI

       emacs(1), info(1), gzip(1).

AUTEUR

       Copyright 1994 Ian Jackson

       Ce programme est un logiciel libre ;  voyez  la  « GNU  General  Public
       Licence »  version  2  ou supérieure pour le copyright. Il n’y a PAS de
       garantie.

TRADUCTION

       Ariel VARDI <ariel.vardi@freesbee.fr>, 2002.  Philippe Batailler, 2006.
       Nicolas   François,   2006.    Veuillez   signaler   toute   erreur   à
       <debian-l10n-french@lists.debian.org>.