Provided by: menu_2.1.45ubuntu1_i386 bug

NOM

       update-menus - genere les menus d'un systeme Debian

SYNOPSIS

       update-menus   [-v]   [-d]   [-h|--help]   [--version]  [--menufilesdir
       <r'epertoire>] [--menumethod <m'ethode>] [--nodefaultdirs] [--stdout]

DESCRIPTION

       Avant l'utilisation de  update-menus,  quand  l'administrateur  systeme
       installait  un  paquet  sur  un  systeme  Debian, il devait modifier de
       nombreux fichiers de configuration des gestionnaires de  fenetres  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 elements des menus ne fonctionnant
       pas, alors que d'autres programmes n'etaient pas  references.   update-
       menus et le paquet Debian menu ont pour but de resoudre ce probleme.

       update-menus  genere automatiquement les menus des programmes installes
       pour les gestionnaires de fenetres et  pour  les  autres  programmes  a
       menus.  Il  doit  etre  lance a chaque fois qu'un fichier de menu (voir
       menufile(5)) ou qu'un  script  de  generation  de  menus  est  modifie.
       update-menus   sera  automatiquement  lance  des  qu'un  paquet  Debian
       contenant des fichiers de menus sera installe ou supprime du systeme.

       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 systeme ou un utilisateur peuvent modifier ce
       comportement,  voir  plus loin).  Si le fichier de menu est executable,
       update-menus l'execute et utilise sa sortie standard  pour  generer  la
       base de donnees du menu.

OPTIONS

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

       -d     Mode Debug. Genere un tas de messages inintelligibles.

       -h, --help
              Affiche un message d'aide et s'arrete.

       --menufilesdir <repertoire>
              Ajoute le repertoire <repertoire> a  la  liste  des  repertoires
              dans laquelle on recherche des fichiers de menu.

       --menumethod <methode>
              Traite uniquement le script de generation de menus <methode>, et
              non tous les scripts de generation de menus trouves.

       --nodefaultdirs
              Desactive la recherche de fichiers de menu dans les  repertoires
              de menu du systeme.

       --nodpkgcheck
              Ne pas supprimer les entrees de menu correspondant a des paquets
              non installes d'apres dpkg.

       --remove
              Supprime les menus generes  en  passant  l'option  --remove  aux
              scripts de generation de menus.

       --stdout
              Genere  une  liste  de menu acceptable comme entree par install-
              menu ou par un script de generation de menus.

       --version
              Affiche les informations de version, puis s'arrete.

CONFIGURATION

       Il y a plusieurs facons de regler le fonctionnement d'update-menus :

       par fichier de menu, dans /etc/menu/$paquet
              Dans ce repertoire, l'administrateur  systeme  ou  l'utilisateur
              peut  passer  outre  les  reglages par defaut (lorsqu'un fichier
              /etc/menu/$paquet  existe,  le  fichier  /usr/share/menu/$paquet
              n'est  plus  consulte).  Un  utilisateur  qui  veut  modifier le
              reglage par defaut du  systeme  placera  ses  fichiers  dans  le
              repertoire ~/.menu. Voir aussi menufile(5)
       par gestionnaire de fen^etres, dans /etc/menu-methods/$wm
              Dans  ces  fichiers de configuration, on peut ajuster le fichier
              system.${wm}rc genere pour chacun des gestionnaires de fenetres.
              Par  exemple,  on  peut definir que le gestionnaire doit ignorer
              toute icone que  le  paquet  pourrait  fournir,  ou  definir  le
              programme   generique   pour  les  applications  en  mode  texte
              (normalement, c'est xterm qui  est  lance  pour  accueillir  une
              application  en  mode  texte telle que vi). Les utilisateurs qui
              veulent passer outre les reglages par defaut du systeme deposent
              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  utilisees
              pour  chaque  entree de menu et dans chacun des gestionnaires de
              fenetres. Vous pouvez definir des points  tels  que :  << Toutes
              les   sections   qui   commencent  par  ``Games''  doivent  etre
              referencees par  ``Applications/Games'' >>,  ou  << l'entree  de
              menu ``gnuplot'' doit avoir le titre ``GnuTeken'' >> .  Jetez un
              oeil au  fichier  par  defaut  /etc/menu-methods/translate_menus
              pour  prendre exemple. Les utilisateurs qui veulent passer outre
              les transformations par defaut du systeme le font dans  ~/.menu-
              methods/translate_menus.    Note :  ne  pas  utiliser  pour  une
              traduction complete du menu. Servez-vous des fichiers  po  comme
              indique dans le paquet source.
       pour les rapports d'erreurs, dans /etc/menu-methods/menu.config
              Ce   fichier   contient   des   informations  generales  sur  le
              comportement d' update-menus. Pour le  moment,  vous  ne  pouvez
              regler  que  le  niveau  de  bavardage  de la sortie standard du
              programme,  ainsi  que  la  definition  de  cette  sortie.    La
              quantite  d'information  est  definie  par  << verbosity=VAL >>.
              Choisissez VAL=quiet pour empecher 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
              detaillees.

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

FICHIERS

       Fichiers de menu : (les repertoires cites en premier sont  prioritaires
       sur ceux cites plus loin)
              ~/.menu/*
                     Fichiers  de  menu  ajoutes par l'utilisateur (ignores si
                     l'administrateur lance update-menus)
              /etc/menu/*
                     Fichiers de menu ajoutes par l'administrateur systeme.
              /usr/lib/menu/*
                     Fichiers de menu (dependant  de  l'architecture)  fournis
                     par d'autres paquets Debian.
              /usr/share/menu/*
                     Fichiers  de menu (independant de l'architecture) fournis
                     par d'autres paquets Debian.
              /usr/share/menu/default/*
                     Fichiers de menu fournis par le paquet menu.
       Fichiers de generation de menu (menu methods):
              /etc/menu-methods/
                     Fichiers de configuration  executables  ajoutes  par  les
                     gestionnaires  de  fenetres et autres programmes a menus,
                     qui sont executes par update-menus afin  de  generer  les
                     menus   pour   ces   differents  programmes.  Le  fichier
                     translate_menus figure aussi dans ce repertoire, et  sert
                     aux reglages locaux du modele d'arborescence des menus.
              ~/.menu-methods/
                     Permet aux utilisateurs d'outrepasser le comportement par
                     defaut de /etc/menu-methods.  Si  ce  repertoire  existe,
                     aucun des fichiers de /etc/menu-methods n'est lu.

DISTRIBUTION

       La distribution est soumise a la Licence Publique Generale GNU.

BOGUES

       update-menus peut connaitre des dysfonctionnements quand il est invoque
       par un simple utilisateur pour generer ses propres menus. C'est souvent
       parce  que  le  gestionnaire  de  fenetres  n'attend  pas  les fichiers
       system.${wm}rc dans le repertoire (normalement ~/.${wm},  a  configurer
       dans  /etc/menu-methods).  Si vous reperez quelque chose de ce genre et
       que  vous   trouvez   une   solution,   envoyez-moi   un   courrier   a
       <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 idee originale de Lars
       Wirzenius  <liw@iki.fi>.  Actuellement  maintenu  par  Bill   Allombert
       <ballombe@debian.org>.

REMERCIEMENTS

       A Joey Hess, pour toutes ses bonnes idees et le test de la pre-version,
       et a Tom Lees pour son update-menus en C natif (dont  je  n'ai  utilise
       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>