1ICEWM-MENU-FDO(1)                User Commands               ICEWM-MENU-FDO(1)
2
3
4
5   NAME
6        icewm-menu-fdo - menu generator for .desktop files
7
8   SYNOPSIS
9       icewm-menu-fdo [OPTIONS] [FILENAME]
10
11   DESCRIPTION
12       icewm-menu-fdo generates a menu for the IceWM window manager from XDG
13       menu descriptors (aka FreeDesktop.Org .desktop files).  By including
14       this in the icewm-menu(1), the system applications become available in
15       the icewm start menu.
16
17   ARGUMENTS
18       [FILENAME]
19           The optional FILENAME argument is the location of a .desktop file.
20           When given, icewm-menu-fdo launches the application using the
21           "Exec" line from the desktop file.
22
23   OPTIONS
24       -g, --generic
25           Include the generic name in parentheses in the title of prog
26           entries.
27
28       --seps
29           Print a leading and a trailing separator.
30
31       --sep-before
32           Print a leading separator.
33
34       --sep-after
35           Print a trailing separator.
36
37       --no-sep-others
38           Don't print the "Other" category last.
39
40       --no-sub-cats
41           Don't nest subcategories in submenus.
42
43       -o, --output=FILE
44           Write the output to FILE.
45
46       --flat
47           Display apps from all categories in one level with the title
48           containing the category information as prefix.
49
50       -F sep, --flat-sep=sep
51           When used with "--flat", the specified character sequence is used
52           as separator between the section titles.
53
54       -m filter, --match=filter
55           Specifies a filter to show only apps which contain this as
56           substring within their title.
57
58       -M filter, --imatch=filter
59           Like "--match" but applied with any letter case.
60
61       --match-sec
62           Apply the filter from "--match" or "--imatch" to both, apps and
63           section titles.
64
65       --match-osec
66           Apply the filter from "--match" or "--imatch" to only to section
67           titles.
68
69       -h, --help
70           Print a brief usage statement to stdout and exit.
71
72       -V, --version
73           Print the program version to stdout and exit.
74
75       -C, --copying
76           Print copying permissions to stdout for the program and exit.
77
78   USAGE
79       This utility is not normally used directly. It is used as the
80       executable in a menuprog entry in a icewm-menu(5).
81
82   EXAMPLES
83       The following line in a icewm-menu(5) file will dynamically generate a
84       comprehensive set of menus for easy access to .desktop files.
85
86           menuprog "Desktop Apps" folder icewm-menu-fdo
87
88   ENVIRONMENT
89       XDG_DATA_HOME or XDG_DATA_DIRS are considered as suggested by XDG Base
90       Directory Specification.
91
92   CONFORMING TO
93       icewm-menu-fdo complies roughly to the XDG .desktop file and menu
94       specification, see "Desktop Entry Specification", Version 1.2alpha,
95       2015-03-06 and "Desktop Menu Specification", Version 1.1-draft, 31
96       March 2011.
97
98   CAVEATS
99       The icewm-menu-fdo program is only built when the icewm(1) package is
100       configured with the --enable-menus-fdo option, which requires the
101       glib2-dev package dependency.
102
103   SEE ALSO
104       "Desktop Entry Specification", "Desktop Menu Specification", icewm(1),
105       icewm-menu(5), icewm-preferences(5), icewm-programs(5).
106
107   BUGS
108       Please report bugs at <https://github.com/bbidulock/icewm/issues>.
109
110   AUTHOR
111       Eduard Bloch <mailto:edi@gmx.de>.
112
113       See --copying for full copyright notice and copying permissions.
114
115   LICENSE
116       IceWM is licensed under the GNU Library General Public License.  See
117       the COPYING file in the distribution or use the --copying flag to
118       display copying permissions.
119
120
121
122icewm 3.3.1                       2023-01-24                 ICEWM-MENU-FDO(1)
Impressum