Provided by:
menu_2.1.45ubuntu1_i386 
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>