Warning, /tools/mpack-1.6/README.mac is written in an unsupported language. File is not indexed.
view on githubraw file Latest commit e768bd12 on 2008-02-26 17:05:00 UTC
ec6cf3b09d Ed H*0001 mpack/munpack version 1.5 for mac
0002
0003 Mpack and munpack are utilities for encoding and decoding
0004 (respectively) binary files in MIME (Multipurpose Internet Mail
0005 Extensions) format mail messages. For compatibility with older forms
0006 of transferring binary files, the munpack program can also decode
0007 messages in split-uuencoded format. The Macintosh version can also
0008 decode messages in split-BinHex format.
0009
0010 The canonical FTP site for this software is ftp.andrew.cmu.edu:pub/mpack/
0011 Binaries are no longer provided. The pc, os2, amiga and archimedes ports
0012 have been removed. The mac version probably doesn't compile anymore, but
0013 is still included (MacOS X users can use the unix version...)
0014
0015 This MIME implementation is intended to be as simple and portable as
0016 possible. For a slightly more sophisticated MIME implementation, see
0017 the program MetaMail, available via anonymous FTP to
0018 thumper.bellcore.com, in directory pub/nsb
0019
0020
0021 Decoding MIME messages:
0022
0023 To decode a MIME message, first save it to a text file. If possible,
0024 save it with all headers included. Mpack can decode some MIME files
0025 when the headers are missing or incomplete, other files it cannot
0026 decode without having the information in the headers. In general,
0027 messages which have a statement at the beginning that they are in MIME
0028 format can be decoded without the headers. Messages which have been
0029 split into multiple parts generally require all headers in order to be
0030 reassembled and decoded.
0031
0032 Some LAN-based mail systems and some mail providers (including America
0033 Online, as of the writing of this document) place the mail headers at
0034 the bottom of the message, instead of at the top of the message. If
0035 you are having problems decoding a MIME message on such a system, you
0036 need to convert the mail back into the standard format by removing the
0037 system's nonstandard headers and moving the standard Internet headers
0038 to the top of the message (separated from the message body with a
0039 blank line).
0040
0041 There must be exactly one message per file. Mpack cannot deal with
0042 multiple messages in a single file, to decode things correctly it must
0043 know when one message ends and the next one begins.
0044
0045 The Macintosh version of mpack/munpack is a single standalone
0046 application. A text file may be decoded either by drag & drop, or by
0047 choosing the "Decode Files..." item from the application's File menu.
0048 Non-text files may be encoded either by drag & drop, or by choosing
0049 the "Encode Files..." item from the application's File menu.
0050
0051 The Macintosh version of mpack/munpack supports the new MacMIME
0052 standard (RFC 1740). This allows cross-platform transport of
0053 Macintosh files to any MIME-capable machine, and also preserves
0054 Macintosh specific file attributes between two Macintoshes. Mpack
0055 will use MacMIME for any unrecognized Macintosh file, and regular MIME
0056 for standard MIME types.
0057
0058 For more details and descriptions of the preferences, see the "Help
0059 Using Mpack..." menu item in mpack which can be found under the help
0060 menu in systems 7 and above, and under the apple menu in older
0061 systems.
0062
0063 Reporting bugs:
0064
0065 Bugs and comments should be reported to mpack-bugs@andrew.cmu.edu.
0066 When reporting bugs or other problems, please include the following
0067 information:
0068
0069 * The version number of Mpack
0070 * The platform (Unix, PC, OS/2, Mac, Amiga, Archimedes)
0071 * The EXACT output of any unsuccessful attempts.
0072 * If having a problem decoding, the first couple of lines
0073 of the input file.
0074
0075
0076 Compilation:
0077
0078 Mpack was compiled with THINK C 6.0 with the 4-byte int option turned
0079 on (and the ANSI-small library compiled with the 4-byte int option)
0080 and prototype enforcement turned off. Included with this distribution
0081 should be the files "macproj.hqx" which is a BinHex4 version of the
0082 THINK C 6.0 project file, and "macrsrc.hqx" which is a BinHex4 version
0083 of the resources file.
0084
0085 Mpack checks for the existence of "Internet Config", and if it is
0086 available, mpack uses it to translate MIME types to and from Macintosh
0087 type/creator codes. Included is the file "macICglue.hqx" which is a
0088 BinHex4 version of Internet Config's MPW object file library. This
0089 needs to be linked with the application.
0090
0091 Using mpack:
0092
0093 See the "Help Using Mpack..." menu item in the application.
0094
0095
0096 Acknowledgements:
0097
0098 Written by John G. Myers, jgm+@cmu.edu
0099
0100 The mac version was written by Christopher J. Newman, chrisn+@cmu.edu
0101
0102 Send all bug reports to mpack-bugs@andrew.cmu.edu
0103
0104 Thanks to Nathaniel Borenstein for testing early versions of mpack and
0105 for making many helpful suggestions.
0106
0107
0108 PGP signature:
0109
0110 The mpack 1.6 distribution is not pgp signed.
0111
0112 Legalese:
0113
0114 (C) Copyright 1993,1994 by Carnegie Mellon University
0115 All Rights Reserved.
0116
0117 Permission to use, copy, modify, distribute, and sell this software
0118 and its documentation for any purpose is hereby granted without fee,
0119 provided that the above copyright notice appear in all copies and that
0120 both that copyright notice and this permission notice appear in
0121 supporting documentation, and that the name of Carnegie Mellon
0122 University not be used in advertising or publicity pertaining to
0123 distribution of the software without specific, written prior
0124 permission. Carnegie Mellon University makes no representations about
0125 the suitability of this software for any purpose. It is provided "as
0126 is" without express or implied warranty.
0127
0128 CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO
0129 THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
0130 AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE
0131 FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
0132 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
0133 AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
0134 OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
0135 SOFTWARE.
0136
0137 Portions of this software are derived from code written by Bell
0138 Communications Research, Inc. (Bellcore) and by RSA Data Security,
0139 Inc. and bear similar copyrights and disclaimers of warranty.
0140
