INSTALL-INFO(O) Utilitaires de dpkg INSTALL-INFO(O) NOM install-info - cration ou mise jour d'une entre dans le rpertoire Info SYNOPSIS install-info [--version] [--help] [--debug] [--maxwidth=nnn] [--section regexp title] [--infodir=xxx] [--align=nnn] [--quiet] [--menuentry=xxx] [--descrip- tion=xxx] [--remove | --remove-exactly ] [--] nom-de- fichier DESCRIPTION install-info cre, met jour ou supprime des entres dans le fichier dir du rpertoire Info. Quand, pour la cration ou la mise jour d'une entre, 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 prci- sions sur l'emplacement choisi pour l'entre et sur le for- mat attendu du fichier dir. OPTIONS [--] nom-de-fichier Donne le nom du fichier Info dont l'entre de menu doit tre cre, mise jour ou supprime. Si l'option --remove-exactly est prcise, nom-de-fichier sera le nom exact de l'entre supprimer (p.ex. emacs-20/emacs ou gcc ) ; dans les autres cas, la partie principale de ce nom sert de rfrent pour l'entre de menu qui est cre, moins qu'il y ait, dans le fichier donn, une entre 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'entre) dans le mme rpertoire que le fichier dir (voyez l'option --infodir). Quand nom-de-fichier se termine par .gz on considre qu'il renvoie un fichier comprim avec GNU gzip ; s'il n'existe pas, mais qu'il y a un nom-de- fichier.gz on utilisera ce dernier. Quand on ajoute ou on met jour des entres, ce fichier doit exister dans le chemin spcifi (si pos- sible avec l'extension .gz supplmentaire). --remove Demande que l'entre pour le fichier nom-de-fichier soit dtruite ; par dfaut les entres sont cres ou mises jour. Quand la suppression d'une entre vide une section, l'en-tte (et la ligne blanche dtache) de la section est supprime aussi, moins que ce ne soit la dernire section du fichier ou bien que l'option --keep-old soit indique. Voyez l'option --section pour des prcisions sur le format attendu du fichier dir. Quand il y a plusieurs entres possibles dans le fichier dir, seules celles qui appartiennent au premier groupe contigu correspondant sont supprimes ; les autres sont silencieusement ignores. Ne pas trouver d'entre possible n'est pas une erreur, bien que install-info avertisse du problme quand l'option --quiet n'a pas t demande. Quand --remove est spcifi, les options de formatage --maxwidth, --align et --calign sont silencieuse- ment ignores. --remove-exactly Cette option est pratiquement identique --remove mais nom-de-fichier est compris comme le nom exact de l'entre supprimer plutt que comme le nom d'un fichier existant. Cela peut tre important quand on essaye de supprimer des entres pour des fichiers info dans des sous-rpertoires (p.ex. emacs-20/emacs ) : --remove opre sur la partie principale du nom-de-fichier plutt que sur le nom exact. (p.ex. --remove emacs-20/emacs forcerait install-info chercher emacs , pas emacs-20/emacs ). --section exp-reg titre Indique que l'entre qui doit tre cre sera place dans la section du fichier dir dont le titre corre- spond exp-reg. Si une telle section n'existe pas, une nouvelle dernire section (voyez ci-aprs) est cre dans le fichier, avec un titre gal titre. Une section est un choix possible dans le menu de dir ; les choix sont spars par des lignes blanches ; la premire ligne est suppose reprsenter le titre. Quand une nouvelle entre doit tre cre, install-info essaye de l'insrer dans la section selon l'ordre alphabtique ; si les entres de la section ne sont pas dj tries, on ne peut prvoir l'emplacement qui sera choisi. L'ordre existant des entres n'est pas modifi. Par dfaut, les entres nouvelles sont ajoutes la fin du fichier. La dernire section doit toujours exister (mme si elle consiste en une simple ligne de titre) de manire que les nouvelles sections puissent tre cres au bon endroit. Le titre de la dernire section devrait reflter le fait que des fichiers Info sans emplacement bien dfini sont ajouts la fin de cette section. Quand le fichier Info que l'on doit installer possde dj une entre, celle-ci est remplace in situ par la nouvelle entre. Quand on supprime une entre, une section spcifie est ignore et un avertissement est produit. Quand on ajoute une entre et qu'une section est spcifie, mais que le fichier ne contient aucun en- tte de section, install-info cre la fois la sec- tion demande et une section Miscellaneous la fin du fichier. --infodir=rep-info Spcifie que le fichier dir est situ dans rep-info, ou que la copie installe du nouveau fichier Info tait, est ou sera situe dans rep-info. Par dfaut, c'est /usr/info. --align=nnn [dconseill] Prcise que l'espace d'indentation de la premire ligne de la description sera d'au moins nnn carac- tres ; des espaces supplmentaires peuvent tre ajouts. Quand la longueur des lments de l'entre du menu dir le demande, on peut le dcaler davantage. Par dfaut ce nombre est gal 27. --calign=nnn [dconseill] Prcise que l'espace d'indentation de la deuxime ligne et des lignes suivantes de la description sera d'au moins nnn caractres. Par dfaut ce nombre est gal 29. --maxwidth=nnn [dconseill] Prcise que la largeur maximale d'une ligne du fichier Info est de nnn. Cela sert pour couper automatiquement les lignes du texte descriptif. Par dfaut ce nombre est gal 79. --quiet Empche l'affichage normal de la nouvelle entre du menu juste avant qu'elle soit insre et l'affichage de messages annonant le remplacement ou la suppres- sion d'entres existantes ou la cration ou la sup- pression 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 Prcise que la description employe aprs l'entre du menu pour une nouvelle entre ou bien pour une entre mise jour sera xxx. Par dfaut, on emploie la valeur indique par le fichier Info lui-mme ; 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'entre trouve dans le fichier Info lui-mme s'tend sur plusieurs lignes, chacune donnant une entre du menu, on reprend le texte trouv verbatim . Dans ce cas, on ne tient pas compte de l'ordre alphabtique et les entres sont insres au dbut de la section en question. Et les options --menuentry, --maxwidth, --align, --calign sont ignores. Quand il n'y a pas d'entre pour dir dans le fichier, le programme essaye de trouver un para- graphe au dbut du fichier qui commence par this file documents. Il met une capitale au premier caractre de la suite et l'utilise comme descrip- tion. C'est une erreur si aucune de ces mthodes ne peut donner une description. Quand l'option --remove est donne, l'argument pour l'option description est ignor et un avertisse- ment est produit. --menuentry=xxx Prcise que l'entre de menu sera xxx. Par dfaut, on emploie la valeur indique par le fichier Info lui- mme. Quand elle n'est pas prsente, la partie prin- cipale du nom du fichier Info est utilise (tout fichier .info est supprim et la premire lettre de l'entre est capitalise). Voyez ci-dessus pour des prcisions sur le format attendu pour l'entre de menu dans le fichier Info. Quand on supprime des entres, la valeur de l'option --menuentry doit correspondre au champ rel de l'entre de menu qui doit tre supprime (peu importe la casse). Quand l'option --menuentry est omise, aucune vrification sur l'entre de menu n'est faite. --keep-old Empche le remplacement d'entres existantes et la suppression des sections vides. Quand le fichier qu'on doit installer possde dj une entre dans le rpertoire, l'ancienne entre est laisse seule plutt que d'tre remplace. Par dfaut, toute entre ancienne trouve est remplace par la nouvelle. Quand l'option --remove est indique ,--keep-old empche la suppression de l'en-tte de section qui sans cela serait supprim si la suppression vidait la section. --test met en mode test, lequel empche la mise jour du fichier dir. --debug met en mode dbogage, lequel montre les rsultats de certaines tapes du traitement. VOIR AUSSI emacs(s), info(o), gzip(p) TRADUCTION Philippe Batailler. Dec 2000 COPYRIGHT Copyright 1994, Ian Jackson. install-info est un logiciel libre ; voyez la GNU General Public Licence version 2 ou suprieure pour le copyright. Il n'y a pas de garantie. Projet Debian 29th November 1995 INSTALL-INFO(O)