man

IceWM man pages

View on GitHub

NAME

icewm-menu-fdo - menu generator for .desktop files

SYNOPSIS

icewm-menu-fdo [OPTIONS] [FILENAME]

DESCRIPTION

icewm-menu-fdo generates a menu for the IceWM window manager from XDG menu descriptors (aka FreeDesktop.Org .desktop files). By including this in the icewm-menu(1), the system applications become available in the icewm start menu.

ARGUMENTS

OPTIONS

USAGE

This utility is not normally used directly. It is used as the executable in a menuprog entry in a icewm-menu(5).

EXAMPLES

The following line in a icewm-menu(5) file will dynamically generate a comprehensive set of menus for easy access to .desktop files, added in a submenu called Desktop Apps.

menuprog "Desktop Apps" folder icewm-menu-fdo

It can also be embedded directly into the loading menu like in the following example. There could be a separator line added before or after (or both) in case where the program could generate useful content.

includeprog icewm-menu-fdo --seps

ENVIRONMENT

XDG_DATA_HOME or XDG_DATA_DIRS are considered as suggested by XDG Base Directory Specification.

TERMINAL may define a terminal emulator that supports the ‘-e’ option. The option is ignored if the specified command could not be found and a default is used instead.

CONFORMING TO

icewm-menu-fdo complies roughly to the XDG .desktop file and menu specification, see “Desktop Entry Specification” (Date: 2020-04-27, Version: Version 1.5) and “Desktop Menu Specification” (Date: 20 August 2016, Version: Version 1.1).

CAVEATS

The icewm-menu-fdo program is only built when the icewm(1) package is configured with the –enable-menus-fdo option and only works with –enable-i18n option.

Integration of XDG menu files is somewhat of varying quality, heavily depending on the correctness of metadata like translations and sections (menu category) hints.

SEE ALSO

Base Directory Specification, Desktop Entry Specification, Desktop Menu Specification, icewm(1), icewm-menu(5), icewm-preferences(5), icewm-programs(5).

BUGS

Please report bugs at Github.

AUTHOR

Eduard Bloch.

See –copying for full copyright notice and copying permissions.

LICENSE

IceWM is licensed under the GNU Library General Public License. See the COPYING file in the distribution or use the –copying flag to display copying permissions.

Index IceWM