1ICEWM-PROGRAMS(5)     Standards, Environments and Macros     ICEWM-PROGRAMS(5)
2
3
4
5   NAME
6        icewm-programs - icewm programs configuration file
7
8   SYNOPSIS
9        $ICEWM_PRIVCFG/programs
10        $XDG_CONFIG_HOME/icewm/programs
11        $HOME/.icewm/programs
12        /etc/icewm/programs
13        /usr/share/icewm/programs
14
15   DESCRIPTION
16       The programs file is an automatically generated menu configuration file
17       of installed programs. This file should be automatically generated by
18       xdg_menu, wmconfig (Redhat), menu (Debian), or icewm-menu-fdo, perhaps
19       as part of the login or X startup sequence.
20
21   FORMAT
22       The format of the file contains one of the following line syntax:
23
24       prog ["]title["] icon program options
25           Specifies a program to execute when the menu item is selected.
26
27       restart ["]title["] icon program options
28           Specifies a program to replace the window manager when the menu
29           item is selected.  This is for launching other window managers from
30           within icewm(1).
31
32       runonce ["]title["] icon "[res_name][.res_class]" program options
33           Specifies a program to execute when the menu item is selected;
34           however, if a window of the specified res_name and res_class is
35           present, the program will not be run again.
36
37       menu ["]title["] icon { # contained items }
38           Specifies a sub-menu.  The lines that appear between the braces can
39           be any menu item described here.
40
41       menufile ["]title["] icon ["]filename["]
42           Specifies a file from which to collect sub-menu items (lines) and
43           place them at this point in the menu.
44
45       menuprog ["]title["] icon program options
46           Specifies a program that will print sub-menu items on standard
47           output and will be collected and placed in the sub-menu at this
48           point.
49
50       menuprogreload ["]title["] icon timeout program options
51           Similar to menuprog, but after at least timeout seconds the menu is
52           regenerated.
53
54       include ["]filename["]
55           Read additional entries from the file filename
56
57       includeprog program options
58           Read additional entries from the output of program options.
59
60       separator
61           A separator for menu items.
62
63       Where
64
65       prog, restart, runonce, menu, menufile, menuprog, menuprogreload,
66       include, includeprog, separator
67           These are literal string keywords.
68
69       ["]title["]
70           This is the title string associated with the menu item which is
71           displayed in the menu.  When the title contains spaces, the title
72           must be surrounded by double quotes ("""), although the title may
73           always be surrounded by double quotes if preferred.
74
75       icon
76           Is the name of the icon file (with or without extension) or the
77           full path to an icon file.
78
79       "[res_name][.res_class]"
80           res_name is the resource name of a window launched by program and
81           res_class is the resource class of the window.  Only one of
82           res_name or res_class need be specified.  This is used to identify
83           whether the program is already running and is for use with the
84           runonce keyword.
85
86       program options
87           program is the name of the executable or full path to the
88           executable file that will be run in response to selecting the menu
89           item.  When used with the menuprog keyword, the program must print
90           on standard output the contents of the menu and is used for dynamic
91           menus.
92
93           options is the options and arguments passed to the program
94           verbatim.
95
96       filename
97           filename is the name of the file relative to one of the icewm(1)
98           configuration directories, or the full path to a file.  The file is
99           used with the menufile keyword and specifies the file from which to
100           read further menu items.
101
102   EXAMPLES
103       Following is the example programs file that ships with icewm(1):
104
105        # This file is intended to be customized by the distributions.
106        # (they should place it in /etc/X11/icewm)
107        #
108        # mostly obsolete, fixme
109        menu Editors folder {
110            prog fte fte fte
111            prog vim vim gvim
112            prog xemacs xemacs xemacs
113            prog emacs emacs emacs
114            prog NEdit nedit nedit
115            prog xedit xedit xedit
116            prog Lyx emacs lyx
117        }
118        menu "WWW" folder {
119            prog Netscape netscape netscape
120            prog Mozilla mozilla mozilla
121            prog Galeon galeon galeon
122            prog Arena arena arena
123            prog Lynx lynx xterm -e lynx
124            prog Links lynx xterm -e links
125        }
126        menu "Document Viewers" folder {
127            prog "Acrobat Reader" pdf acroread
128            prog "DVI Previewer" xdvi xdvi
129            prog "Ghostview" ghostview gv
130        }
131        menu Graphics folder {
132            prog Gimp gimp gimp
133            prog XV xv xv
134            prog XPaint xpaint xpaint
135            prog XFig xfig xfig
136        }
137        menu Games folder {
138            prog "Koules for X" koules xkoules -f
139            prog Xboing xboing xboing
140            prog Xboard xboard xboard
141            prog XGalaga xgalaga xgal
142            prog XDemineur xdemineur xdemineur
143            prog "Tux Racer" tuxracer tuxracer
144        }
145        menu System folder {
146            prog "Control Panel" redhat control-panel
147        }
148        menu Utilities folder {
149            prog XPlayCD xplaycd xplaycd
150            prog XMixer xmixer xmixer
151            prog Clock xclock xclock
152            prog Magnify xmag xmag
153            prog Calculator xcalc xcalc
154            prog Colormap xcolormap xcmap
155            prog Clipboard xclipboard xclipboard
156            prog xkill bomb xkill
157            prog xload xload xload
158            prog xosview xosview xosview
159            separator
160            prog "Screen Saver" xlock xlock -nolock
161            prog "Screen Lock" xlock xlock
162        }
163        menu "Window Managers" folder {
164            restart icewm - icewm
165            restart metacity - metacity
166            restart wmaker - wmaker
167            restart fluxbox - fluxbox
168            restart blackbox - blackbox
169            restart enlightenment - enlightenment
170            restart fvwm2 - fvwm2
171            restart fvwm - fvwm
172            restart sawfish - sawfish
173            restart sawfish2 - sawfish2
174        }
175
176   FILES
177       Locations for the programs file are as follows:
178
179        $ICEWM_PRIVCFG/programs
180        $XDG_CONFIG_HOME/icewm/programs
181        $HOME/.icewm/programs
182        /etc/icewm/programs
183        /usr/share/icewm/programs
184
185       The locations are searched in the order listed; the first file found is
186       read and the remainder ignored.
187
188   SEE ALSO
189       icewm(1), icewm-menu(5), icewm-menu-fdo(1).
190
191   AUTHOR
192       Brian Bidulock <mailto:bidulock@openss7.org>.
193
194   LICENSE
195       IceWM is licensed under the GNU Library General Public License.  See
196       the COPYING file in the distribution.
197
198
199
200icewm 3.3.1                       2023-01-24                 ICEWM-PROGRAMS(5)
Impressum