--  Copyright (c) 2002 by Steve Cooper
--  parts Copyright (c) 1998-2000 by John Kennis
--  parts Copyright (c) 1997,1998 by Brad Hughes.

--  This program is free software; you can redistribute it and/or modify
--  it under the terms of the GNU General Public License as published by
--  the Free Software Foundation; either version 2 of the License, or
--  (at your option) any later version.
--
--  This program is distributed in the hope that it will be useful,
--  but WITHOUT ANY WARRANTY; without even the implied warranty of
--  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
--  GNU General Public License for more details.
--
--  You should have received a copy of the GNU General Public License
--  along with this program; if not, write to the Free Software
--  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
--
-- (See the included file COPYING / GPL-2.0)
--

fluxter is a newer incarnation of bbpager, which is like the name suggests a
pager tool for Blackbox.

The major changes to bbpager are:
- Accesses fluxbox configuration files, e.g. in ~/.fluxbox, rather than in
  blackbox directories.
- Default styles come from the fluxbox configuration.  Without
  customization it will track the look of the current theme.
- The configuration files have been renamed to fluxter.bb (used in a
  fluxbox environment) and fluxter.nobb (used in a non-fluxbox
  environment).  These files should go in fluxbox configuration
  directories, such as ~/.fluxbox.
- The X resource entries in the configuration files use fluxter as a label,
  rather than bbpager.
- Per-workspace wallpaper changing is supported by the addition of
  per-workspace rootCommand configuration entries.  For example:
    fluxter.workspace0.rootCommand: Esetroot /usr/share/pixmaps/bg1.png
    fluxter.workspace1.rootCommand: Esetroot /usr/share/pixmaps/bg2.png
    fluxter.workspace2.rootCommand: Esetroot /usr/share/pixmaps/bg3.png

Notes:
- You will want to disable the fluxbox rootCommand (delete it or set it to
  nothing).  The conflict is harmless, but fluxter and fluxbox will fight
  with each other to paint the desktop at initial start up.
- See the example fluxter.bb file for a heavily customized configuration
  sample.  Note that you can leave out all the decorative items to just
  inherit the look from your current theme.  It will look ok without any
  configuration.  But obviously you need one if you want to add the
  rootCommand's for per-workspace wallpaper.

Usage: fluxter [options]
Options:
-display <display name>     X server to connect to
-c[onfig] <filename>        Alternate config file
-n[obb]                     Fall back on default configuration
-v[ersion]                  Display version number
-h[elp]                     Display this help
-geom[etry] <geometry>      Set geometry of window
-d[ecorated]                Show 'normal' decorated window
-w[withdrawn]               Place fluxter in the Slit
-s[hape]                    Don't display groundplate

WARNING:
When you change the stacking order (by raising and lowering windows) before you
start fluxter, it will show up wrong in the pager.  So just start the pager
first :-)

The files Image.cc (.hh) are taken from the Blackbox,
only one class-name was changed.

The files LinkedListed.cc (.hh) are taken from Blackbox without any change.

Author: Steve Cooper <stevencooper@isomedia.com>
   More correctly "hacker", rather than "author". :)

Thanks to:

John Kennis - author of bbpager

Brad Hughes
	For writing the Blackbox Window Manager (and with this a great deal 
	of the code for this application).
