<<Jared notes: When my local net server switched to Base 64 encoding
of files a few days ago, I went looking for MIME encoders. The UUE
functions have been with ZR since version 6.0, so it is fitting that
MIME gets added at 6.5. For those who do not know, it is like UUE
encoding so you can mail files over the Internet, but harder to 
come by a good one because it is newer. These guys have made the
best one by far out of the ones I have seen, I looked through several
freeware ones which allow dual distribution. They don't ask for any-
thing except credit, which if you like this feature, is all the more
reason to send them a few bucks for it.
  I may switch to proprietary (done by me) uue/mimeing, if I ever can
get around to it, 'til then freeware ones like this do the job well,
and if you use DOS a lot, its like getting 2 programs for the price
of one, well worth keeping them on your drive for awhile. This is
their readme file they like to have included so I am putting it front
and center as they really deserve a lot of applause because this one
is tops in my book. Setup.exe will auto-installs them into \windows.
   You don't NEED to know any of these commands as I have automated
them in my program, but knowing how to do it in DOS is handy.>>



		      mpack/munpack version 1.4

Mpack and munpack are utilities for encoding and decoding
(respectively) binary files in MIME (Multipurpose Internet Mail
Extensions) format mail messages.  For compabibility with older forms
of transferring binary files, the munpack program can also decode
messages in split-uuencoded format.  The mac version can also decode
messages in split-BinHex format.

Versions are included for unix, pc, mac and amiga systems.  The
canonical FTP site for this software is ftp.andrew.cmu.edu:pub/mpack/

This MIME implementation is intended to be as simple and portable as
possible.  For a slightly more sophisticated MIME implementation, see
the program MetaMail, available via anonymous FTP to
thumper.bellcore.com, in directory pub/nsb


Compilation:

[unix version]

If compiling on SunOS, SVR4, SCO Unix, or an ancient BSD without the
strchr() function, edit the Makefile and uncomment the relevant lines.

Compile with the "make" command. Install with 
"make install DESTDIR=/installation/path".  The default value of
DESTDIR is "/usr/local", which installs the programs in /usr/local/bin
and the man pages in /usr/local/man/man1.

[pc version]

The pc sources have been compiled with Microsoft C version 7.0. 

[amiga version]

The amiga sources have been compiled with SAS/C version 6.3. To compile
with SAS/C, use the command "smake".

[mac version]

Mpack was compiled with THINK C 6.0 with the 4-byte int option turned
on (and the ANSI-small library compiled with the 4-byte int option)
and prototype enforcement turned off.  Included with this distribution
should be the files "macproj.hqx" which is a BinHex4 version of the
THINK C 6.0 project file, and "macrsrc.hqx" which is a BinHex4 version
of the resources file.

If you wish to compile this with a different version of the THINK C
compiler, you must turn on 4-byte ints when compiling the ANSI library
and the source code.  If you wish to use MPW or some other compiler
you will probably have to add additional #include statements for the
appropriate Macintosh interface headers.


Using the mac version:

See the "Help..." menu item in the application.


Using mpack: [unix, pc and amiga versions]

Mpack is used to encode a file in one or more MIME format messages.
The program is invoked with:

	mpack [options] -o outputfile file

Where "[options]" is one or more optional switches described below.
"file" is the name of the file to encode and "-o outputfile" is
described below.

The unix version may also be invoked with either:

	mpack [options] file address...

or

	mpack [options] -n newsgroups file

Where "address..." is one or more e-mail address to mail the resulting
messages to and "newsgroups" is a comma-separated list of newsgroups
to post the resulting messages to.

The amiga version may be invoked identically to the Unix version.
There is extra flexibility in the options and addresses.  Use "mpack
?" for a list of options; a second "?" will print more information.
AmigaDOS 2.0 or later is required to run mpack.

The possible options are:

     -s subject
          Set the Subject header field to Subject.   By default,
          mpack will prompt for the contents of the subject
          header.

     -d descriptionfile
          Include the contents of the file descriptionfile in an
          introductory section at the beginning of the first
          generated message.

     -m maxsize
          Split the message (if necessary) into partial messages,
          each not exceeding maxsize characters.  The default
          limit is the value of the SPLITSIZE environment 
	  variable, or no limit if the environment variable
          does not exist.  Specifying a maxsize of 0 means there
          is no limit to the size of the generated message.

     -c content-type
          Label the included file as being of MIME type
          content-type, which must be a subtype of application,
          audio, image, or video.  If this switch is not given,
          mpack examines the file to determine its type.

     -o outputfile
          Write the generated message to the file outputfile.  If
          the message has to be split, the partial messages will
          instead be written to the files outputfile.01,
          outputfile.02, etc.


The environment variables which control mpack's behavior are:

     SPLITSIZE
          Default value of the -m switch.  Default "0".

     TMPDIR        [unix version only]
	  Directory to store temporary files.  Default "/tmp".

     HOSTNAME      [pc and amiga versions only]
          Fully qualified domain name to use in generated message-ids.
	  Default "random-pc" or "random-maiga".

     DOMAINNAME    [amiga version only]
          If $HOSTNAME does not have a '.' in it, this is appended to
          $HOSTNAME to get the domain to use. Default is
          "random-domain".

     POSTNEWS	   [amiga version only]
	  Command to use to post news. Compatible with Dillon UUCP usage.

     SENDMAIL	   [amiga version only]
	  Command to use to send mail. Compatible with Dillon UUCP usage.
	   

Using munpack:

Mpack is used to decode one or more messages in MIME or
split-uuencoded format and extract the embedded files.  The program is
invoked with:

	munpack [options] filename...

which reads the messages in the files "filename...".  The pc version
does accept wildcards.  Munpack may also be invoked with just:

	munpack [options]

which reads a message from the standard input.

The amiga version does not accept wildcards. Under AmigaDOS prior to
2.0, only filenames are allowed. Under AmigaDOS 2.0 or later, the Unix
options are supported, with extra flexibility. Use "munpack ?" for a
list of options; a second "?" will print more information.

If the message suggests a file name to use for the imbedded part, that
name is cleaned of potential problem characters and used for the
output file.  If the suggested filename includes subdirectories, they
will be created as necessary.  If the message does not suggest a file
name, the names "part01", "part02", etc are used in sequence.

If the imbedded part was preceded with textual information, that
information is also written to a file. The file is named the same as
the imbedded part, with any filename extension replaced with ".desc"
on the unix version or with ".dsc" on the pc version.

The possible options are:

     -f
          Forces the overwriting of existing files.  If a message
          suggests a file name of an existing file, the file will be
          overwritten.  Without this flag, the unix version appends
          ".1", ".2", etc to find a nonexistent file.  Without this
          flag, the pc version replaces any filename extension with
          ".1", ".2", etc to find a nonexistent file.

     -t
	  Also unpack the text parts of multipart messages to files.
	  By default, text parts that do not have a filename parameter
	  do not get unpacked.

     -q
          Be quiet--suppress messages about saving partial messages.

     -C directory
          Change the current directory to "directory" before reading
          any files.  This is useful when invoking munpack
          from a mail or news reader.

The environment variables which control munpack's behavior are:

     TMPDIR	[unix version]
          Root of directory to store partial messages awaiting 
          reassembly.  Default is "/tmp".   Partial messages are
	  stored in subdirectories of $TMPDIR/message-parts-$USER/

     TMP	[pc version]
          Root of directory to store partial messages awaiting
          reassembly.  Default is "\tmp".  Partial messages are
          stored in subdirectories of $TMP/parts/

     METAMAIL_P_DIR [amiga version only]
          Root of directory to store partial messages awaiting 
          reassembly.  Default is "t:".   Partial messages are
	  stored in subdirectories of METAMAIL_P_DIR.

     USER, USERNAME [amiga version only]
	 Subdirectory of METMAIL_P_DIR where mime parts are stored. USER
	 is checked first, then USERNAME. Default "anonymous".
          

Special note on environment variables in the amiga version. If the
shared library netsupport.library is available, it will be used to get
the value of the environment variables. This allows them to be set in
uulib:config file instead of in the environment. If this library not
present, then a warning that the library was not found is printed. You
may ignore this warning.

Acknowledgements:

Written by John G. Myers, jgm+@cmu.edu
The mac version was written by Christopher J. Newman, chrisn+@cmu.edu
The amiga port was done by Mike W. Meyer, mwm@contessa.phone.net.

Thanks to Nathaniel Borenstein for testing early versions of mpack and
for making many helpful suggestions.


Reporting bugs:

Bugs and comments should be reported to jgm+@cmu.edu.  Please include
the version number and the platform in the report.


Legalese:

(C) Copyright 1993 by John G. Myers and Christopher J. Newman
All Rights Reserved.

Permission to use, copy, modify, distribute, and sell this software
and its documentation for any purpose is hereby granted without fee,
provided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in
supporting documentation, and that the name of John G. Myers or
Christopher J. Newman not be used in advertising or publicity
pertaining to distribution of the software without specific, written
prior permission.  John G.  Myers and Christopher J. Newman make no
representations about the suitability of this software for any
purpose.  It is provided "as is" without express or implied warranty.

JOHN G. MYERS AND CHRISTOPHER J. NEWMAN DISCLAIM ALL WARRANTIES WITH
REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL JOHN G. MYERS OR
CHRISTOPHER J. NEWMAN BE LIABLE FOR ANY SPECIAL, INDIRECT OR
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.


Portions of this software are derived from code written by Bell
Communications Research, Inc. (Bellcore) and by RSA Data Security,
Inc. and bear similar copyrights and disclaimers of warranty.