        mailapp-utilities 2.4p1				1999/09/03
        =====================

This is the fourteenth release of the Mail.app utilities.
For a list of changes see the end of this file.

The archive contains some command line tools useful in conjunction
with NeXT's Mail.app, Apple's MailViewer.app, and other mailer
applications that use the Mail.app .mbox mailbox format.

`mailto' (previously `nextmail') has a command line interface similar
to UCB mail but instead of sending the letter it puts it in a Mail.app
compose window.  `appnmail' appends messages to the end of Mail.app
mailboxes while taking care to properly handle locks, NeXT mail and
the table of contents.  `compactmail' compacts Mail.app mailboxes just
like the Compact menu item does.  (In addition, there is also a small
utility called `listmail' which lists Mail.app table_of_contents.  This
is a minor program created mainly for my own debugging, but as it may
come in handy for others it is part of this package as well.)

There are also three other files in this package. `Sendmail-addheadsig'
will automatically add headers, ASCII signatures or even RTF or RTFD
signatures to your outgoing Mail.app letters.  After installation,
change the Mail.app "Mailer" expert preference to point to the
location of this script (/usr/local/lib/sendmail-addheadsig by
default) and all the lines in your ~/.add-header files will be added
to the header, the ASCII text of ~/.signature will be added at the end
of outgoing non-NeXTmail messages and the contents of
~/.signature.rtfd (and if that doesn't exist, ~/.signature.rtf) will
be added to the end of outgoing NeXTmail messages.  This allows you
e.g. to automatically add your own TIFF picture or digitized real
signature to all NeXTmail you send.
[maintainer's note: for Mail.app 3.3 and 4.x, roughly equivalent
functionality is available in the EnhanceMail bundle, of the same
author.  NB. this has not yet been ported to Rhapsody/MacOSXS.]

`Sendmail-remote' is installed just like sendmail-addheadsig is.  It
will cause Mail.app to run sendmail on another machine.  This may not
be widely useful but in some situations it is invaluable.

There is also an emacs-lisp program called `gnus-mailapp.el'.  It will
integrate Mail.app with GNUS to the same degree Mail.app is integrated
with NewsGrazer.  For instructions on how to enable its features, read
the comments at the beginning of gnus-mailapp.el.  `MyMail.ts' is a set
of TickleServices (for use with Scott Hess' TickleServices.app) which
make use of the mailapp utilities.
[maintainer's note: this seems to predate, and offer less functionality,
than the Mail.ts shipped with TickleServices 1.11.]

All have only been tested under NeXTStep 3.[0123], OPENSTEP/Mach 4.[012],
Rhapsody DR2 and MacOS X Server 1.1,
but for all but `mailto' no reason to assume that they won't also work
under earlier versions of the operating system.  For more detail see the
included man pages.

Personally I use `appnmail' in conjunction with `procmail' which makes a
very powerful combination for handling incoming mail.  `mailto'/`nextmail'
(together with a number of elisp functions also included in this
archive) causes all mail which I would send from within emacs (such as
replies to articles read in GNUS) to be redirected through Mail.app,
though many other uses are imaginable as well.  `Compactmail' was
created to help all the people screaming about the lack of an
autocompact feature in Mail.app.

Installation should be no problem: just install mailapp-utilities.pkg
using Installer.app.

The utilities can now be compiled under OS/4.x, but they will start up
a lot faster when compiled for NS/3.x.

This is the first release to run on MacOS X Server (1.1).
To compile it on MacOS X Server, use "make TARGET=MACOSX".


If you find any bugs or have any problems feel free to email me.


    Current maintainer (as of 1.6):

        Tom Hageman

    --> Please send your comments, bugreports etc. to:

            <mailapp-utilities@basil.icce.rug.nl>


    Original author:

	Carl Edman <e-mail address withheld at his request>


        CHANGES
        =======

2.4 to 2.4p1

* Re-packaged for MacOS X Server.

2.3 to 2.4

* Emergency release, adds support for new mailbox table-of-contents format in
  MacOS X Server.  NB. This breaks support for RDR2 (whose mailbox format was
  broken in the first place, in the sense that it was not backward-compatible
  with NEXTSTEP mailboxes.  The introduction of a new magic number in
  MacOS X Server for the new format restores this backward-compatibility.)
<RANT>
  But Apple *should* have done the right thing and used a Unicode-preserving
  encoding like UTF8 or non-lossy ASCII in its new table-of-contents format,
  instead of Mac-Roman. (yet another western-language oriented 8-bit encoding,
  slightly different but essentially similar to the original NEXTSTEP encoding.
  Is _this_ Thinking Different? }->)
</RANT>

* appnmail: `-M', `-N' options now merely determine the default format
  of newly created mailboxes -- the format is auto-detected for existing
  mailboxes.

* appnmail: add rudimentary support for (MacOSXS) HTML-type flag.


2.2 to 2.3:

* all utilities now handle GNU-style `--help', `--version' options.

* appnmail: add rudimental utf-8 encoding support.

* appnmail: [MacOSXS port] workaround missing `decode' utility, necessary
  for handling NeXTmail messages.  NB. `uudecode-filter' should be
  installed in /usr/local/lib for this to work.

* appnmail: new option `-D sec', for mailbox incorporation delay.

* compactmail: bugfix: avoid creating empty .mbox if it does not exist.

* mailto: renamed from `nextmail' (actually, just a symlink for now.)
  Unlike `nextmail', opening the message in a compose window is the
  default for `mailto'.  Use new `-d' option to deliver instead.

* mailto: new options `-b bcc-users', `-d', `-m mailer', `-v'.
  
* mailto: add support for alternative mailers other than Mail(Viewer).app:
  currently PopOver is supported (OPENSTEP/MacOSXS only) -- I hope to make
  this extensible by supporting loadable bundles in the future.
  (On NEXTSTEP/OPENSTEP, Eloquent and Mynah allegedly implement the same
   speaker/listener protocol as Mail.app, and should also work.)

* mailto: make mailer application active, to bring its compose window to
  the foreground.

* bugfix in mailtoc to avoid potential crash when reading corrupted mailbox.

* MailProxy is now a class cluster, to better separate system-dependent
  code and make adding support for additional mailers easier.

* MailProxy: allow arbitrary headers (for mailers that support it).


A log of earlier changes can be found in the file HISTORY in the
mailapp-utilities distribution.
