Window Maker Configuration Utility (wmakerconf 1.6)

Copyright (C) 1998 Ullrich Hafner <hafner@bigfoot.de>

wmakerconf is simply started with
> wmakerconf [-nopreviews] [filename]

If no filename is given, then wmakerconf tries to guess the right path
of the configuration file 'WindowMaker`. Wmakerconf automatically
generates a backupfile 'WindowMaker.bak` and 'WMRootmenu.bak` in case
you need to revert to your original files. If option -nopreviews is
given then disable pixmap preview browser (may cause some problems
with gtk+ < 1.0.2 [memory leaks] or if you have too much pixmaps in
your PixmapPath). Pixmaps previews are read in at startup time, hence,
changing the value of PixmapPath will not affect the contents of the
preview dialog window - you'll have to restart wmakerconf instead.

Menu
====
File->Save:    Save current status of WindowMaker file
File->Revert:  Revert to backup files WindowMaker and WMRootmenu and exit
	       wmakerconf 
File->Upgrade: Connect to wmakerconf homepage and check if the Window Maker
               attributes have been changed. If yes, get new
	       wmakerconf-data package, unpack and install it.
	       Restart wmakerconf to use the new attributes. (If wmakerconf
	       was installed via RPM then an RPM upgrade is used)	
File->Exit:    Exit wmakerconf, but ask whether or not to save the
	       WindowMaker file.

Changing the Window Maker attributes should be self-explanatory since
tooltips are provided for every option. However, two notebook pages
need some more documentation:

Textures
========

Texture configuration supports all those beautiful images from
themes.org.  First of all, you should have a look at
http://themes.org/ if you don't know the meaning of 'tile of the day',
'random tiles from the masses', 'guest tile of the week', 'daily
root', and 'bar of the day'.  Wmakerconf automates the process of
periodically getting the corresponding pixmaps with a small perl
script and the cron daemon.

Configuration is invoked with the button "Themes.org"
(textures->attribute->pixmap->themes.org). The button is only visible if
texture type is set to spixmap, cpixmap, or tpixmap.

After pressing the button "Themes.org" a new dialog window is shown:

"Get current pixmap ": 	Gets selected pixmap via HTTP request from
                       	http://themes.org/ and overwrites old contents of
		       	pixmap file. Wmakerconf will freeze until the
		       	pixmap is completely received.
 		       	Doesn't change the corresponding WindowMaker attribute.
"Use selected tile":   	Replaces WindowMaker attribute with selected tile.
"Periodically get at": 	configure cron daemon to get selected tile at
		       	given time and day
"Date offset [days]":  	Instead of getting the bar of 'today' get the bar of
		       	('today' - 'offset'). E.g., when specifying an offset of
 	               	'a' and 'b' days  ('a' != 'b') for the attributes
			`MenuTitleBack' and `MenuTextBack', respectively, then
			every day a new combination of bars is received.
			
WARNING: themes.org pixmaps configuration will only work if
	 Window Maker is compiled with JPEG and TIFF support.

Rootmenu
========

[ONLY WITH GTK+ >= 1.1.5]

In the tree view of the application menu (rootmenu), the following
commands are available via context menu (mouse button 3) or shortcut:

Insert new submenu (Control+m):
	Inserts a new submenu in front of selected row
Insert new command (Control+c):
	Inserts a new menu item in front of selected row
Insert RedHat menu/Insert Debian menu:
	Insert a new menu item in front of selected row that includes
	the system menu provided by the corresponding distribution
Insert default menu:
	Insert Window Maker's default menu in front of selected row. Use the
	<import> button to change the menu.
Cut item/submenu (BackSpace/Delete/Control+k):
	Move selected item/submenu to the cut buffer
Past item/submenu (Insert/Control+y):
	Paste contents of cut buffer in front of selected row
Expand submenus:
	Expand all submenus of the menu
Collapse submenus:
	Collapse all childs of the toplevel menu

Moreover, rows can be selected with the cursor keys or a mouse button
1 click. Individual nodes can be expanded/collapsed with Space, Return
or a double click of mouse button 1. Menu items can be reordered with
drag and drop (mouse button 1).

The command configuration shouild be self-explanatory. Tooltips are
provided for all options. Commands "Include menu file" and "Include
dynamic menu" have an import button to paste the contents of the
corresponding menu in front of the selected row. So you can include,
for example, Window Maker's default menu (in your language) and change
it.

Copyright
=========
wmakerconf is copyrighted by Ullrich Hafner <hafner@bigfoot.de>    
and is licensed through the GNU General Public License.
Read the COPYING file for the complete license.

