The format of a wmappl configuration file consists of a number of sections, defined by a section name surrounded in square brakets, for example: "[section]". Each button that should appear in wmappl should have its own section. The lines following the section name specify the icon to use, the command to launch when the button is pressed and an optional tooltip string to be displayed.
An optional [wmappl] section may be specified which specifies configuration options for wmappl. These options have the same names as the long command line options and are entirely optional. Command line arguments will override any specified in the configuration file.
Anything after a pound sign ('#') is considered a comment and will be ignored. A line may be continued by ending the line in a backslash ('\'). Blank lines and any invalid key=value pairs are ignored.
xpm icon for the button, accepts an absolute path or a path relative to a directory in the iconpath
command to execute when button is pressed, it should end with an to run it in the background
tooltip that should be displayed over the button when the mouse is hovered over it
a colon separated path to search for icons
window name (specify different names to run multiple instances)
run in windowed mode if this option is specified
run in debug mode if this option is specified
The following example defines nine buttons, specifies wmappl options and demonstrates comments, line expansion and blank lines:
[wmappl] iconpath=/usr/share/icons/wmappl:/usr/share/pixmaps/mini name=Demo window= debug= [info] icon = info.xpm command = xmessage "Reports bugs to: \ wmappl.sourceforge.net" & tooltip = wmappl information [man wmappl] icon = wmappl.xpm command = xterm -fg white -bg black -e man wmappl & tooltip = open the wmappl man page [wprefs] icon = gnustep.xpm command = /usr/share/GNUstep/WPrefs.app/WPrefs & [mozilla] icon = mozilla.xpm command = mozilla & [xterm] icon = glowx.xpm command = xterm & [ghostview] icon = ghost.xpm command = gv & [xmms] icon = xmms.xpm command = xmms & tooltip = xmms gets a really really really \ really really really really really \ really really really really really \ long tooltip! [ssh to work] icon = ssh.xpm command = xterm -fg green -bg black \ -e ssh -l user shell.work.com &