icewm-menu-fdo(1)

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       -h, --help
47           Print a brief usage statement to stdout and exit.
48
49       -V, --version
50           Print the program version to stdout and exit.
51
52       -C, --copying
53           Print copying permissions to stdout for the program and exit.
54
55   USAGE
56       This utility is not normally used directly. It is used as the
57       executable in a menuprog entry in a icewm-menu(5).
58
59   EXAMPLES
60       The following line in a icewm-menu(5) file will dynamically generate a
61       comprehensive set of menus for easy access to .desktop files.
62
63           menuprog "Desktop Apps" folder icewm-menu-fdo
64
65   ENVIRONMENT
66       XDG_DATA_HOME or XDG_DATA_DIRS are considered as suggested by XDG Base
67       Directory Specification.
68
69   CONFORMING TO
70       icewm-menu-fdo complies roughly to the XDG .desktop file and menu
71       specification, see "Desktop Entry Specification", Version 1.2alpha,
72       2015-03-06 and "Desktop Menu Specification", Version 1.1-draft, 31
73       March 2011.
74
75   CAVEATS
76       The icewm-menu-fdo program is only built when the icewm(1) package is
77       configured with the --enable-menus-fdo option, which requires the
78       glib2-dev package dependency.
79
80   SEE ALSO
81       "Desktop Entry Specification", "Desktop Menu Specification", icewm(1),
82       icewm-menu(5), icewm-preferences(5), icewm-programs(5).
83
84   BUGS
85       Please report bugs at <https://github.com/bbidulock/icewm/issues>.
86
87   AUTHOR
88       Brian Bidulock <mailto:bidulock@openss7.org>.
89
90       See --copying for full copyright notice and copying permissions.
91
92   LICENSE
93       IceWM is licensed under the GNU Library General Public License.  See
94       the COPYING file in the distribution or use the --copying flag to
95       display copying permissions.
96
97
98
99icewm 2.9.7                       2022-05-16                 ICEWM-MENU-FDO(1)