ICEPREF 0.10

Written and maintained by David Mortensen

INTRODUCTION

IcePref is a configuration utility for IceWM written in Python using the Gtk
widget set and the PyGTK bindings.  It currently covers all of the
configuration options in the controlled by the preferences file for icewm
0.9.45.  It is my hope to expand this coverage so that it can edit the menus as
well (which is a bit more challenging, I'm afraid).  While I have made valient
strides in this direction, such functionality is still not supported in the
present version.  In fact, if it is ever to be supported, I am going to need
some help from more competant individuals.

LICENSE

IcePref is copylefted software available free to all under the terms of the GNU
GPL (a copy of which should have been included with this file).  If you do not
have a copy of the legendary GPL, you can get one at GNU's web site
(http://www.gnu.org).

REQUIREMENTS

To use IcePref, you obviously need to have IceWM installed.  You needn't have
the newest version, and any later version should work (within reasonable
parameters).  Furthermore, you must have a recent version (>= 1.2.0) of gtk and
a compatible version of the PyGTK bindings (which are included, if you are a
GNOME user, in the PyGNOME package).  Sadly, these things are no longer
available from my website.  You will have to scavenge the web for them
yourself. Luckily, they seem to be finding their way in to may distributions of
Linux and other Unix-like OSes.

Note that the most common problem users experience when trying to use IcePref
results from an improper installation of PyGTK.  Make sure you can run the
PyGTK example programs (which are located under the PyGTK doc directory) before
you assume that there is a fatal problem with IcePref. 

INSTALLATION

Right now, installation is simple and inefficient (unless you are a user of the
superior Debian GNU/Linux distribution).  When IcePref becomes more mature, I
will set it up as a 'real' package.  Meanwhile, just copy the script (icepref)
to some place in your path.  I like /usr/X11R6/bin.  Then you should be able to
start the program by typing 'icepref' at the command line.

USE

Assuming that the script (icepref) is in your path, just type icepref.  The
rest should be fairly self explanatory.  It no longer matters whether you run
it from your home directory.  Also, if you do not have an .icewm subdirectory
in your home directory, IcePref will create one. 

BUGS

Report all of the many bugs you are certain to find (this is only version 0.10!)
to Dave at SLQTN@cc.usu.edu.  Send all comments and suggestions for improvement
to the same address.  Happy configuration!
