home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 646a.lha / metamail_v2.3 / README.Amiga.pp / README.Amiga
Text File  |  1992-06-25  |  13KB  |  332 lines
  1. Johan Widén                                     14-Jun-1992
  2. Hugingatan 20
  3. S-195 52  MÄRSTA
  4. Sweden
  5.  
  6. Tel: +46 8 59 120 120, fax +46 8 59 127 761
  7. Email: jw@jwdata.se
  8.  
  9.  
  10. This is a port of metamail version 2.3 to the Commodore Amiga. The current
  11. version has only been tested with Amiga OS 1.3, but there should not be any
  12. problems with 2.0.
  13.  
  14. Ported programs: ezview, mailto, metamail, mmencode, richtext, splitmail.
  15.  
  16. This archive contains only the binaries. The sources can be found on
  17.     thumper.bellcore.com:pub/nsb
  18.   this directory is mirrored on
  19.     ftp.funet.fi:pub/unix/mail/metamail
  20. The metamail sources are also available via mailserver.  If you send mail to
  21.     mailserver@thumper.bellcore.com
  22. with a subject of
  23.     metamail-sources
  24. you will get back the mm.tar.Z file in MIME format.
  25. If you don't already have a previous generation of MIME software at your site,
  26. make the subject
  27.     metamail-sources-uu
  28. and you will get the sources uuencoded instead.
  29.  
  30. MIME and related standards are described in RFC's 1341-1345.
  31.  
  32.  
  33. Other files that you need
  34. =========================
  35.  
  36. The programs expect to find configuration information in
  37.     the environment
  38.   or in
  39.     S:UUConfig
  40.   or in
  41.     UULIB:Config                (Take a look at UULIB/Config.sample)
  42.  
  43. metamail and mailto relies on a configuration file called
  44.     UULIB:mailcap
  45. A sample mailcap file can be found in UULIB/mailcap
  46.  
  47. metamail and mailto provide the multimedia capability by calling other
  48. programs. These programs are speified in UULIB:mailcap. Most of these
  49. programs are not provided here. You will have to get them some other way.
  50. You will for instance need a program that can display pictures encoded
  51. in the GIF format. I will give suggestions for such programs but many others
  52. will work fine or better.
  53.  
  54.     uulib:seq
  55. A file used by Dillon UUCP to keep a unique sequence number. This file is
  56. expected to exist and contain a number.
  57.  
  58.  
  59. Integration with a normal mail program
  60. ======================================
  61.  
  62. I have changed AmigaElm-1.13 to use metamail to show MIME mail that
  63. can not be handled by Elm itself. I have also put in commands to call
  64. mailto when replying to a message.
  65.  
  66. The diffs are included here in the file Elm113Diffs.lha.
  67.  
  68.  
  69. The files in the man directory
  70. ==============================
  71.  
  72. The source code distribution contains manual pages in troff format. I have
  73. formatted the manuals and included them in the man directory. Note that
  74. some of the manual pages do *not* have a corresponding command in the
  75. bin directory. I have nevertheless included them for your convenience.
  76.  
  77. Environment variables and configuration file info uses by metamail
  78. ==================================================================
  79.  
  80.     Note: the metamail program creates several environment variables with
  81.     names starting with MM_. As the environment under Amiga OS 1.3 is global
  82.     and stays around after a program exits, the setting of some of these
  83.     variables may affect later executions of metamail. If metamail behaves
  84.     strangely, then take a look at how the environment variables env:MM_*
  85.     are set.
  86.  
  87.     This is normally not a problem, but may occur when one tries out various
  88.     options to metamail.
  89.  
  90.     COLUMNS                     (environment variable)
  91.     -------
  92.         Used by richtect when deciding how to break lines. (default 80)
  93.  
  94.     domain name
  95.     -----------
  96.         Searched for in the configuration files as entry
  97.             DomainName
  98.  
  99.     EDITOR                      (environment variable)
  100.     ------
  101.         The editor used by mailto for the ~e command.
  102.  
  103.     KEYHEADS                    (environment variable)
  104.     --------
  105.         See the metamail manual page.
  106.  
  107.     LINES                       (environment variable)
  108.     -----
  109.         Used by richtext when paging the output. (default 23)
  110.  
  111.     MAILCAPS                    (environment variable)
  112.     --------
  113.         What mailcap files are to be searched. (default uulib:mailcap)
  114.  
  115.     mail editor
  116.     -----------
  117.         Searched for in the configuration files as entry
  118.             MailEditor
  119.         if the environment variables VISUAL or EDITOR are not set.
  120.  
  121.     METAMAIL_P_DIR              (environment variable)
  122.     --------------
  123.         Directory for storing message fragments of type message/partial.
  124.         (default T:message-parts)
  125.  
  126.     MM_CHARSET                  (environment variable)
  127.     ----------
  128.         The character set used when composing mail with mailto.
  129.         (default us-ascii)
  130.  
  131.     MM_*                        (environment variable)
  132.     ----
  133.         See the metamail manual page.
  134.  
  135.     node name
  136.     ---------
  137.         Searched for in the configuration files as entry
  138.             NodeName
  139.  
  140.     PAGER                       (environment variable)
  141.     -----
  142.         Used by mailto to display online help. (default more)
  143.  
  144.     sendmail
  145.     --------
  146.         The program that splitmail invokes when sending mail.
  147.         Searched for in the configuration files as entry
  148.             Sendmail
  149.         (default Sendmail)
  150.  
  151.     SPLITSIZE                   (environment variable)
  152.     ---------
  153.         See the mailto manual page.
  154.  
  155.     TERMINAL_CMD                (environment variable)
  156.     ------------
  157.         See the metamail manual page.
  158.  
  159.     VISUAL                      (environment variable)
  160.     ------
  161.         The editor used by mailto for the ~v command.
  162.  
  163.     user name
  164.     ---------
  165.         This is first looked for in environment variables USERNAME and USER.
  166.         If not found there then the configuration files are searched for
  167.             UserName
  168.  
  169.  
  170. Suggestions for programs to use with metamail and mailto
  171. ========================================================
  172.  
  173. Here are some suggestions of what you can use. If you know of something better
  174. I would like to hear about it so that I can improve the mailcap file in later
  175. releases.
  176.  
  177. audio/basic
  178. -----------
  179.     To play I call a script, playUlawSound, that is provided in AmigaSrc. The
  180.     script calls the programs
  181.         SoundZAP        converts from ulaw audio format to 8SVX audio format
  182.         AGMSPlaySound   plays 8SVX audio format
  183.     SoundZAP and AGMSPlaySound are available from many ftp hosts.
  184.  
  185.     To compose (convert actually) an audio fragment I call svxToUlaw. This
  186.     program is provided in AmigaSrc. The program calls the program
  187.         as2ss           converts from 8SVX audio format to ulaw audio format
  188.     as2ss comes from an archive called iff2ulaw.lha. This is available from
  189.     several ftp hosts. However, I had to modify the source, and as there seems
  190.     to be no redistribution restriction I provide the modified iff2ulaw in
  191.     AmigaSrc.
  192.  
  193. image/gif
  194. ---------
  195.     To show a GIF picture I call the program
  196.         GIF_view
  197.     This program is available as archive GIF_view4.lha from several ftp hosts.
  198.  
  199.     To compose (convert actually) a GIF picture I call ilbmToGIF. This program
  200.     is provided in AmigaSrc. The program calls the program
  201.         fbcat
  202.     fbcat is part of the Fuzzy PixMap image manipulation archive. It is
  203.     available on Fish disk 334. There are other program that can be used
  204.     for conversion from IFF ILBM to GIF, for instance: AmigaJPEG_v2.lzh.
  205.     The pbmplus (PBM/PGM/PPM) library, usually called pbm+.lzh, available
  206.     from several ftp hosts has two tools that can be used: ilbmtoppm and
  207.     ppmtogif.
  208.  
  209. image/jpeg
  210. ----------
  211.     To show a JPEG picture I call the script
  212.         showJPEG
  213.     This script in turn calls djpeg, ppmtoilbm and Mostra.
  214.         djpeg           convert from JPEG to PPM
  215.         ppmtoilbm       convert from PPM (or PBM, PBM) to IFF ILBM.
  216.         Mostra          show an IFF ILBM
  217.     djpeg is part of the archive AmigaJPEG_v2.lzh, which is available on
  218.     several ftp hosts.
  219.     ppmtoilbm is part of the pbmplus (PBM/PGM/PPM) library available from
  220.     pc.usl.edu.
  221.     Mostra is available from several ftp hosts. Use whatever viewer suits you.
  222.  
  223. image/pbm
  224. ---------
  225.     To show a PBM picture I call the script
  226.         showPBM
  227.     This script in turn calls ppmtoilbm and Mostra.
  228.         ppmtoilbm       convert from PPM (or PBM, PBM) to IFF ILBM.
  229.         Mostra          show an IFF ILBM
  230.     ppmtoilbm is part of the pbmplus (PBM/PGM/PPM) library, usually called
  231.     pbm+.lzh, which is available from several ftp hosts.
  232.     Mostra is available from several ftp hosts. Use whatever viewer suits you.
  233.  
  234.     The ppmtoilbm program can be excruciatingly slow. I have modified
  235.     ppmtoilbm into the program pnmtoilbm. This program is several times faster
  236.     (up to nine times faster) than ppmtoilbm, for bitmaps and graymaps.
  237.     I have passed the sources on to the Jef Poskanzer and also to Ingo Wilken
  238.     (who supports PBM on the Amiga). If you are interested in the binary or
  239.     the source and can't find it some other way, drop me a line.
  240.         BMS:Pub/pnmtoilbm.lha
  241.     is available via BMS (part of Matt Dillons UUCP distribution) from node
  242.         jwdata.se
  243.  
  244. image/pgm
  245. ---------
  246.     To show a PGM picture I call the script
  247.         showPGM
  248.     This script in turn calls ppmtoilbm and Mostra.
  249.         ppmtoilbm       convert from PPM (or PGM, PBM) to IFF ILBM.
  250.         Mostra          show an IFF ILBM
  251.     ppmtoilbm is part of the pbmplus (PBM/PGM/PPM) library, usually called
  252.     pbm+.lzh, which is available from several ftp hosts.
  253.     Mostra is available from several ftp hosts. Use whatever viewer suits you.
  254.  
  255. image/x-xbitmap
  256. ---------------
  257.     To show an X bitmap I call xbmtopbm, ppmtoilbm, fakePipe and Mostra.
  258.     fakePipe is provided in AmigaSrc.
  259.         xbmtopbm        convert from X11 or X10 bitmap to PBM.
  260.         ppmtoilbm       convert from PPM (or PBM) to IFF ILBM.
  261.         Mostra          show an IFF ILBM
  262.     xbmtopbm and ppmtoilbm are part of the pbmplus (PBM/PGM/PPM) library,
  263.     usually called pbm+.lzh, which is available from several ftp hosts.
  264.     Mostra is available from several ftp hosts. Use whatever viewer suits you.
  265.  
  266. image/x-xwd
  267. -----------
  268.     To show a color X11 or X10 window dump I call the script
  269.         showXWD
  270.     This script in turn calls xwdtoppm, ppmtoilbm and Mostra.
  271.         xwdtopnm        convert from X11 or X10 window dump to PBM, PGM or PPM.
  272.         ppmtoilbm       convert from PPM (or PBM) to IFF ILBM.
  273.         Mostra          show an IFF ILBM
  274.     xwdtopnm and ppmtoilbm are part of the pbmplus (PBM/PGM/PPM) library,
  275.     usually called pbm+.lzh, which is available from several ftp hosts.
  276.     Mostra is available from several ftp hosts. Use whatever viewer suits you.
  277.  
  278.     The script runs one program at a time. This uses less memory than running
  279.     a pipeline. Both xwdtopnm and ppmtoilbm can be quite memory hungry, so this
  280.     is an important consideration.
  281.  
  282. message/partial
  283. ---------------
  284.     The mailtransport system usually sets a limit on the size of messages.
  285.     MIME therefore provides a mechanism for automatic fragmentation and
  286.     reassembly of large messages. Message fragments have type mmessage/partial.
  287.     Reassembly is handled by the program showpartial provided in AmigaSrc.
  288.     Message fragments avaiting reassembly are stored in the directory given
  289.     by the environment variable.
  290.         METAMAIL_P_DIR
  291.  
  292. text/plain
  293. ----------
  294.     To show plain text I call Less.
  295.         Less            show a text file.
  296.     Less is available on fish disk 511. Use whatever text displayer you are
  297.     happy with.
  298.  
  299. text/richtext
  300. -------------
  301.     To show richtext I call the richtext program, which is provided, and then
  302.     I pipe the output from richtext to Less.
  303.         Less            show a text file.
  304.     Less is available on fish disk 511. Use a text viewer that can handle
  305.     ANSI escape sequences for bold, underline etc.
  306.  
  307. application/postscript
  308. ----------------------
  309.     Note: passing received mail to a PostScript previewer is a gigantic
  310.     security hole. You are setting yourself up for say, a virus attack.
  311.  
  312.     To show PostScript I call the post PostScript previewer. A much safer
  313.     thing to do is to send the PostScript to a PostScript printer.
  314.         Post            show a PostScript file.
  315.     Post is available from many ftp hosts.
  316.  
  317.  
  318. Compiler requirements
  319. =====================
  320.  
  321. I have used DICE. Changes for use with other compilers should be small.
  322.  
  323. DICE supports dynamic stack allocation. This means that the programs will not
  324. run out of stack even if the user has set a fairly small stack. If you
  325. recompile with a compiler that does not support dynamic stack allocation you
  326. may have to require a larger stack setting.
  327.  
  328. I have used functions from the library provided with Dillon UUCP-1.15D. So,
  329. you need that library. If you do not have a working popen() or mktemp() you
  330. can use the ones I provide in AmigaSrc/UUCP-1.15D. Note that UUCP-1.15D does
  331. not come with a working popen().
  332.