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       -t, --terminal=NAME
47           Use NAME to start a terminal emulator that supports the '-e'
48           option.
49
50       --flat
51           Display apps from all categories in one level with the title
52           containing the category information as prefix.
53
54       -F sep, --flat-sep=sep
55           When used with "--flat", the specified character sequence is used
56           as separator between the section titles.
57
58       -m filter, --match=filter
59           Specifies a filter to show only apps that contain this as substring
60           within their title.
61
62       -M filter, --imatch=filter
63           Like "--match" but applied with any letter case.
64
65       --match-sec
66           Apply the filter from "--match" or "--imatch" to both, apps and
67           section titles.
68
69       --match-osec
70           Apply the filter from "--match" or "--imatch" to only to section
71           titles.
72
73       -h, --help
74           Print a brief usage statement to stdout and exit.
75
76       -V, --version
77           Print the program version to stdout and exit.
78
79       -C, --copying
80           Print copying permissions to stdout for the program and exit.
81
82   USAGE
83       This utility is not normally used directly. It is used as the
84       executable in a menuprog entry in a icewm-menu(5).
85
86   EXAMPLES
87       The following line in a icewm-menu(5) file will dynamically generate a
88       comprehensive set of menus for easy access to .desktop files.
89
90           menuprog "Desktop Apps" folder icewm-menu-fdo
91
92   ENVIRONMENT
93       XDG_DATA_HOME or XDG_DATA_DIRS are considered as suggested by XDG Base
94       Directory Specification.
95
96       TERMINAL may define a terminal emulator that supports the '-e' option.
97
98   CONFORMING TO
99       icewm-menu-fdo complies roughly to the XDG .desktop file and menu
100       specification, see "Desktop Entry Specification", Version 1.2alpha,
101       2015-03-06 and "Desktop Menu Specification", Version 1.1-draft, 31
102       March 2011.
103
104   CAVEATS
105       The icewm-menu-fdo program is only built when the icewm(1) package is
106       configured with the --enable-menus-fdo option, which requires the
107       glib2-dev package dependency.
108
109   SEE ALSO
110       "Desktop Entry Specification", "Desktop Menu Specification", icewm(1),
111       icewm-menu(5), icewm-preferences(5), icewm-programs(5).
112
113   BUGS
114       Please report bugs at <https://github.com/bbidulock/icewm/issues>.
115
116   AUTHOR
117       Eduard Bloch <mailto:edi@gmx.de>.
118
119       See --copying for full copyright notice and copying permissions.
120
121   LICENSE
122       IceWM is licensed under the GNU Library General Public License.  See
123       the COPYING file in the distribution or use the --copying flag to
124       display copying permissions.
125
126
127
128icewm 3.4.4                       2023-11-03                 ICEWM-MENU-FDO(1)