=====
ABOUT
=====

xdgmenumaker is a command line tool, written in python, that generates
application menus using xdg information, by scanning *.desktop files
in /usr/share/applications and ~/.local/share/applications. 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 and
windowmaker. In-menu icons are not supported for now, maybe in the
future.

pyxdg is 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