|--help||Show the help and exit.|
|--version||Show the version and exit.|
|--install-prefix DIR||The prefix of GNOME or KDE installation. Default is /usr for GNOME (other common prefixes: /usr/local, /opt/gnome). For KDE the default is $KDEDIR and you probably do not need to use this option.|
|--desktop NAME||Use gnome-sys for the GNOME system menu (this is the default), gnome-user for the GNOME user menu, gnome-redhat for the AnotherLevel menu of Red Hat, gnome-mandriva for Mandriva menudrake menus, kde-sys for the KDE system menu and kde-user for the KDE user menu. It may be useful to use KDE or GNOME as a flag with the --dir option.|
|--type NAME||If NAME is fvwm, a native FVWM menu will be built (this is the default). If NAME is gtk, a FvwmGtk menu will be built.|
|--fvwmgtk-alias NAME||The name for then FvwmGtk module to use instead of default FvwmGtk.|
|--title NAME||Define the menu title of the top menu. Default is "Gnome System Menu" for gnome-sys, "Gnome User Menu" for gnome-user, "Gnome Red Hat Menu" for gnome-redhat, "Gnome Mandriva Menu" for gnome-mandriva. For KDE the default is given by KDE itself (or are similar to GNOME title).|
|--name NAME||Define the menu name of the top menu. Default is the --desktop name if you use one above.|
this option tries to merge the user menu
with the system menu (gnome-sys or kde-sys, based on the --desktop option)
and takes into account changes to the system menu that it is now
possible to do in the "user directory" (at least with KDE version 2
By default, fvwm-menu-desktop builds mini-icon free menus. To enable mini-icons use one of the two following options.
|--enable-mini-icons||This option enables mini-icons in the menu. The desktop hints are used if it is possible (fvwm menu cant use .png icons). Use the --mini-icons-path and the --png-icons-path to specify the good paths. By using the --icon-* options below you can control mini-icons in menus.|
|--enable-tran-mini-icons||This option applies only to fvwm menus and is useful to build GNOME or KDE2 menus with mini-icons (and if you have XPM version of the GNOME or KDE2 PNG icons). If this option is used any icon hint foo.png is translated to path/foo.xpm where path is determined by the --tran-mini-icons-path option (xpm icons are used as with the previous option).|
|--mini-icons-path DIR||Define the directory of the .xpm mini-icons (relative to your ImagePath). Default is "mini/".|
|--png-icons-path DIR||Define the directory of .png icons. Default is "" (i.e., in your ImagePath). Useful only with FvwmGtk menus.|
|--tran-mini-icons-path DIR||Define the directory of the mini-icons for the --enable-tran-mini-icons option. Default is mini/. It is preferable to give the complete path so that fvwm-menu-desktop can check if the translated mini-icons exists (and the "re" law will apply in a good way).|
Where PATH is a list of directories with ":" as a separator. Then,
fvwm-menu-desktop checks that the mini icons actually exist in one of
these directories (this check is not done for the translated mini icons).
To control mini-icons in menus you can use the 4 following options which work similarly.
In these options law may be no, dh, re or ow. no means "do not use mini-icon" (this does not affect side pic). dh means "use only the mini-icons GNOME/KDE hints". re means "use mini-icons GNOME/KDE hints but if it is empty use the specified mini-icon". ow means "override the mini-icons GNOME/KDE hints by the specified mini-icon".
The path to the specified icons is given by the options --mini-icons-path, --png-icons-path or --tran-mini-icons-path (i.e., you just have to specify the icon, the path is computed). For the sidepic you need to give the complete relative path from your ImagePath.
Note that for the FVWM menu (without the --enable-tran-mini-icons option) a .png icon hint is considered as an empty hint, so for the system menu use no=dh and re=ow (you may use .xpm icons in a user menu). If the --tran-mini-icons-path option is set with a complete path, then if the .xpm icon which corresponds to a .png icon hint does not exist, the icon hint is considered as empty.
place, sidepic and color apply only with fvwm menus. place is either left or up. left means that the icon will be placed on the left of the label. up means that the icon will be placed above the label. sidepic needs to be nothing or an icon (for a picture in the bottom left of the menu). color applies only if a sidepic icon is given and it is the color for the region of the menu containing the sidepic picture.
When you use an option below, if an icon, a law ...etc is not specified (i.e., empty) the default is used (e.g, if you want, for an FVWM menu, the icon folder.xpm on the left of the top title and the sidepic fvwm2.xpm on the left of this menu use the following: --icon-toptitle :ow::fvwm2.xpm).
|--icon-toptitle micon:law:place:sidepic:color||Mini-icon for the top title and sidepic for the top menu. Default for fvwm menus: folder.xpm:no:left::. Default for fvwm menus with --enable-tran-mini-icons: gnome-logo-icon-transparent.xpm:no:left:. Default for gtk menus: gnome-logo-icon-transparent.png:no.|
|--icon-title micon:law:place:sidepic:color||Use the option below for submenus. Default for fvwm menus: folder.xpm:dh:left::. Default for fvwm menus with --enable-tran-mini-icons: gnome-folder.xpm:dh:left::. Default for gtk menus: gnome-folder.png:dh|
|--icon-folder micon:law:place:sidepic:color||Mini-icons for pop up item. Default for fvwm menus: folder.xpm:dh:left. Default for fvwm menus with --enable-tran-mini-icons: gnome-folder.xpm:dh:left. Default for gtk menus: gnome-folder.png:dh.|
Mini-icon for applications item.
Default for fvwm menus: mini-x.xpm:dh.
Default for fvwm menus
with --enable-tran-mini-icons: gnome-default.xpm:dh.
Default for gtk menus: gnome-default.png:dh
This is a shortcut, which can be used if you plan to use icons from the
wm-icons package. Currently this is equivalent to:
|--enable-style mini-icon:icon:law:addstyle||Build icons and mini-icons style commands for the applications in the built menu.|
|--style-tran||Only useful with FvwmGtk GNOME or KDE2 menus. Make translation as the enable-tran-mini-icon option but only for style (not for mini-icons menus).|
|--icon-style mini-icon:icon:law:addstyle||This option is similar to the options --icon-* above. Default law is "dh" (there is no "no" law). Default mini-icon is mini-x.xpm and default icon is x.xpm. You can add a style to all applications with addstyle. If you use the enable-tran-mini-icon options the translated (mini-)icons will be used (if translation is needed) and the default icons are gnome-default.xpm. If you use the --enable-tran-style options above the default icons are gnome-default.xpm. The paths to mini-icons are the same as those for the menus. The path to the icons is computed from the mini-icons path: they are one directory up to the corresponding mini-icons path (so the "defaults" are "" and this is consistent with KDE1 and XPM icons builded by fvwm-themes-images).|
|--icons-path DIR||Not useful in a normal situation. Define the directory of the icons. Default is one directory up from the path given by the --mini-icons-path option. To set the path to "" you need to use "inpath".|
|--tran-icons-path DIR||Similar to the above option.|
Where PATH is a list of directories with ":" as a separator. Then,
fvwm-menu-desktop checks that the icons actually exist in one of
these directories (this chack is not done for the translated icons, use a
full path in --tran-icons-path to do so).
|--submenu-name-prefix NAME||May be useful in some unfortunate cases. By default the name of a sub menu is of the form prefix-adirname-level where prefix is the desktop flag, adirname is the name of the directory of the description of the sub menus (not a complete path) and where level is an integer equal to the number of "cd"s you need to do to go from the root to the directory of the description of the sub menus. You may change the prefix using the present option.|
|--dir DIR||Set the directory where fvwm-menu-desktop looks for a GNOME/KDE menu description to DIR. The name of the menu is desktop-name and the title is desktop name where desktop is either GNOME or KDE (if fvwm-menu-desktop cant find which desktop is concerned, you can help with the --desktop option) and where name is the name of the right directory of DIR (or a hint of the desktop for the title). Note that if this option is not set, the description directory is install-prefix/share/gnome/apps if --desktop is gnome-sys, $HOME/.gnome/apps if --desktop is gnome-user, $HOME/.gnome/apps-redhat if --desktop is gnome-redhat, $HOME/.gnome/apps-mdk if --desktop is gnome-mandriva, $KDEDIR/share/applink if --desktop is kde-sys and $HOME/.kde/share/applnk if--desktop is sys-user.|
|--destroy-type flag||flag may be "y(es)", "no", "d(ynamic)". Default is "yes" with FVWM menus, "no" with FvwmGtk menus and dynamic applies only with FVWM menus. If "yes" is used the top menu will be destroyed (DestroyMenu "name"), if "no" is used the top menu will not be destroyed (useful for FvwmGtk menus called by another menu via FvwmGtkSubMenu or to give the same name to two or more menus built by fvwm-menu-desktop). If dynamic is used the menu will be destroyed/recreated (may be useful with DynamicPopupAction). Note that all the built sub menus are always destroyed.|
|--xterm CMD||Define complete X terminal command to run applications in it if needed. Default is xterm -e.|
|--lang NAME||Default is the value of $LANG. Useful if your language is not GNOME/KDE compliant and you prefer a non-English compliant language. Also useful if fvwm-menu-desktop gives bad result with your language.|
|--utf8||Assume that the desktop entries used UTF-8 encoding. This is the case with KDE version 2 and will be probably the case with GNOME version 2. At the present time this option work only if you have perl version 5.6 or better and if your language use latin-1 font. If one of these conditions is not satisfied, then this option is equivalent to --lang en. For other languages/charsets use the --uniconv option. The advantage of this option as compared to the following option is that it is fast.|
|--uniconv charset||Use iconv, uniconv or internal method to translate utf8 desktop entries into an appropriate "charset". You can choose between one of the supported tools using --uniconv-exec option. iconv comes with glibc >= 2.1.1 and uniconv comes with the utf8 editor yudit. Type "iconv --list" or "man uniconv" for the list of supported charsets. Of course you must also use the appropriate font using the MenuStyle command. Also, $LANG (or --lang xx) must be compatible with the charset. Note, if you dont use an internal method, fvwm-menu-desktop is very slow with this option: you probably need to use the --time-limit option and you should redirect the result into a file and read this file in your FVWM configuration.|
|--uniconv-exec exec||Where exec is either iconv or uniconv or internal. Allows to choose the program which perform the UTF8 translation in the case of the --uniconv option. The internal method is only available with perl 5.8.0 and better. The default is either internal (if available) or iconv.|
|--menu-style name||By default the generated FVWM menus use the default MenuStyle (i.e., the MenuStyle "*"). You can specify another MenuStyle name using this option.|
|--[no]check-app||Either check or dont check that applications to execute are in your path. Default is --check-app.|
Change the internal limit (15 seconds) for running this script
to NUM seconds, 0 means unlimited running. This limiting may be useful
to cut mistakes with the --dir or --install-path options.
This script needs more testing to see if all options work well (note that the script does not check for inconsistency of the given options). If Desktop menu hints are changed the script may not work as expected. I have tested the script with gnome-core-1.0.3, kde-1.1, kde-1.2 and kde-2.0.
Olivier Chapuis <firstname.lastname@example.org>
Mikhael Goikhman <email@example.com> - some changes
The script is distributed by the same terms as FVWM itself. See GNU General Public License for details.
|FVWM||FVWM-MENU-DESKTOP (1)||(not released yet) (2.5.20)|