Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
wmapplrc(1)		     General Commands Manual		     wmapplrc(1)

NAME
     wmapplrc - configuration file for wmappl

DESCRIPTION
     The format of a wmappl configuration file consists of a number of sections,
     defined by a section name surrounded in square brakets, for example: "[sec-
     tion]".  Each  button that should appear in wmappl should have its own sec-
     tion. 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  over-
     ride  any	specified in the configuration file. There are some options that
     have no cooresponding command line option.

     Anything after a pound sign ('#') is considered a comment and will  be  ig-
     nored.  A	line  may  be continued by ending the line in a backslash ('\').
     Blank lines and any invalid key=value pairs are ignored.

BUTTON SECTION OPTIONS
     icon=<iconfile>
	    xpm icon for the button, accepts an absolute path or a path relative
	    to a directory in the iconpath

     command=<command>
	    command to execute when button is pressed, it should end with an  to
	    run it in the background

     tooltip=<tooltip string>
	    tooltip that should be displayed over the button when the  mouse  is
	    hovered over it

WMAPPL SECTION OPTIONS
     iconpath=<path1>:[path2]:...:[pathN]
	    a colon separated path to search for icons

     name=<windowname>
	    window name (specify different names to run multiple instances)

     tooltip_delay=<delay in milliseconds>
	    delay in milliseconds before appearance of tooltip

     window=
	    run in windowed mode if this option is specified

     debug=
	    run in debug mode if this option is specified

     background_color=<color>
	    specifies the background color of wmappl

     background_icon=<iconfile>
	    xpm icon for the background of wmappl, accepts an absolute path or a
	    path  relative to a directory in the iconpath (takes precedence over
	    background_color option)

     tooltip_foreground=<color>
	    foreground (text) color for tooltips

     tooltip_background=<color>
	    background color for tooltips

     tooltip_font=<X11 font string>
	    X11 font string for the font to use for tooltips

EXAMPLE
     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=
	 tooltip_delay=800		  # 800 milliseconds
	 tooltip_foreground=rgb:ff/ff/ff  # white tooltip text
	 tooltip_background=rgb:ff/00/00  # red tooltip background
	 tooltip_font=-*-bitstream  vera  serif-*-*-*-*-*-*-*-*-*-*-*-*   #  use
     vera serif font
	 background_color=rgb:73/7e/df	  # light blue wmappl background
	 background_icon=checker.xpm
	 # the checkered background will override the light blue background

	 [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 &

REPORTING BUGS
     Report bugs at http://wmappl.sourceforge.net

WARRANTY
     This is free software with ABSOLUTELY NO WARRANTY

AUTHOR
     Casey Harkins <charkins@pobox.com>

SEE ALSO
     wmappl(1)

				  March 9, 2004 		     wmapplrc(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=wmapplrc&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>

home | help