Installation
~~~~~~~~~~~~
1) Get the latest software release from [1]


2) Create a directory somewhere in your lisp path (~/elisp in this example) 
   and extract the archive: 

Stella:~> cd ~/elisp && mkdir biff4emacsen && cd biff4emacsen
Stella:~/elisp/biff4emacsen> gzip -dc .../biff4emacsen-x.x.tar.gz | tar xf -


3) Compile the application:

Stella:~/elisp/biff4emacsen> cc biff4emacsen.c -o biff4emacsen


4) Configure your XEmacs:

Before you can use the extraordinary features of biff4emacsen you have to 
configure it. This can be done the oldfashioned way or you can use the
customization feature of your XEmacs. 

Example:

( setq load-path ( cons ( expand-file-name "~/elisp/biff4emacsen" ) load-path ) )
( setq b4e-prog "~/elisp/biff4emacsen/biff4emacsen" )
( setq b4e-maildir-prefix "-p/maildirs" )
( setq b4e-maildir-postfix "-Pnew" )
( setq b4e-maildirs ( quote ( "-fmaildir1" "-fmaildir2" ...) ) )
( setq b4e-icon-dir ( expand-file-name "~/elisp/biff4emacsen" ) )
( load "biff4emacsen" )

Most of the options are preset with a more or less meaningful default
value. For an explanation of the various options use C-h a b4e-maildirs etc.

Hint: The path to the incoming maildirs is constructed by applying the
      values of b4e-maildir-prefix and b4e-maildir-postfix to each element
      in b4e-maildirs. If the element of b4e-maildirs isn't an absolute path, 
      the value of b4e-maildir-prefix is prependet. If the element doesn't
      stop with '/', the value of b4e-maildir-postfix is appended:
	
      maildir1      becomes   /maildirs/maildir1/new
      /maildir1     becomes   /maildir1/new
      maildir/      becomes   /maildirs/maildir1
      /maildir1/    becomes   /maildir1/


After restarting your XEmacs the mode line should contain a shiny new
icon. That was an easy job, hu?


Feedback
~~~~~~~~
Feel free to contact me (pkgs@c0t0d0s0.de) and tell me your opinion about
biff4emacsen. Do you find biff4emacsen useful? Or is it the most superfluous
thing you have seen in ages? Perhaps you have some feature requests?


License
~~~~~~~
All biff4emacsen stuff is released under the GNU General Public License [2],
Version 2.


Footnotes
~~~~~~~~~
[1] http://www.c0t0d0s0.de/biff4emacsen/biff4emacsen.html
[2] http://www.gnu.org/licenses/gpl.html