Provided by: menu_2.1.47ubuntu3_amd64 bug

NOM

       update-menus - génère les menus d'un système Debian

SYNOPSIS

       update-menus [-v] [-d] [-h|--help] [--version] [--menufilesdir <répertoire>] [--menumethod
       <méthode>] [--nodefaultdirs] [--stdout]

DESCRIPTION

       Avant l'utilisation de update-menus, quand l'administrateur système installait  un  paquet
       sur  un  système  Debian,  il  devait  modifier  de nombreux fichiers de configuration des
       gestionnaires de fenêtres afin de rendre accessible ce nouveau  programme  (les  menus  de
       fvwm,  par  exemple).  Ces  menus  pouvaient  facilement  ne  plus  lister  les programmes
       effectivement accessibles, certains éléments des menus  ne  fonctionnant  pas,  alors  que
       d'autres  programmes  n'étaient  pas référencés. update-menus et le paquet Debian menu ont
       pour but de résoudre ce problème.

       update-menus  génère  automatiquement  les  menus  des  programmes  installés   pour   les
       gestionnaires  de  fenêtres  et  pour  les autres programmes à menus. Il doit être lancé à
       chaque fois qu'un fichier de menu (voir menufile(5)) ou  qu'un  script  de  génération  de
       menus  est  modifié.  update-menus  sera  automatiquement  lancé  dès  qu'un paquet Debian
       contenant des fichiers de menus sera installé ou supprimé du système.

       update-menus utilise les fichiers de menu fournis par  le  paquet  (dans  /usr/share/menu)
       pour obtenir ses informations concernant les menus (mais l'administrateur du système ou un
       utilisateur peuvent modifier ce comportement, voir plus loin). Si le fichier de  menu  est
       exécutable,  update-menus  l'exécute et utilise sa sortie standard pour générer la base de
       données du menu.

OPTIONS

       -v     Mode bavard. Affiche tous les arguments des programmes /etc/menu-methods

       -d     Mode Debug. Génère un tas de messages inintelligibles.

       -h, --help
              Affiche un message d'aide et s'arrête.

       --menufilesdir <répertoire>
              Ajoute le répertoire <répertoire> à la  liste  des  répertoires  dans  laquelle  on
              recherche des fichiers de menu.

       --menumethod <méthode>
              Traite  uniquement  le  script  de  génération  de menus <méthode>, et non tous les
              scripts de génération de menus trouvés.

       --nodefaultdirs
              Désactive la recherche de fichiers de menu dans les répertoires de menu du système.

       --nodpkgcheck
              Ne pas supprimer les entrées de menu correspondant  à  des  paquets  non  installés
              d'après dpkg.

       --remove
              Supprime  les  menus générés en passant l'option --remove aux scripts de génération
              de menus.

       --stdout
              Génère une liste de menu acceptable comme entrée par install-menu ou par un  script
              de génération de menus.

       --version
              Affiche les informations de version, puis s'arrête.

CONFIGURATION

       Il y a plusieurs façons de régler le fonctionnement d'update-menus :

       par fichier de menu, dans /etc/menu/$paquet
              Dans ce répertoire, l'administrateur système ou l'utilisateur peut passer outre les
              réglages  par  défaut  (lorsqu'un  fichier  /etc/menu/$paquet  existe,  le  fichier
              /usr/share/menu/$paquet  n'est  plus consulté). Un utilisateur qui veut modifier le
              réglage par défaut du système placera ses fichiers dans le répertoire ~/.menu. Voir
              aussi menufile(5)
       par gestionnaire de fenêtres, dans /etc/menu-methods/$wm
              Dans  ces  fichiers  de  configuration,  on  peut ajuster le fichier system.${wm}rc
              généré pour chacun des gestionnaires de fenêtres. Par exemple, on peut définir  que
              le gestionnaire doit ignorer toute icône que le paquet pourrait fournir, ou définir
              le programme générique pour les applications  en  mode  texte  (normalement,  c'est
              xterm  qui  est  lancé pour accueillir une application en mode texte telle que vi).
              Les utilisateurs qui veulent passer  outre  les  réglages  par  défaut  du  système
              déposent  leurs  fichiers dans ~/.menu-methods. Pour plus d'informations, consultez
              /usr/share/doc/menu/html.
       globalement, dans /etc/menu-methods/translate_menus
              Ce fichier contient les transformations qui seront utilisées pour chaque entrée  de
              menu  et  dans chacun des gestionnaires de fenêtres. Vous pouvez définir des points
              tels que :  « Toutes  les  sections  qui  commencent  par  ``Games''  doivent  être
              référencées  par  ``Applications/Games'' »,  ou « l'entrée de menu ``gnuplot'' doit
              avoir le titre ``GnuTeken'' » . Jetez un oeil  au  fichier  par  défaut  /etc/menu-
              methods/translate_menus  pour  prendre exemple. Les utilisateurs qui veulent passer
              outre  les  transformations  par  défaut  du  système   le   font   dans   ~/.menu-
              methods/translate_menus.  Note :  ne  pas  utiliser pour une traduction complète du
              menu. Servez-vous des fichiers po comme indiqué dans le paquet source.
       pour les rapports d'erreurs, dans /etc/menu-methods/menu.config
              Ce fichier contient des informations générales sur le comportement d' update-menus.
              Pour  le  moment,  vous  ne  pouvez  régler que le niveau de bavardage de la sortie
              standard du programme, ainsi que  la  définition  de  cette  sortie.  La   quantité
              d'information est définie par « verbosity=VAL ». Choisissez VAL=quiet pour empêcher
              update-menu  d'afficher  autre  chose  que  les  erreurs  les   plus   importantes,
              VAL=normal,   VAL=verbose,   VAL=debug  pour  des  informations  de  plus  en  plus
              détaillées.

              Pour  définir  où  le  flux  sortant  doit   aller,   utilisez   « method=stdout »,
              « method=stderr »  ou  « method=syslog  facility  priorité ». « facility » est soit
              auth, authpriv, authcron, authdaemon, authkern, authlocal0, authlocal1, authlocal2,
              authlocal3,   authlocal4,  authlocal5,  authlocal6,  authlocal7,authlpr,  authmail,
              authnews, authsyslog, authuser, ou  authuucp.  « priorité »  est  l'un  des  termes
              suivants :  emerg, alert, crit, err, warning, notice, info, debug.

FICHIERS

       Fichiers de menu : (les répertoires cités en premier sont prioritaires sur ceux cités plus
       loin)
              ~/.menu/*
                     Fichiers de menu ajoutés  par  l'utilisateur  (ignorés  si  l'administrateur
                     lance update-menus)
              /etc/menu/*
                     Fichiers de menu ajoutés par l'administrateur système.
              /usr/lib/menu/*
                     Fichiers  de menu (dépendant de l'architecture) fournis par d'autres paquets
                     Debian.
              /usr/share/menu/*
                     Fichiers de  menu  (indépendant  de  l'architecture)  fournis  par  d'autres
                     paquets Debian.
              /usr/share/menu/default/*
                     Fichiers de menu fournis par le paquet menu.
       Fichiers de génération de menu (menu methods):
              /etc/menu-methods/
                     Fichiers  de  configuration   exécutables  ajoutés  par les gestionnaires de
                     fenêtres et autres programmes à menus, qui sont  exécutés  par  update-menus
                     afin  de  générer  les  menus  pour  ces  différents  programmes. Le fichier
                     translate_menus figure aussi dans ce répertoire, et sert aux réglages locaux
                     du modèle d'arborescence des menus.
              ~/.menu-methods/
                     Permet   aux  utilisateurs  d'outrepasser  le  comportement  par  défaut  de
                     /etc/menu-methods. Si ce répertoire existe, aucun des fichiers de /etc/menu-
                     methods n'est lu.

DISTRIBUTION

       La distribution est soumise à la Licence Publique Générale GNU.

BOGUES

       update-menus  peut  connaître  des  dysfonctionnements  quand il est invoqué par un simple
       utilisateur pour générer ses propres menus. C'est souvent parce  que  le  gestionnaire  de
       fenêtres  n'attend  pas  les  fichiers  system.${wm}rc  dans  le  répertoire  (normalement
       ~/.${wm}, à configurer dans /etc/menu-methods). Si vous repérez quelque chose de ce  genre
       et  que  vous  trouvez une solution, envoyez-moi un courrier à <menu@packages.debian.org>.
       Cela doit parfaitement fonctionner pour fvwm et fvwm2 : je teste d'abord le paquet en tant
       que simple utilisateur.

AUTEURS

       Joost   Witteveen   <joostje@debian.org>,   sur  une  idée  originale  de  Lars  Wirzenius
       <liw@iki.fi>. Actuellement maintenu par Bill Allombert <ballombe@debian.org>.

REMERCIEMENTS

       À Joey Hess, pour toutes ses bonnes idées et le test de la pré-version, et à Tom Lees pour
       son update-menus en C natif (dont je n'ai utilisé qu'une fonction, mais c'est la vie).

       (page de manuel par Joey Hess, <joeyh@debian.org>)

VOIR AUSSI

       menufile(5), /usr/share/doc/menu/html

TRADUCTION

       Sylvain Cherrier <sylvain.cherrier@free.fr>