IceMe
=====

    Originally written and maintained by Dirk Moebius <dmoebius@gmx.net>
	 Now mantained by Mike Hostetler <thehaas@binary.net>


INTRODUCTION

IceMe is a graphical menu editor for IceWM written in Python using the
GTK+ widget set and the PyGTK bindings.


LICENSE

IceMe 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 GPL, you can get one at GNU's web site
(http://www.gnu.org).
	

PLATFORMS

In theory, IceMe should work (for the most part) under any UNIX-like OS
on which PyGTK will function.  It has been tested and developed on a 
Gentoo machine with PyGTK 1.99.13.
	     
If you get IceMe to work on an additional platform, please let me know.
	

REQUIREMENTS

* IceWM > 0.94 or higher    http://icewm.sourceforge.net
* Python 2.1 or higher    http://www.python.org
* GTK+ 1.2.6 or higher      http://www.gtk.org
* PyGTK 0.6.6 or higher     http://www.daa.com.au/~james/pygtk/

INSTALLATION

* The best way to install IceMe is with Python's Distutils, which is
  included in Python 1.6 and above (note that Python 1.5.2 which comes with
  Red Hat doesn't have a working Distutils). 

  1.) Untar the tarball from http://iceme.sourceforge.net
  2.) cd to iceme-<version>.
  3.) "su " to root.
  4.) Type "python setup.py install".  The iceme shell script will install
  in /usr/local/bin. 
  
* There is a Makefile that Dirk Moebius originally wrote.  It is not
  currently supported, but should still work.

  Anyway, if you got the source distribution, you should have a file
  called "iceme-<version>.tar.gz".
  1. Untar it in a directory of your choice, say, /usr/src.
  2. cd iceme-<version>
  3. Copy the contents of the subdir src/ somewhere to your library
     files, e.g.:
     cp -r src /usr/local/lib/iceme
  4. Edit the "iceme" script and customize $LIB_ICEME to point to the
     library directory:
     LIB_ICEME=/usr/local/lib/iceme
  5. cp iceme /usr/local/bin

* After the program starts up, edit the IceWM menu and make a nice menu
  entry for IceMe, enter "/usr/local/bin/iceme" as command, press the
  "Save" button.

That's it. IceWM will automagically update the menu the next time you
click on it.


BUGS

Please report bugs to Mike Hostetler <thehaas@binary.net>

