packages icon
Spruce email client v0.6.5
by Jeffrey Stedfast <xtort@xtorshun.org>

Additional code by Kristoffer Brånemyr <ztion@swipnet.se>

Legal:
------

Spruce
Copyright (C) 1999-2000 Jeffrey Stedfast

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 (unlimited)
  > Mbox folders
  > Multiple Pop3/IMAP accounts (unlimited)
  > Easy to use Account manager
  > Easy to use Address book
  > Filters (plain text matching, regex, and shell wildcards)
  > Drag and Drop
  > Mime
  > and more...

Requirements:
-------------

  Glib >= 1.2.7           (*must* be compiled with thread support)
  Gtk+ >= 1.2.0           (*must* be compiled with thread support)

  libpthread              A POSIX compliant threading library


Optional:

  Gettext 0.10.35         needed for NLS
  metamail 2.7            needed for Attachments->View menu item
  PGG                     needed for GNU Privacy Guard support

  Other requirements are unknown at this time.



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

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

      ./configure [--enable-gpg] [--with-bgti]


  2. Make the executable.

      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
      ./extras.inst

      (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:
---------------------------------
Usage: spruce [options ...]

options:
  --bindings           show key bindings and exit
  -h, --help           output this help and exit
  -i, --icons          use icons in toolbars
  -t, --text           use text in toolbars
  -o, --both           use both text and icons in toolbars
  -v, --version        print version information and exit

special:
  --mailto  <address>  specify a mail-to (TO) address
  --cc      <address>  specify a carbon-copy (CC) address
  --bcc     <address>  specify a blind carbon-copy (BCC) address
  --subject <subject>  specify a subject (must be in quotes if it has spaces)


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

   GNU/Linux (kernels 2.0.3x and 2.2.x)
   FreeBSD (http://www.freebsd.org/ports/mail.html)
   IRIX
   Digital Unix
   HP-UX 11.00
   SCO UNIX
   OS/2


Bugs:
-----

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

xtort@xtorshun.org