home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 28 / amigaformatcd28.iso / -seriously_amiga- / archivers / mpackppc-wos / src / readme.mac < prev    next >
Text File  |  1998-04-27  |  10KB  |  219 lines
  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. Versions are included for unix, pc, os2, mac, amiga and archimedes
  11. systems.  The canonical FTP site for this software is
  12. ftp.andrew.cmu.edu:pub/mpack/
  13.  
  14. This MIME implementation is intended to be as simple and portable as
  15. possible.  For a slightly more sophisticated MIME implementation, see
  16. the program MetaMail, available via anonymous FTP to
  17. thumper.bellcore.com, in directory pub/nsb
  18.  
  19.  
  20. Decoding MIME messages:
  21.  
  22. To decode a MIME message, first save it to a text file.  If possible,
  23. save it with all headers included.  Mpack can decode some MIME files
  24. when the headers are missing or incomplete, other files it cannot
  25. decode without having the information in the headers.  In general,
  26. messages which have a statement at the beginning that they are in MIME
  27. format can be decoded without the headers.  Messages which have been
  28. split into multiple parts generally require all headers in order to be
  29. reassembled and decoded.
  30.  
  31. Some LAN-based mail systems and some mail providers (including America
  32. Online, as of the writing of this document) place the mail headers at
  33. the bottom of the message, instead of at the top of the message.  If
  34. you are having problems decoding a MIME message on such a system, you
  35. need to convert the mail back into the standard format by removing the
  36. system's nonstandard headers and moving the standard Internet headers
  37. to the top of the message (separated from the message body with a
  38. blank line).
  39.  
  40. There must be exactly one message per file.  Mpack cannot deal with
  41. multiple messages in a single file, to decode things correctly it must
  42. know when one message ends and the next one begins.
  43.  
  44. The Macintosh version of mpack/munpack is a single standalone
  45. application.  A text file may be decoded either by drag & drop, or by
  46. choosing the "Decode Files..." item from the application's File menu.
  47. Non-text files may be encoded either by drag & drop, or by choosing
  48. the "Encode Files..." item from the application's File menu.
  49.  
  50. The Macintosh version of mpack/munpack supports the new MacMIME
  51. standard (RFC 1740).  This allows cross-platform transport of
  52. Macintosh files to any MIME-capable machine, and also preserves
  53. Macintosh specific file attributes between two Macintoshes.  Mpack
  54. will use MacMIME for any unrecognized Macintosh file, and regular MIME
  55. for standard MIME types.
  56.  
  57. For more details and descriptions of the preferences, see the "Help
  58. Using Mpack..." menu item in mpack which can be found under the help
  59. menu in systems 7 and above, and under the apple menu in older
  60. systems.
  61.  
  62. Reporting bugs:
  63.  
  64. Bugs and comments should be reported to mpack-bugs@andrew.cmu.edu.
  65. When reporting bugs or other problems, please include the following
  66. information:
  67.  
  68.   * The version number of Mpack
  69.   * The platform (Unix, PC, OS/2, Mac, Amiga, Archimedes)
  70.   * The EXACT output of any unsuccessful attempts.
  71.   * If having a problem decoding, the first couple of lines
  72.     of the input file.
  73.  
  74.  
  75. Compilation:
  76.  
  77. Mpack was compiled with THINK C 6.0 with the 4-byte int option turned
  78. on (and the ANSI-small library compiled with the 4-byte int option)
  79. and prototype enforcement turned off.  Included with this distribution
  80. should be the files "macproj.hqx" which is a BinHex4 version of the
  81. THINK C 6.0 project file, and "macrsrc.hqx" which is a BinHex4 version
  82. of the resources file.
  83.  
  84. Mpack checks for the existence of "Internet Config", and if it is
  85. available, mpack uses it to translate MIME types to and from Macintosh
  86. type/creator codes.  Included is the file "macICglue.hqx" which is a
  87. BinHex4 version of Internet Config's MPW object file library.  This
  88. needs to be linked with the application.
  89.  
  90. Using mpack:
  91.  
  92. See the "Help Using Mpack..." menu item in the application.
  93.  
  94.  
  95. Acknowledgements:
  96.  
  97. Written by John G. Myers, jgm+@cmu.edu
  98.  
  99. The mac version was written by Christopher J. Newman, chrisn+@cmu.edu
  100.  
  101. The amiga port was done by Mike W. Meyer, mwm@contessa.phone.net and
  102. Peter Simons, simons@peti.GUN.de
  103.  
  104. The os2 port was done by Jochen Friedrich, jochen@audio.pfalz.de
  105.  
  106. The archimedes port was done by Olly Betts, olly@mantis.co.uk
  107.  
  108. Send all bug reports to mpack-bugs@andrew.cmu.edu 
  109.  
  110. Thanks to Nathaniel Borenstein for testing early versions of mpack and
  111. for making many helpful suggestions.
  112.  
  113.  
  114. PGP signature:
  115.  
  116. Starting with version 1.5, all official mpack distributions are PGP
  117. signed by "John Gardiner Myers <jgm+@cmu.edu>".  The PGP signatures
  118. are detached from the distributions themselves, in files with the
  119. ".asc" filename extension.  If the location where you obtained mpack
  120. does not include the PGP signature, or if the signature is not valid
  121. for the distribution, please complain to the maintainer of the
  122. relevant distribution site.
  123.  
  124. A valid PGP signature indicates that the distribution is the one that
  125. I put together; it specifically does not indicate any warranty of any
  126. kind on the software.  The Unix and DOS versions were done by myself,
  127. the DOS binaries were checked for viruses using an up-to-date virus
  128. checker.  The Macintosh version was done by a colleague I have reason
  129. to trust.  All other versions were done and compiled by people I have
  130. had no personal contact with.
  131.  
  132. My PGP public key follows:
  133.  
  134. -----BEGIN PGP PUBLIC KEY BLOCK-----
  135. Version: 2.6.1
  136.  
  137. mQBtAi5Sd2AAAAEDANBa5/iCcCUkCsDtSpWIKfwEhqAFOoIE61j7Q/Q+mdU4V/BK
  138. ttboCOk9ZDtGKYhMFvH31I7bAECruV1GIa/awbfI0EMfZwQ+U0YhOUScXfm2ARIv
  139. XotV0HJqmwnIWCbPjQAFEbQiSm9obiBHYXJkaW5lciBNeWVycyA8amdtK0BjbXUu
  140. ZWR1PokAlQMFEC77TI7FLUdtDb+QbQEBhMcD/1gmEtykw84iYmo9TjlCg8hfzqJs
  141. /TvRlUKoNF3oGG7M9h4zmP1AwL75B2/k3UnD39LsTc15J4ZWbH/VwVWPT73rRBwD
  142. hGS33ep1JAP1koB3f1RIjZ3jrRSbdVt45W2l1A+aAPP8oHs7Uf+eSINx7DA6THuu
  143. W14BeJyVu9acBKuriQCVAgUQLvs8nVsjC0SkKFUJAQHbFwP9Gzb+p3z73o6p4A9k
  144. 5xqwr8WpmTBMFITM6p9gLe//RlR3Mh2u6/rYZEPJ73wpokHi3ArEICCG2+58IZpt
  145. WTV0FUPoXZz1bZ+N45yGCPEw2Ibgr6AWHvQzUeIDICWS4D/IPN73QUfifRHQmEeb
  146. 3N7YIr63XoACun8oZZrM6OhVfIGJAJUDBRAu5r4dhxvAWY8bGaUBAdipA/4zxuYA
  147. A/C34f4M+3Ta/F3yY8ooxboLyYiqej0i5uK4w51XjJeRoS6c49hi8m5yw8SQ1VmQ
  148. Suk3pTHSYuE9hermX6ET7tMp5sGB1oIy/1zyoxZfLCbWj2UPHUsVJsMagAn3HbF0
  149. UHZMkCj4WothYNSrMfCnswoWjDKQxVIDVKLkpokAlAMFEC7woYNnNYxubw4jcQEB
  150. qQMD9RDnxCyCHatULx+/KUrJLIYaayZe1D/C2VC0QzzdmxHkcAcc5tjuD1S7igJW
  151. +9hftwlf4EJx1NCSjhteNk57W7bcrLEdi4PInwFNXAuiCUzhLvoBRXQbHEuhM39f
  152. hjATkSTIBX9OrwwSJS2IvuuEaZGy1PJSuCqHg88paZlPRYaJAFUDBRAu59rLqn0S
  153. 2IICPJ0BAYo8AgDCDXoqwVsLKofrHFvVc2/S2MHLtNFhWLmep5D26Uk1uKy6E6vw
  154. pFxjbmr41rPepxYdR32218yIYqEG5RQRcjdOiQCVAwUQLuf5rjJyiM5s7VOJAQHv
  155. UwQArtoqCX1Y9u21KuPP439P5Xcg2MexhAmnYD7JP0d5rHcvp0LYfUsOFAZKpRwl
  156. eLqvzkVnUjVR3X3ehmTQdRNRV6o9LVMXYQmMpoZUQlmR/+ilsNjflhKPwx3PpvYT
  157. AGDMv8QlALKc3gN8wJCxq9iW8DHbTWmoYFDiK74FwbDRjDWJAJUDBRAu5rwCRBVw
  158. zUZrQokBAR5pBADAm/0bxhJMfNGT1/d7eaaGWzo0DZ21UulyPzGGQKhvqT2OqFxJ
  159. ulUL+EYyxeKC7GxkcX7cICcQBNTRt9Ul0ooCT/szGneYeUnotp4dWRRxk8e09kjf
  160. +mLo5imR9OI1cUpjo8AJCpFvp/p6GRlS0WhCzdyD4dYsK3pDL3WCsOfD5YkAlQMF
  161. EC7oAXVJt7YjNP0hXQEBMoQD/R2IYpH9EluRureUWg6Oi3uZlMM6gCTz/cWhjNKC
  162. nwbP5VG/J0TqPIGq7VI6ORM9PwfN5CElYNAHhyetSPdH51+jdPY7g80bMvV1QH5U
  163. DtDOD7zjKo4ZcyRu6d7pz14o5yoRiU2bwFa2obcqFBA077j3sVYHU5Rie6ZZWnSU
  164. /ovHiQCVAwUQLuf9K5DwvktRSrLVAQE4IwP/d/j2hNOdHTdH/fs4DuKF2ATDmeIP
  165. vZzxVD2PpyRVfUTd5cypOnPdw0kBhMMTSHo33A+WR5zy+ZosDpg9a/qJwGmnSB7z
  166. puwGMnBGXQZs8CtcqvqMGlyeMLihJa6pLc6KA29mI8XvgtUiBQa5jm7Ga6Aor4K8
  167. zetpHCP8sbgb7D+JAJUDBRAu5rxv+8I/jbEzFDkBAbDoBACa3YIC2hSK00lQhSo7
  168. GvgldN6YjDs0zAnYoiT55z1vi06etQSx0c0jad6+CX4ctK4g3fUZuw6SIbGkk8tU
  169. Rq1Vl3pHertzbY6VIOt+zTXwlMaH+Jv/wP/FJBI3VkGpRvjWNTtAxaXBAV5va5wd
  170. mcj9JtfpVR77CnHNSSMnRqZsFIkAlQMFEC7m1plfgDcY2g7cgQEBxFkEAJehxpIS
  171. EXxr7AyrkyMH7FylxSf2kiVTRko5hmPm30i7q3d4Bxx6qSItERTykvPy4EhWfUG5
  172. 4OMyD68cIX4ovK4cJ4YK+ZiF8OyDjEVX5E1oXdoc7DQb9eIlEnB7B7orDNYVKxJh
  173. In+IVYmvb4MalsPb7kCik7yplZ6Eu507AD3GiQCVAwUQLua8MH0RF3HCK4zZAQE1
  174. 2AP/TlPe1fVdsgR8z87Mtjp5AyxskKLCH1D/CA8kz19kjmO/aQzP0GxZInX6YvUv
  175. 5Ct7Fk3hjdY6PsnK4Vuykeny00nheQRdL/rkjIXZ4fRpPGPDXJwIhdL4tG8Yh+U2
  176. +PWwg3wy96C2AePDgMz7zpRMF6N5Kc/JJ1zV5DaZu7Wk3jmJAJUDBRAu5sNxq/8H
  177. tEbzIS0BAQxlA/4nbmzbeSKFRwGHe62FydmBE3icDvNYNKGO7+oQQRxayF8ZnYjj
  178. bz6UiL9HZmDa0flSURaXuZTCzo+N2TDr5PbCLb2Nvs8bBFps+rcBfsXtv66LZn4k
  179. ukan9MwUS02PK7L/cV3jURzpjead/vqkh7jYVlwB/Wg1c0aVkHt0F7XiRYkAlQMF
  180. EC7mv4WE37rmLVJ+MQEB0JsD/0ow7V3u78AOEj+FJAH182V03EFk+4YYpyHF1DHA
  181. cCWJoCQ9DrcQ+mnMd73hs4AsF5NRXQXpbI7ocZADOG7kqcTAyedX6xHUisYl08Pv
  182. vPlTRCQkgSRNAF1U2MWq8C7mI/LuyLvsSoFedQlaqi5J0Xm5x2IJzm1p3ukre3Sq
  183. 4CQCiQCVAgUQLlKInRNhgovrPB7dAQGF2wP/ZhaTYW2M8zTPAmCIgeZqHJeMWic+
  184. bGeiCB9ICvcQV0dsBXm/26YXwCXnOVoryY5ToCpj5d2zmvAPBTBOx8GrnAPCOHoH
  185. tumQn5ODeRXhyc+jcSKbk/1jAEteEyJJ+KBTVnJ5LymI3Ayv1aWUmdvJhLGavxl9
  186. Wi3bjI/bpV0eE+g=
  187. =pCCQ
  188. -----END PGP PUBLIC KEY BLOCK-----
  189.  
  190. Legalese:
  191.  
  192. (C) Copyright 1993,1994 by Carnegie Mellon University
  193. All Rights Reserved.
  194.  
  195. Permission to use, copy, modify, distribute, and sell this software
  196. and its documentation for any purpose is hereby granted without fee,
  197. provided that the above copyright notice appear in all copies and that
  198. both that copyright notice and this permission notice appear in
  199. supporting documentation, and that the name of Carnegie Mellon
  200. University not be used in advertising or publicity pertaining to
  201. distribution of the software without specific, written prior
  202. permission.  Carnegie Mellon University makes no representations about
  203. the suitability of this software for any purpose.  It is provided "as
  204. is" without express or implied warranty.
  205.  
  206. CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO
  207. THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
  208. AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE
  209. FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  210. WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
  211. AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
  212. OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
  213. SOFTWARE.
  214.  
  215. Portions of this software are derived from code written by Bell
  216. Communications Research, Inc. (Bellcore) and by RSA Data Security,
  217. Inc. and bear similar copyrights and disclaimers of warranty.
  218.  
  219.