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)