XBuffy
				08/20/97

Xbuffy was written by Bill Pemberton (wfp5p@virginia.edu) and was based on
Xmultibiff by John Reardon.  Xmultibiff can be found at ftp.midnight.com.

I was looking for a replacement for XBiff.  I use the filter program
(it comes with elm) to separate my mail into several different
mailboxes.  I looked at a lot of replacements for XBiff until I
found Xmultibiff.  Xmultibiff was very promising, but it didn't
do quite what I wanted it to do, so I modified it to create XBuffy.

Basically, XBuffy (and Xmultibiff) is a XBiff-type program with a lot
of new options.  With XBuffy you can watch multiple mailboxes.  When
new mail arrives, you can have a pop up window showing the From: and
Subject: lines.  You can also set it up to launch your favorite mail
reader when you click on a box.  Currently. xbuffy is only capable of
watching mailboxes with the standard mailbox format (messages separated
with a From line).

This version also incorporates a new feature which will let you monitor
newsgroups in the same way you monitor mailboxes.  It parses your
.newsrc and uses NNTP to monitor any given group or groups.  It will
keep constant track of how many unread articles are in a specified
newsgroup(s).  Also, when new articles come in, it will pop up the From
and Subject lines of the article just like it pops them up for
mailboxes.  Note that this feature won't be able to see new incoming
articles if you are using a version of NNTP prior to 1.5.11t5 (the
problem is with the NNTP server, not Xbuffy).

Xbuffy uses the Athena Widget library and the libDyn package (libDyn
is included here).

To build:

	% xmkmf -a
	% make


If the make fails there are a few changes you may have to change for some
platforms.  Look at the file config.h and change anything that is appropriate.

To learn of the usefulness of multiple mailboxes and incoming mail
processing, check out procmail written by S.R. van den Berg.  It can be
used to sort your incoming mail into separate files, start programs when
mail arrives, and a host of other things.  A recent version can be
gotten from ftp.informatik.rwth-aachen.de (137.226.112.172) in
pub/unix/procmail.tar.Z.

Some mailers (including elm) cause a problem with xbuffy.  When you read
a mail message, a Status: header is added to the message to show that the
message has been read.  Many mailers will only add this header to
message in your real mailbox.  This means that xbuffy can not tell if you've
read mail in other folders.  Some mailers have configuration options that force
it to add Status: headers, some (like elm) don't.  I've made a patch to elm to
create a mode that DOES add Status: headers.  This is known as Magic mode.
Contact me if you want more information about the changes to elm.

Xbuffy has been tested on
	SunOS 4.1.3
	Solaris 2.5
	Linux 2.X
	AIX 3.2.X
	AIX 4.X
	Irix 4.X
	Irix 5.X

Please e-mail all added features (and any problems you may have) to
wfp5p@virginia.EDU.

                                                         Brandon Long
							 blong@fiction.net
							 6/30/1998
							 Version: 3.3.bl.3


XBuffy - An Improved X Multibiff
================================

This is xbuffy, an X program designed to watch multiple mail folders for
new mail.  This version supports mbox/mh/maildir and "nntp" folders.

This is a modified version of xbuffy 3.3 by Bill Pemberton (wfp5p@virginia.edu).

Note that the rpm xbuffy-3.3-2 contains everything but the debian
bugfixes and debian xbuffy-3.3-1 doesn't have the atime and mdir
patches.

To build, just type:
  configure
  make

If you want to use nntp, use the --enable-nntp switch.  You might want
to set a default server by using --enable-nntp=<server name>.
The environment variable NNTPSERVER will always override the default.
Future versions will probably allow you to set the server in the boxfile
(after all, how else can you watch multiple news servers?)

If you want a "nicer" look, you can try an alternate widget set.  Most
non-linux people might want to try Motif, use the --with-motif option to
configure.  If you have an alternative Athena widget set installed, you
can use that.  Try --with-xaw3d, --with-xaw95 or --with-neXtaw.  If you
have linked an alternative Athena widget set to the libXaw shared
library, you don't need to specify a different set.

This version also includes LINUX specific LED blinking support if you
compile with --enable-led.  This compiles a separate program (led) which
must be installed suid root to access the LINUX console driver.  Xbuffy
will then recognize the boxfile command 'led' to blink one of the led's
on the keyboard to announce new mail.  LED support was provided by
Anders Johansson of Link�ping University <andersjo@lysator.liu.se>.

The standard thing to do is to create a boxfile (I usually use
~/.xbuffy) and place in it commands to watch your mail folders.
---- .xbuffy ------
box /var/mail/blong
title Incoming
polltime 5
headertime 0
audio cat /Archive/multimedia/sound/au/glass.au > /dev/audio
command xterm -fn 7x13 -title "Mutt Incoming" -e mutt &

box ~/Mail/received
title Received
headertime 0
command xterm -fn 7x13 -title "Mutt Received" -e mutt -f =received &

box ~/Mail/mutt
title Mutt
headertime 0
polltime 15
command xterm -fn 7x13 -title "Mutt Mutt" -e mutt -f =mutt &

box comp.mail.elm
newsbox
polltime 100
command xterm -fn 7x13 -title "Mutt comp.mail.elm" -e mutt -f "[news]comp.mail.elm" &
---------------------

Maildir/MH Notes:
------------------
You specify a maildir/mh folder by pointing "box" at the directory which
is the folder.

Normally, you can pick whether to show only the new messages or all of
the messages in the mailbox when you click the left button on the
mailbox button.  With maildir/mh folders, you only get the new messages
regardless of this setting.

This version of xbuffy makes the same assumptions that Mutt does about
these folders, namely that a Maildir folder is a directory with
subdirectories of cur, tmp, and new.  An MH folder is a directory with a
.xmhcache or .mh_sequences file in it.

Version Notes
--------------
 Version 3.3.bl.3:
  - Added support for LINUX console LED blinking on new mail from
    Anders Johansson of Link�ping University <andersjo@lysator.liu.se>.
  - Improvements to configure script for finding weird install places
    for X and Motif libraries.  If this doesn't find yours, you can
    still specify it with --with-motif=/path/to/motif.  Please mail me
    if you're system has it somewhere else.
  - Use the debian Xresources (XBuffy.ad), they're nicer

 Version 3.3.bl.2:
  - Added support for autoconf configuration to replace Imake
  - Suggestions/code from Ralf Hildebrandt (R.Hildebrandt@tu-bs.de)
    - Make main() return an int to keep the Xserver from complaining
    - some platforms (HP-UX 9.x) don't have utimes(), now use substitute
    - -center can cause coredump

 Version 3.3.bl.1:
  - xbuffy.time.patch by David DeSimone (fox@convex.hp.com)
    - no longer crashes if mailbox doesn't exist
    - alignment code bug
    - don't modify the access-time of mailboxes when checking them to
      allow other biff's to notice new mail as well
  - xbuffy.mdir.patch by Brandon Long (blong@fiction.net)
    - adds support for mh and maildir folders
  - xbuffy_3.3-1.diff debian patch by Joel Rosdahl
    - fixes a typo in the NNTP support
    - Removed a bit of NNTP correctness checking that caused problems
    - init NNTP boxes the same way you init MAIL boxes