INSTALL-INFO(8)

NOM
install-info - création ou mise à jour d'une entrée dans le répertoire Info

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

DESCRIPTION

install-info crée, met à jour ou supprime des entrées dans le fichier dir 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, 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
    Donne le nom du fichier Info dont l'entrée de menu doit être créée, mise à jour ou supprimée. Si l'option --remove-exactly est précisée, nom-de-fichier sera le nom exact de l'entrée à supprimer (p. ex. « 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 dir (voyez l'option --infodir).

    Quand nom-de-fichier se termine par .gz on considère 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 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
    Cette option est pratiquement identique à --remove mais nom-de-fichier 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 ») : --remove opère sur la partie principale du nom-de-fichier plutôt 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'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é.

    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, 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 rep-info, ou que la copie installée du nouveau fichier Info était, est ou sera située dans rep-info. Par défaut, c'est /usr/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 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 --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.

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

VOIR AUSSI
emacs(1), info(1), gzip(1)

COPYRIGHT
Copyright 1994, Ian Jackson. install-info 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
Philippe Batailler, 2004. Veuillez signaler toute erreur à <debian-l10-french@lists.debian.org>. dpkg, version 1.10.23.