tools/mpack-1.6/README.mac

                    mpack/munpack version 1.5 for mac

Mpack and munpack are utilities for encoding and decoding
(respectively) binary files in MIME (Multipurpose Internet Mail
Extensions) format mail messages.  For compatibility with older forms
of transferring binary files, the munpack program can also decode
messages in split-uuencoded format.  The Macintosh version can also
decode messages in split-BinHex format.

The canonical FTP site for this software is ftp.andrew.cmu.edu:pub/mpack/
Binaries are no longer provided. The pc, os2, amiga and archimedes ports
have been removed. The mac version probably doesn't compile anymore, but
is still included (MacOS X users can use the unix version...)

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


Decoding MIME messages:

To decode a MIME message, first save it to a text file.  If possible,
save it with all headers included.  Mpack can decode some MIME files
when the headers are missing or incomplete, other files it cannot
decode without having the information in the headers.  In general,
messages which have a statement at the beginning that they are in MIME
format can be decoded without the headers.  Messages which have been
split into multiple parts generally require all headers in order to be
reassembled and decoded.

Some LAN-based mail systems and some mail providers (including America
Online, as of the writing of this document) place the mail headers at
the bottom of the message, instead of at the top of the message.  If
you are having problems decoding a MIME message on such a system, you
need to convert the mail back into the standard format by removing the
system's nonstandard headers and moving the standard Internet headers
to the top of the message (separated from the message body with a
blank line).

There must be exactly one message per file.  Mpack cannot deal with
multiple messages in a single file, to decode things correctly it must
know when one message ends and the next one begins.

The Macintosh version of mpack/munpack is a single standalone
application.  A text file may be decoded either by drag & drop, or by
choosing the "Decode Files..." item from the application's File menu.
Non-text files may be encoded either by drag & drop, or by choosing
the "Encode Files..." item from the application's File menu.

The Macintosh version of mpack/munpack supports the new MacMIME
standard (RFC 1740).  This allows cross-platform transport of
Macintosh files to any MIME-capable machine, and also preserves
Macintosh specific file attributes between two Macintoshes.  Mpack
will use MacMIME for any unrecognized Macintosh file, and regular MIME
for standard MIME types.

For more details and descriptions of the preferences, see the "Help
Using Mpack..." menu item in mpack which can be found under the help
menu in systems 7 and above, and under the apple menu in older
systems.

Reporting bugs:

Bugs and comments should be reported to mpack-bugs@andrew.cmu.edu.
When reporting bugs or other problems, please include the following
information:

  * The version number of Mpack
  * The platform (Unix, PC, OS/2, Mac, Amiga, Archimedes)
  * The EXACT output of any unsuccessful attempts.
  * If having a problem decoding, the first couple of lines
    of the input file.


Compilation:

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.

Mpack checks for the existence of "Internet Config", and if it is
available, mpack uses it to translate MIME types to and from Macintosh
type/creator codes.  Included is the file "macICglue.hqx" which is a
BinHex4 version of Internet Config's MPW object file library.  This
needs to be linked with the application.

Using mpack:

See the "Help Using Mpack..." menu item in the application.


Acknowledgements:

Written by John G. Myers, jgm+@cmu.edu

The mac version was written by Christopher J. Newman, chrisn+@cmu.edu

Send all bug reports to mpack-bugs@andrew.cmu.edu 

Thanks to Nathaniel Borenstein for testing early versions of mpack and
for making many helpful suggestions.


PGP signature:

The mpack 1.6 distribution is not pgp signed.

Legalese:

(C) Copyright 1993,1994 by Carnegie Mellon University
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 Carnegie Mellon
University not be used in advertising or publicity pertaining to
distribution of the software without specific, written prior
permission.  Carnegie Mellon University makes no representations about
the suitability of this software for any purpose.  It is provided "as
is" without express or implied warranty.

CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO
THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY 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.

1	edhill	1.1	mpack/munpack version 1.5 for mac
2
3			Mpack and munpack are utilities for encoding and decoding
4			(respectively) binary files in MIME (Multipurpose Internet Mail
5			Extensions) format mail messages. For compatibility with older forms
6			of transferring binary files, the munpack program can also decode
7			messages in split-uuencoded format. The Macintosh version can also
8			decode messages in split-BinHex format.
9
10			The canonical FTP site for this software is ftp.andrew.cmu.edu:pub/mpack/
11			Binaries are no longer provided. The pc, os2, amiga and archimedes ports
12			have been removed. The mac version probably doesn't compile anymore, but
13			is still included (MacOS X users can use the unix version...)
14
15			This MIME implementation is intended to be as simple and portable as
16			possible. For a slightly more sophisticated MIME implementation, see
17			the program MetaMail, available via anonymous FTP to
18			thumper.bellcore.com, in directory pub/nsb
19
20
21			Decoding MIME messages:
22
23			To decode a MIME message, first save it to a text file. If possible,
24			save it with all headers included. Mpack can decode some MIME files
25			when the headers are missing or incomplete, other files it cannot
26			decode without having the information in the headers. In general,
27			messages which have a statement at the beginning that they are in MIME
28			format can be decoded without the headers. Messages which have been
29			split into multiple parts generally require all headers in order to be
30			reassembled and decoded.
31
32			Some LAN-based mail systems and some mail providers (including America
33			Online, as of the writing of this document) place the mail headers at
34			the bottom of the message, instead of at the top of the message. If
35			you are having problems decoding a MIME message on such a system, you
36			need to convert the mail back into the standard format by removing the
37			system's nonstandard headers and moving the standard Internet headers
38			to the top of the message (separated from the message body with a
39			blank line).
40
41			There must be exactly one message per file. Mpack cannot deal with
42			multiple messages in a single file, to decode things correctly it must
43			know when one message ends and the next one begins.
44
45			The Macintosh version of mpack/munpack is a single standalone
46			application. A text file may be decoded either by drag & drop, or by
47			choosing the "Decode Files..." item from the application's File menu.
48			Non-text files may be encoded either by drag & drop, or by choosing
49			the "Encode Files..." item from the application's File menu.
50
51			The Macintosh version of mpack/munpack supports the new MacMIME
52			standard (RFC 1740). This allows cross-platform transport of
53			Macintosh files to any MIME-capable machine, and also preserves
54			Macintosh specific file attributes between two Macintoshes. Mpack
55			will use MacMIME for any unrecognized Macintosh file, and regular MIME
56			for standard MIME types.
57
58			For more details and descriptions of the preferences, see the "Help
59			Using Mpack..." menu item in mpack which can be found under the help
60			menu in systems 7 and above, and under the apple menu in older
61			systems.
62
63			Reporting bugs:
64
65			Bugs and comments should be reported to mpack-bugs@andrew.cmu.edu.
66			When reporting bugs or other problems, please include the following
67			information:
68
69			* The version number of Mpack
70			* The platform (Unix, PC, OS/2, Mac, Amiga, Archimedes)
71			* The EXACT output of any unsuccessful attempts.
72			* If having a problem decoding, the first couple of lines
73			of the input file.
74
75
76			Compilation:
77
78			Mpack was compiled with THINK C 6.0 with the 4-byte int option turned
79			on (and the ANSI-small library compiled with the 4-byte int option)
80			and prototype enforcement turned off. Included with this distribution
81			should be the files "macproj.hqx" which is a BinHex4 version of the
82			THINK C 6.0 project file, and "macrsrc.hqx" which is a BinHex4 version
83			of the resources file.
84
85			Mpack checks for the existence of "Internet Config", and if it is
86			available, mpack uses it to translate MIME types to and from Macintosh
87			type/creator codes. Included is the file "macICglue.hqx" which is a
88			BinHex4 version of Internet Config's MPW object file library. This
89			needs to be linked with the application.
90
91			Using mpack:
92
93			See the "Help Using Mpack..." menu item in the application.
94
95
96			Acknowledgements:
97
98			Written by John G. Myers, jgm+@cmu.edu
99
100			The mac version was written by Christopher J. Newman, chrisn+@cmu.edu
101
102			Send all bug reports to mpack-bugs@andrew.cmu.edu
103
104			Thanks to Nathaniel Borenstein for testing early versions of mpack and
105			for making many helpful suggestions.
106
107
108			PGP signature:
109
110			The mpack 1.6 distribution is not pgp signed.
111
112			Legalese:
113
114			(C) Copyright 1993,1994 by Carnegie Mellon University
115			All Rights Reserved.
116
117			Permission to use, copy, modify, distribute, and sell this software
118			and its documentation for any purpose is hereby granted without fee,
119			provided that the above copyright notice appear in all copies and that
120			both that copyright notice and this permission notice appear in
121			supporting documentation, and that the name of Carnegie Mellon
122			University not be used in advertising or publicity pertaining to
123			distribution of the software without specific, written prior
124			permission. Carnegie Mellon University makes no representations about
125			the suitability of this software for any purpose. It is provided "as
126			is" without express or implied warranty.
127
128			CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO
129			THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
130			AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE
131			FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
132			WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
133			AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
134			OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
135			SOFTWARE.
136
137			Portions of this software are derived from code written by Bell
138			Communications Research, Inc. (Bellcore) and by RSA Data Security,
139			Inc. and bear similar copyrights and disclaimers of warranty.
140