-----------------------------------------------------------------------------
PyPanel v0.9 Copyright (c) 2003 Jon Gelo (ziljian@users.sourceforge.net)
Distributed under the GNU General Public License v2, see COPYING for details.
-----------------------------------------------------------------------------

PyPanel is a lightweight panel/taskbar for X11 window managers that can be
easily customized to match any desktop theme.  The panel displays current
tasks and can also display an object on the left or right side: the current
workspace name or customizable clock.

The handling of button events on the objects and tasks is handled by the 
~/.pypanelrc configuration script.
    
-----------------------------------------------------------------------------
                       Requirements (Minimum versions)
-----------------------------------------------------------------------------
1. Python v2.2             http://www.python.org
2. Python X Library v0.12  http://python-xlib.sourceforge.net
3. libXpm v3.4 (optional)  http://koala.ilog.fr/lehors/xpm.html

-----------------------------------------------------------------------------
 Supported Window Managers - WMs that support the EWMH specification should
                             work, the following have been tested:
-----------------------------------------------------------------------------
1. WindowMaker             http://www.windowmaker.org
                           (Must be compiled with '--enable-gnome')
                           
2. Kahakai                 http://kahakai.sourceforge.net/
3. PekWM                   http://pekwm.org
4. OpenBox3                http://www.openbox.org

-----------------------------------------------------------------------------
                     Installation (Upgrading) & Starting
-----------------------------------------------------------------------------
1. python setup.py install
2. If upgrading to 0.9 from a previous version, you'll need to replace/merge 
   your ~/.pypanelrc with the new version (mv your current config, start
   pypanel and then merge the changes).
3. pypanel &

-----------------------------------------------------------------------------
                               Uninstallation
-----------------------------------------------------------------------------
PyPanel installs the following files -

1. /usr/bin/pypanel (may be in /usr/local/bin or other depending on system)
2. <path to your Python library>/site-packages/ppmodule.so (or .sl)
3. <path to your Python library>/site-packages/pypanel/
4. ~/.pypanelrc

-----------------------------------------------------------------------------
                                Configuration
-----------------------------------------------------------------------------
1. Configuration is handled via the ~/.pypanelrc python script, it's
   'executed' when pypanel is started.
2. If the level of custimization from the config script isn't enough, hack
   the pypanel script itself.

-----------------------------------------------------------------------------
                                Contributions
-----------------------------------------------------------------------------
1. The default app icon included in this distribution is from the Amaranth
   icon set by Michael Doches.  Available from http://www.kde-look.org
2. The shading routine came largely from Sasha Vasko's AfterStep term.
   Available from http://aterm.sourceforge.net
    
-----------------------------------------------------------------------------   
                                   Contact
-----------------------------------------------------------------------------
Jon Gelo (ziljian@users.sourceforge.net)
http://pypanel.sourceforge.net

-----------------------------------------------------------------------------
                                   History
-----------------------------------------------------------------------------
031109 v0.9   - Clock support
                Customizable button event handling 
                Ability to place the workspace name/clock on right/left
                Vertical line seperators can be turned off
                Bug fixes:
                Background change or restart sometimes killed panel
                Sending task to another desktop didn't update correctly
031012 v0.8   - Create ~/.pypanelrc if it doesn't exist
                Raise & focus a task via middle mouse click
                Workspace switching via clicks/scroll on the workspace name
031009 v0.7.1 - Bug fixes:
                Strut and visible name hints
                Icons with no/invalid masks
                Tasks with no name                
031004 v0.7   - OpenBox3 support
                Window shading/unshading via right mouse click
                Config option for panel width, x position and top/bottom
                Config option for displaying all tasks or just minimized
030927 v0.6   - Added EWMH support (Kahakai and PekWM) 
030921 v0.5   - Initial Beta release
