WindowMaker Configuration Utility (wmakerconf 1.0)

Copyright (C) 1998 Ullrich Hafner <hafner@informatik.uni-wuerzburg.de>

Description
===========
Wmakerconf is a GTK+ based configuration tool
for WindowMaker (http://windowmaker.org). Its main WWW site is at
http://www-info2.informatik.uni-wuerzburg.de/staff/ulli/wmakerconf/

Features:
=========
o Support for all WindowMaker attributes (version >= 0.15.0)
o Font selection browser, pixmap preview browser, color selection dialog,
  shortcut dialog, file selection dialog, ...
o Tooltips with short description of every attribute
  (english and german version)
o Themes.org tiles configuration (http://themes.org/)
o New attributes can be simply integrated by changing the wmakerconf
  proplist

System requirements:
====================
o WindowMaker >= 0.15.0 (http://windowmaker.org)
o libPropList >= 0.7.1  (http://windowmaker.org)
o GTK         >= 1.0.2  (http://www.gtk.org)
o ANSI C compiler/library

Recommended additional packages:
o Rasterman's Imlib >= 1.7 (http://www.labs.redhat.com/imlib/)
	--> display of JPEG, TIFF, PNG pixmaps
o Perl >= 5.002 (http://www.perl.com/, http://www.perl.org/,
  http://www.cpan.org/) and one of the following:
  1) Perl Module HTML-Parser
     (http://www.perl.com/cgi-bin/cpan_mod?module=HTML::Parser)
     and Perl Module libwww
     (http://www.perl.com/cgi-bin/cpan_mod?module=LWP)
  2) LYNX WWW browser (http://lynx.browser.org/)
	--> Tile of the day configuration

Tested on Intel Linux Redhat 4.2/5.0/5.1, Intel Linux SuSE 5.1/5.2,
and DEC Alpha/Digital UNIX 4.0, SUN Sunos 4.1.3.

Getting wmakerconf
==================
Wmakerconf is available at:

http://www-info2.informatik.uni-wuerzburg.de/staff/ulli/wmakerconf/
ftp://sunshine.informatik.uni-wuerzburg.de/pub/wmaker/

All required/recommended libs are also available at
ftp://sunshine.informatik.uni-wuerzburg.de/pub/wmaker/

Installation
============
tar xzf wmakerconf-0.6.tar.gz
cd wmakerconf-0.6
./configure
make
make install

Please install required and recommended packages prior to wmakerconf. 

Known BUGS
==========
Some broken XPM's may cause a segv in Imlib <= 1.6 (used by wmakerconf).
Please either start wmakerconf with option -nopreviews or move the
following pixmaps into a directory that is not covered by PixmapPath:

 /usr/X11R6/include/X11/pixmaps/mail.xpm
 /usr/X11R6/include/X11/pixmaps/file_dvi.xpm
 /usr/X11R6/include/X11/pixmaps/file_root.xpm
 /usr/X11R6/include/X11/pixmaps/file_plain.xpm
 /usr/X11R6/include/X11/pixmaps/file_text.xpm
 /usr/X11R6/include/X11/pixmaps/xlogo.xpm
 /usr/X11R6/include/X11/pixmaps/xmore.xpm

Please consider an upgrade to Imlib 1.7.

Documentation
=============
Currently, only this README is available.
wmakerconf is simply invoked by
> 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` in case you need to revert to
your original version. Changing the WindowMaker attributes should be
self-explanatory since tooltips are provided for every option. 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 have to restart
wmakerconf instead.

Menu
====
File->Save:    Save current status of WindowMaker file
File->Revert:  Revert to backup WindowMaker file and exit wmakerconf
File->Upgrade: Connect to wmakerconf homepage and check if the WindowMaker
               attributes have been changed. If yes, get new
	       wmakerconf-data.$version.tar.gz file, unpack and install it.
File->Exit:    Exit wmakerconf with or without saving the WindowMaker file

Color Scheme
============
You can edit the file wmakerconf.gtkrc to change the widget colors. Refer
to the GTK+ tutorial (section 18) for a brief description of the RC syntax.

Tiles of 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', and 'guest tile of the week'. Wmakerconf automates the process
of periodically getting the corresponding tiles with a small perl script
and the cron daemon. (This tile is only used for the attribute IconBack.)
Configuration is invoked with the button "IconBack->Tiles".
"Get selected tile": gets selected tile via HTTP request at
                     http://themes.org/totd/.
 		     Doesn't replace the IconBack attribute.
"Use selected tile": Replaces IconBack attribute with selected tile.
"periodically get tile at": configure cron daemon to get selected tile at
			    given time and day
WARNING: tile of the day will only work if WindowMaker is compiled
	 with JPEG support.

Copyright
=========
wmakerconf is copyrighted by Ullrich Hafner and is licensed through the
GNU General Public License. Read the COPYING file for the complete license.

--
Ullrich Hafner                        
<hafner@informatik.uni-wuerzburg.de>    
Department of Computer Science, University Wuerzburg, Germany
URL: http://www-info2.informatik.uni-wuerzburg.de/staff/ulli

