/[MITgcm]/MITgcm/tools/mpack-1.6/README.mac
ViewVC logotype

Contents of /MITgcm/tools/mpack-1.6/README.mac

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph


Revision 1.2 - (show annotations) (download)
Mon Mar 15 22:02:49 2004 UTC (20 years ago) by edhill
Branch: MAIN
CVS Tags: checkpoint58l_post, checkpoint57t_post, checkpoint57o_post, checkpoint58e_post, mitgcm_mapl_00, checkpoint52n_post, checkpoint53d_post, checkpoint58u_post, checkpoint58w_post, checkpoint54a_pre, checkpoint57m_post, checkpoint55c_post, checkpoint54e_post, checkpoint57s_post, checkpoint54a_post, checkpoint53c_post, checkpoint57k_post, checkpoint55d_pre, checkpoint57d_post, checkpoint57g_post, checkpoint57b_post, checkpoint57c_pre, checkpoint58r_post, checkpoint55j_post, checkpoint56b_post, checkpoint57i_post, checkpoint57y_post, checkpoint57e_post, checkpoint55h_post, checkpoint58n_post, checkpoint53b_post, checkpoint58x_post, checkpoint57g_pre, checkpoint54b_post, checkpoint53b_pre, checkpoint55b_post, checkpoint58t_post, checkpoint58h_post, checkpoint54d_post, checkpoint56c_post, checkpoint52m_post, checkpoint57y_pre, checkpoint55, checkpoint53a_post, checkpoint57f_pre, checkpoint57a_post, checkpoint54, checkpoint58q_post, checkpoint54f_post, checkpoint57v_post, checkpoint55g_post, checkpoint58j_post, checkpoint59e, checkpoint59d, checkpoint59g, checkpoint59f, checkpoint59a, checkpoint55f_post, checkpoint59c, checkpoint59b, checkpoint59m, checkpoint59l, checkpoint59n, checkpoint59i, checkpoint59h, checkpoint59k, checkpoint59j, checkpoint57r_post, checkpoint59, checkpoint58, checkpoint57a_pre, checkpoint55i_post, checkpoint57, checkpoint56, checkpoint53, eckpoint57e_pre, checkpoint57h_done, checkpoint58f_post, checkpoint53g_post, checkpoint57x_post, checkpoint57n_post, checkpoint58d_post, checkpoint58c_post, checkpoint57w_post, checkpoint57p_post, checkpint57u_post, checkpoint57f_post, checkpoint58a_post, checkpoint58i_post, checkpoint57q_post, checkpoint58g_post, checkpoint58o_post, checkpoint57z_post, checkpoint57c_post, checkpoint58y_post, checkpoint55e_post, checkpoint58k_post, checkpoint58v_post, checkpoint53f_post, checkpoint55a_post, checkpoint53d_pre, checkpoint54c_post, checkpoint58s_post, checkpoint58p_post, checkpoint57j_post, checkpoint58b_post, checkpoint57h_pre, checkpoint58m_post, checkpoint57l_post, checkpoint57h_post, checkpoint56a_post, checkpoint55d_post
Changes since 1.1: +1 -0 lines
 o small edit

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

  ViewVC Help
Powered by ViewVC 1.1.22