=====
ABOUT
=====

xdgmenumaker is a command line tool, written in python, that generates
application menus using xdg information, by scanning *.desktop files
in all $XDG_DATA_DIRS/applications directories. All applications are
sorted according to the main categories as specified by freedesktop.org
at:
http://standards.freedesktop.org/menu-spec/latest/apa.html

The menu entries that are generated by xdgmenumaker are localised
according to the running user locale settings.

xdgmenumaker currently supports generating menus for fluxbox, icewm and
windowmaker.

pyxdg and pygtk are required by xdgmenumaker, in addition to python 2.

=======
Fluxbox
=======

To generate an application menu for fluxbox, run xdgmenumaker like this:

  $ xdgmenumaker -f fluxbox > ~/.fluxbox/xdg_menu

and then change your main fluxbox menu to include this file as a
submenu. For example, add this somewhere in your ~/.fluxbox/menu file:

  [include] (~/.fluxbox/xdg_menu)

You can add the xdgmenumaker command as another item in your menu,