==========================================================================
  P  A  R  A  L  O  G  G  E  R     (C) 1999-2002 Geir Torstein Kristiansen
========================================================================== 

         --> k e e p i n g  a n  e y e  o n  y o u r  l o g s <--     

--------------------------------------------------------------------------

 If you find any bugs, have any suggestions or general improvements
 please drop me a line.

 Email simply stating that "hi it works with system <insert system>
 makes me happy. 

 Main shell-script-kiddie: 
 Geir Torstein Kristiansen <gtk@linux.online.no>

 URL http://projects.gtk.mine.nu
 URL http://home.online.no/~geir37/projects

--------------------------------------------------------------------------
 D e s c r i p t i o n
--------------------------------------------------------------------------

 Bourne shell script to "tail" the system log(s) in borderless transparent 
 Eterm(s). 

 It's purpose is to ease the process of setting up a "root tail". 

 It is nice to monitor your system this way and it also adds to the
 eyecandy factor of your desktop. 

--------------------------------------------------------------------------
 F e a t u r e s
--------------------------------------------------------------------------

 * Auto-detects the screen resolution 
 * Auto-detects the Eterm version
 * Takes care of the placement of Eterm(s) based on 6 predefined base
   placements 
 * Tunable offset relative to the base placement so you can get the
   terminals out of the way of the border decorations of your WM, 
   icons, pagers and other stuff 
 * Uses either regular tail (default) or colortail
 * Mapping of different colortail configurations to different log files 
 * Automatic cascading of the Eterm(s) 
 * Both horizontal and vertical cascading supported.
 * Asks for password if you don't have access to the logs
 * Can automatically load or save a configuration file, so you don't have
   to remember the options you passed to the script
 * To prevent nasty shell commands from being executed, the configuration
   file is parsed, not just sourced.

--------------------------------------------------------------------------
 H i s t o r y
-------------------------------------------------------------------------- 

 I remember first seeing someone using transparent Eterm's 
 (or Rxvt with the same xpm as their root background) to tail their
 system log. I drooled at this and decided to make a script to do
 this on my own desktop. The script I called paralogger was not really 
 "one" script but two _very_ simple separate scripts.
 
 I eventually got so annoyed by the fact that the old scripts had
 had to be in two separate files that I started making this script.
 What also annoyed me was that I had to fiddle with the geometry if
 I decided to change my screen resolution. Now the script takes care
 of this.

 I sent Hallvar Helleseth a copy of this script and he sent me a
 hacked version with neat ideas like auto cascading of the terminals.
 I ended up rewriting most of this since It didn't have support for
 other resolutions than 1600x1200 (I think).

 Anyways the auto cascading wouldn't have been there if it not were
 for Hallvar.

 Tumoas Jormola wrote the first usable command line parser using getopts,
 he also wrote and had the idea about detecting the version of the Eterm
 automatically so the user don't have to configure this manually.

 *cough* did anyone actually read this ?

--------------------------------------------------------------------------
 K n o w n  i s s u e s 
--------------------------------------------------------------------------

 These window managers doesn't like the "-x" option to Eterm and therefore
 Eterm may not start borderless in them.

 * AfterStep-1.5-0.3 (and possibly earlier versions.)

--------------------------------------------------------------------------
 U s a g e
--------------------------------------------------------------------------

 Refer to the INSTALL file for how to install. Also see index.html in the
 html directory that comes with the paralogger tarball.

 Refer to the man page or "paralogger -h" for specific command line options.

