wmmail-0.59
===========


  wmmail is a "mail-checker" like xbiff. It is largely based on asmail, but 
  has been modified to work with WindowMaker instead of AfterStep. See the 
  man page for more information.



INSTALLATION

  wmmail should compile on any X11R6 platform with the Shape extension
  and any recent revision of libXpm. You must be using WindowMaker as
  your window manager, and should have make(1) and imake(1) to build
  wmmail.

  To build and install wmmail, follow these steps:

    1. Unpack the wmmail package.

    2. If necessary, edit Imakefile so that it fits your system.

    3. Type "xmkmf", followed by "make" to build the binary.

    4. Type "make install" to install the binary to your X11 directory.
       You may need root access to do this.

    5. Type "make install.man" to install the man page to your X11
       directory. You may need root access to do this.

    6. Edit install.pixmaps to change the installation location (default
       is /usr/include/X11/pixmaps) as well as the installation program
       (default is /bin/install; an alternative is /bin/cp). Run the script
       (as root, if necessary) to install the graphics. You may also want to 
       copy the sample audio messages in the ./sounds sub-directory to a 
       suitable location on your system.

       NOTE: You can simply copy all the .xpm files under the ./pixmaps 
             sub-directory to a location of your liking. This is what the
             script does for you anyway.

    7. Copy "sample.wmmailrc" to "~/.wmmailrc" and edit the file so that it 
       fits your system. Read the man page for more information.

       NOTE: The syntax of .wmmailrc has changed! Please see CHANGES, and
             the blurb in sample.wmmailrc.

    8. Run wmmail, and drag its appicon to the WindowMaker Dock to dock it.
       Right-click on the back-plate of the appicon, and select "Autolaunch"
       so that it will be started automatically next time you log in.



TODO

  1. Use libPropList for configuration (if it doesn't add too much
     overhead). Implement GUI-based configuration, a la Attributes
     Editor of WindowMaker.

  2. Clean up the installation process, i.e. write a better Imakefile.

  3. Add support for checking POP3 and IMAP mailboxes, new articles on
     selected newsgroups, etc.

  4. Add XBuffy-like features.



COPYRIGHTS

  wmmail is based on asmail for the AfterStep window manager, copyright
  (c) 1996, 1997, 1998 by Per Liden. As of version 0.51, asmail has
  become GPL'ed software.

  All modifications made to asmail to make it work with WindowMaker are
  copyright (c) 1997, 1998 by Bryan Chan. wmmail is licensed through the
  GNU General Public License. Read COPYING for the complete license.

  The NeXT-lookalike XPM icons in ./pixmaps/NeXT are acquired from an
  asmail hack by Jon Leffert <jbleffer@midway.uchicago.edu>.

  The additional sounds in ./sounds/ are acquired from xbiff++, an 
  enhanced xbiff by Mike Wagner <wagner@cadillac.siemens.com> and
  Jamie Zawinski <jwz@netscape.com>.



CONTACTS

  asmail:   Per Liden
            per@rsn.hk-r.se
            http://www.rby.hk-r.se/~pt96pli/

  wmmail:   Bryan Chan
            scorpio@technojunkie.com
            http://shells.technojunkie.com/~scorpio/

