Spruce email client v0.5.6
by Jeffrey Stedfast <xtort@xtorshun.org>

Additional code by Kristoffer Brnemyr <ztion@swipnet.se>

Legal:
------

Spruce
Copyright (C) 1999 Susixware

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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
--------------------------------------------------------------------------



How it came to be:
------------------

This started out as a project for my advanced 
programming class and I'm just not the type 
to do the minimal requirements for an A
so that's why I coded an email client :)

. o O ( I'm sure you are all thoroughly impressed... )



Features:
---------

  > Random "signatures" on each email (see sprucesig.sample for an example)
  > A custom signature file
  > Send/Receive email
  > Multiple Mailboxes
  > Mbox folders (read-only  Please see README.mbox for more info)
  > Multiple Pop3 accounts (currently up to 16)
  > Easy to use Pop3 Account editor
  > Easy to use Addressbook
  > Filters
  > Drag and Drop
  > Mime (read only)
  > IPv6 Support ( with IPv4 fallback support )
  > and more...

Requirements for GUI:
---------------------

  Glib >= 1.2.0
  Gtk+ >= 1.2.0

  (earlier versions of gtk may work...but I *know* that 1.2.x work)

  you can get these libraries at: http://www.gtk.org

  Other requirements are unknown at this time.



Installation:
-------------

  1. Run the configure script (you know the drill).

      ./configure


  2. Make the executable (defaults to console app).

      make


  3. Install it

      make install


  4. Copy sprucesig.sample to your spruce directory as sprucesig
     or you may copy it to /etc/sprucesig if you have many users
     who wish to use the same sprucesig file (since we all know
     how popular my sprucesig.sample is ;-)

      cp sprucesig.sample ~/.spruce/sprucesig
or
      ./install-sh

      (or else make up your own sig file... 1 signature per line!)


  5. Clean up our mess before mom yells... :(

      make clean


  6. Execute spruce

      spruce


  7. If spruce segfaults on it's first run, please try executing
     spruce.inst and then run spruce again. Thanks.

      ./spruce.inst


Tada!


Usage (only since version 0.4.5):
---------------------------------
Usage: spruce [options ...]
Valid options are:
  --bindings            Display key bindings
  -h --help             Output this help.
  -i --icons            Use icons in toolbars
  -t --text             Use text in toolbars
  -b --both             Use both text and icons in toolbars
  -v --version          Print version information


Proven to work on these systems:
--------------------------------

   Slackware 3.x, 4.0
   SuSE 5.3
   RedHat 5.x, 6.0
   Debian 2.1
   Stampede
   FreeBSD (http://www.freebsd.org/ports/mail.html)
   IRIX (??)
   Digital Unix (??)
   HP-UX 11.00
   SCO UNIX
   OS/2

Note: (??) means that I have been told people have gotten Spruce to
      compile/run on these platforms but I have not seen it for myself.

Bugs:
-----

There are no bugs that we know of at this time
so if you find one, please contact us

xtort@xtorshun.org
