Skip to content

Latest commit

 

History

History
160 lines (95 loc) · 4.16 KB

icewm-menu-fdo.md

File metadata and controls

160 lines (95 loc) · 4.16 KB
Raw
title
icewm-menu-fdo(1)

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

  • [FILENAME]

    The optional FILENAME argument is the location of a .desktop file. When given, icewm-menu-fdo launches the application using the Exec line from the desktop file.

OPTIONS

  • -g, --generic

    Include the generic name in parentheses in the title of prog entries.

  • --seps

    Print a leading and a trailing separator.

  • --sep-before

    Print a leading separator.

  • --sep-after

    Print a trailing separator.

  • --no-sep-others

    Don't print the Other category last.

  • --no-sub-cats

    Don't nest subcategories in submenus.

  • -o, --output=FILE

    Write the output to FILE.

  • -t, --terminal=NAME

    Use NAME to start a terminal emulator that supports the '-e' option.

  • --flat

    Display apps from all categories in one level with the title containing the category information as prefix.

  • -F sep, --flat-sep=sep

    When used with --flat, the specified character sequence is used as separator between the section titles.

  • -m filter, --match=filter

    Specifies a filter to show only apps that contain this as substring within their title.

  • -M filter, --imatch=filter

    Like --match but applied with any letter case.

  • --match-sec

    Apply the filter from --match or --imatch to both, apps and section titles.

  • --match-osec

    Apply the filter from --match or --imatch to only to section titles.

  • -h, --help

    Print a brief usage statement to stdout and exit.

  • -V, --version

    Print the program version to stdout and exit.

  • -C, --copying

    Print copying permissions to stdout for the program and exit.

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.

menuprog "Desktop Apps" folder icewm-menu-fdo

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.

CONFORMING TO

icewm-menu-fdo complies roughly to the XDG .desktop file and menu specification, see "Desktop Entry Specification", Version 1.2alpha, 2015-03-06 and "Desktop Menu Specification", Version 1.1-draft, 31 March 2011.

CAVEATS

The icewm-menu-fdo program is only built when the icewm(1) package is configured with the --enable-menus-fdo option, which requires the glib2-dev package dependency.

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 |