home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1993 #3 / NN_1993_3.iso / spool / comp / mail / mh / 1551 < prev    next >
Encoding:
Internet Message Format  |  1993-01-26  |  54.8 KB

  1. Xref: sparky comp.mail.mh:1551 news.answers:5455 comp.answers:17
  2. Path: sparky!uunet!enterpoop.mit.edu!senator-bedfellow.mit.edu!senator-bedfellow.mit.edu!usenet
  3. From: Bill Wohler <wohler@sap-ag.de>
  4. Newsgroups: comp.mail.mh,news.answers,comp.answers
  5. Subject: MH Frequently Asked Questions (FAQ) with Answers
  6. Supersedes: <mh-faq_726127330@athena.mit.edu>
  7. Followup-To: poster
  8. Date: 26 Jan 1993 06:02:18 GMT
  9. Organization: SAP AG, Walldorf, Germany
  10. Lines: 1561
  11. Approved: news-answers-request@MIT.Edu
  12. Expires: 11 Mar 1993 06:02:11 GMT
  13. Message-ID: <mh-faq_728028131@athena.mit.edu>
  14. Reply-To: Bill Wohler <wohler@sap-ag.de>
  15. NNTP-Posting-Host: pit-manager.mit.edu
  16. Summary: This document answers Frequently Asked Questions about MH, a
  17.      sophisticated mail interface.  It should be read by anyone who wishes
  18.      to post to comp.mail.mh.
  19. Keywords: FAQ mh mail question answer pop slocal letter signature
  20.       draft message folder xmh olmh vmail vmailtool comp repl 
  21.       forw scan smtp bind
  22. X-Last-Updated: 1993/01/25
  23.  
  24. Archive-name: mh-faq
  25. Last-modified: $Date: 1993/01/23 16:06:28 $
  26. Version: $Revision: 93.1 $
  27.  
  28.   This is a living list of frequently asked questions on the mailer
  29.   user interface, Mail Handler, or MH.  The point of this is to
  30.   circulate existing information, and avoid rehashing old answers.
  31.   Better to build on top than start again.  Please read this document
  32.   before ever posting to this newsgroup.
  33.  
  34.   This article is posted monthly.  If it has already expired and
  35.   you're not reading this, you can hope that you saved the last bit of
  36.   question 3 so that you can get a copy yourself.
  37.  
  38.   Please do not post an answer when someone posts a frequently asked
  39.   question, as I will always e-mail a reply.  This ensures that
  40.   everybody gets their question answered fully and eliminates
  41.   unnecessary traffic in this newsgroup.
  42.  
  43.   Your comments, additions and fixes to this list are welcome: please
  44.   send them to Bill Wohler <wohler@sap-ag.de>.
  45.  
  46.   
  47. Subject: Table of Contents
  48. From: Preface
  49.  
  50. Legend: + new, - deleted, ! changed
  51.  
  52. Introductory
  53.  
  54.  1.  Why should I use MH?
  55. !2.  What is the current version/status of MH?
  56. !3.  Where can I get MH?
  57. !4.  What references exist for MH?
  58. !5.  What other MH software is available?
  59.  6.  How can I print a MH manual?
  60.  7.  How should I report bugs?
  61.  8.  How can I convert from my mailer to MH?
  62.  
  63. Building MH
  64.  
  65.  10. What machines does MH run on?
  66.  11. How do I build MH?
  67.  12. What options should I use?
  68.  13. Fixing "post: problem initializing server; [BHST] no servers available"
  69.  14. Where can I get POP3?
  70. !15. What do I do if scan shows the wrong date?
  71. !16. Why slocal writes messages to system maildrop that from(1) can't read.
  72.  17. Why does repl add a "Re:" to a message that already has one?
  73.  18. Does MH support IMAP2 (RFC 1064)?
  74. +19. Why does "mailgroup mail" only affect inc and not slocal?
  75.  
  76. Using MH
  77.  
  78. !20. Where can I read about slocal and the format of the .maildelivery file?
  79. !21. How do I include messages in repl with or without ">"?
  80.  22. How can I eliminate duplicate copies of letters to myself?
  81.  23. How would one go about reading usenet with MH?
  82. !24. Can I append MH messages (ie. +inbox/1) to a UNIX mailbox format file?
  83.  25. How can I include my signature?
  84. !26. What to do with "Problems with edit - draft removed".
  85.  27. How do I call my editor with arguments?
  86.  28. How do I debug my .maildelivery file?  
  87.  29. How can I digestify the messages in a folder for mail to another user?
  88.  30. Can I run my message through a program (ie. ispell) before sending?  
  89.  31. Can I append MH messages to a GNU Emacs rmail BABYL-format file?
  90.  32. Is there documentation for mh-e?
  91.  33. How can I change my return address?
  92.  34. How can I change my From header?
  93. +35. What to do with "bad address 'xxx' - no at-sign after local-part".
  94.  
  95. Xmh
  96.  
  97.  40. How can I get xmh to use Emacs as the editor?
  98.  41. Does xmh support subfolders?
  99.  42. How do I precede included messages with ">" when replying in xmh?
  100.  
  101. Appendix
  102.  
  103.  Glossary, Acknowledgements, Warranty
  104.  Switching xmh's editor
  105. +babyl2mh.pl
  106. +inco
  107.  
  108.   
  109. Subject: ! Viewing This Article
  110. From: Preface
  111.  
  112.   To skip to a particular question numbered xx, use "/^F.*xx" with most
  113.   pagers.  In GNU Emacs type "M-C-s ^F.*xx", (or C-r to search backwards),
  114.   followed by ESC to end the search.  "-xx" is often sufficient.
  115.  
  116.   To skip to new or changed questions, use "/^S.*[!+]" with most pagers and
  117.   "M-C-s ^S.*[!+]" in GNU Emacs.
  118.  
  119.   This article is in digest format.  Nn may have already broken this
  120.   message into separate articles; if not, then type "G %".  In rn, use
  121.   ^G to skip sections.
  122.  
  123.   This article is treated as an outline when edited by GNU Emacs.
  124.   Run "M-x describe-mode" to see available outline-mode commands.
  125.   Useful commands are "C-c C-s" (show-subtree) and "M-x show-all"
  126.  
  127.   Numbers in square brackets denote the month and year of the last
  128.   update.
  129.  
  130.   
  131. Subject: Why should I use MH?
  132. From: Intro-1
  133.  
  134.   The MH message handling system is a set of electronic mail programs
  135.   in the public domain.  If your computer runs UNIX, it can probably
  136.   run MH.
  137.  
  138.   The big difference between MH and most other "mail user agents" is
  139.   that you can use MH from a UNIX shell prompt.  In MH, each command
  140.   is a separate program, and the shell is used as an interpreter.  So,
  141.   all the power of UNIX shells (pipes, redirection, history, aliases,
  142.   and so on) works with MH--you don't have to learn a new interface.
  143.   Other mail agents have their own command interpreter for their
  144.   individual mail commands (although the mush mail agent simulates a
  145.   UNIX shell).
  146.  
  147.   Because MH commands aren't part of a monolithic mail system, you can
  148.   use them at any time; you don't have to start or quit the mail
  149.   agent.  Because you use them from a shell prompt, you can use all
  150.   the power of the shell.
  151.  
  152.   If your shell has time-saving aliases or functions (and most do),
  153.   you'll be able to use them with MH, of course.  And because MH isn't
  154.   a monolithic mail agent, you can use MH commands in UNIX shell
  155.   scripts, or call them from programs in high-level languages like C.
  156.  
  157.   Unlike most mail agents, MH keeps each message in a separate file.
  158.   The filename is the message number.  To rearrange the messages, MH
  159.   just changes the filenames.  MH can use standard UNIX filesystem
  160.   operations such as removing, copying and linking messages.  The
  161.   message files are grouped into one or more folders, which are
  162.   actually UNIX directories.
  163.  
  164.   MH is free, powerful, flexible--and the basics are easy to learn.
  165.   --Jerry Peek <jerry@ora.com>
  166.  
  167.   
  168. Subject: ! What is the current version/status of MH.
  169. From: Intro-2
  170.  
  171.   The current version of MH is 6.8.
  172.  
  173.   This version includes MIME, a multi-media MH package that implements
  174.   the new IETF work on Multi-media 822 (MIME).  This allows you to
  175.   include things like audio, graphics, and the like, in your mail
  176.   messages.  --Marshall Rose <mrose@dbc.mtview.ca.us>
  177.  
  178.   MH now works with Kerberos as well.
  179.   
  180.   In addition, a new program called mhparam extracts arguments from
  181.   .mh_profile which is useful in shellscripts. 
  182.  
  183.   Please see the file CHANGES in the distribution for more details. [1.93]
  184.  
  185.   
  186. Subject: ! Where can I get MH?
  187. From: Intro-2 
  188.  
  189.   MH comes standard with:
  190.  
  191.     Control Data Corp. CDC4680-MP . . . EMH Version 1.4.2 (modified MH)
  192.     DEC Ultrix 3.1  . . . . . . . . . . MH Version 6.5
  193.     DEC Ultrix 4.2A . . . . . . . . . . MH Version 6.7.1
  194.     Evans and Sutherland ES/OS 2.3  . . MH Version 6.6
  195.     IBM PS/2 AIX 1.2.x  . . . . . . . . MH Version 6.4
  196.     IBM RISC System/6000 AIX 3.x  . . . MH Version 6.6
  197.     MIPS RISC/OS 4.52 . . . . . . . . . MH Version 6.6
  198.     Tektronix UTek  . . . . . . . . . . MH (version unknown)
  199.     Table maintained by James R. Hamilton <jrh@jrh.gts.org> [9.92].
  200.  
  201.   via anonymous ftp:                        [1.93]
  202.     FTP Site:        IP Address:    Path/File Name:        Size:
  203.     -----------------------------------------------------------------
  204.     ftp.ics.uci.edu    [128.195.1.1]    mh/mh-6.8.tar.Z        1.8MB
  205.     louie.udel.edu    [128.175.1.3]    portal/mh-6.8.tar.Z    1.8MB
  206.     ftp.uu.net        [192.48.96.9]    mail/mh/tar/mh-6.8.tar.Z-split/    256K*7
  207.                     README, part01, ..., part08
  208.  
  209.     Or use archie to find a site near you. [12.92]
  210.  
  211.   via uucp:
  212.     The following shell script is one example of how to queue jobs for
  213.     downloading the files from UUNET via UUCP:
  214.  
  215.     #!/bin/sh
  216.     SRC=uunet!~/mail/mh/tar/mh-6.8.tar.Z-split
  217.     DST=/usr/spool/uucppublic/mh
  218.     uucp -d -r $SRC/README $DST/README
  219.     for f in 1 2 3 4 5 6 7 8
  220.     do
  221.         uucp -d -r $SRC/part0$f $DST/part0$f
  222.     done
  223.  
  224.     UUNET subscribers would then call us normally using uucico.  Others
  225.     can use UUNET's 900 number to access UUNET via anonymous uucp.  The
  226.     number is 1-900-468-7727.  The login name is "uucp" and there is no
  227.     password.  The following is a sample Systems/L.sys entry:
  228.     
  229.     uunet Any ACU 19200 19004687727 "" \d\r ogin:-\r-ogin: uucp
  230.     
  231.     The modems on the 900 lines are Telebit WorldBlazers.  These modems
  232.     negotiate V.32bis, V.32, 2400, 1200, and last with (Turbo)PEP tones.
  233.     The cost is 50 cents per minute (as of Jan 93) which will appear on
  234.     your next phone bill.  For more information about the 900 service,
  235.     retrieve uunet!~/help or send e-mail to postmaster@uunet.uu.net
  236.     (uunet!postmaster).  -- Eric Ziegast <ziegast@uunet.uu.net>
  237.  
  238.   via mail:
  239.     Send a note to either mail-server@nluug.nl or
  240.     archive-server@germany.eu.net with a body containing the following:
  241.  
  242.       send mail/mh/mh-6.8.tar.Z
  243.  
  244.     UK users may be able to use ftpmail@doc.ic.ac.uk.  Send a note
  245.     whose body contains "help" to this address. [12.92]
  246.  
  247.     Send a note to ftpmail@decwrl.dec.com whose body contains "help"
  248.     on a line by itself get information on getting ftp sources by
  249.     mail.  Also include the lines "connect" and "dir /pub/mail/ua/mh"
  250.     to see which files are available local to decwrl.  Please do this
  251.     as a last resort only.  [1.93]
  252.  
  253.   via U.S. mail:
  254.     You can send $75 US to the address below.  This covers
  255.     the cost of a 6250 BPI 9-track magtape, handling, and ship-
  256.     ping.  In addition, you'll get a laser-printed hard-copy of
  257.     the entire MH documentation set.  Be sure to include your
  258.     USPS address with your check.  Checks must be drawn on U.S.
  259.     funds and should be made payable to:
  260.  
  261.        Regents of the University of California
  262.  
  263.     The distribution address is:
  264.  
  265.        Univeristy of California at Irvine
  266.        Office of Academic Computing
  267.        360 Computer Science
  268.        Irvine, CA  92717  USA
  269.  
  270.        +1 714 856 5153
  271.  
  272.     Sadly, if you just want the hard-copies of the documenta-
  273.     tion, you still have to pay the $75.  The tar image has the
  274.     documentation source (the manual is in roff format, but the
  275.     rest are in TeX format).  Postscript formatted versions of
  276.     the TeX papers are available, as are crude tty-conversions
  277.     of those papers.  [1.93]
  278.  
  279.   
  280. Subject: ! What references exist for MH?
  281. From: Intro-3
  282.  
  283.   Book:
  284.     MH & xmh: E-mail for Users & Programmers.  Second edition. Jerry Peek.
  285.     ISBN 1-56592-027-9.  $29.95.  728 pages.
  286.     O'Reilly & Associates, Inc.
  287.     Book Orders:
  288.       US and Canada: 800-998-9938. Fax: 707-829-0104.
  289.  
  290.     References to "the MH book" in this document refer to the second
  291.     edition of this book (section numbers for the first edition appear
  292.     in parenthesis).
  293.  
  294.     To get a list of non-US distributors, send a note to
  295.     nuts@ora.com or call +1-707-829-0515.
  296.  
  297.     Examples from this book are in:  
  298.     ftp.uu.net        [137.39.1.9]
  299.     published/oreilly/nutshell/MHxmh/MHxmh2.tar.Z        54KB
  300.  
  301.     There is another book that contains a number of examples of
  302.     advanced mail handing using MH as the example message handler.
  303.     It's also quite a good reference on e-mail in general.  [12.92]
  304.  
  305.     The Internet Message.  Marshall T. Rose
  306.     ISBN 0-13-092941-7.  396 pages.
  307.     P T R Prentice Hall
  308.  
  309.   Usenet:
  310.     comp.mail.mh (gatewayed to MH-users)
  311.  
  312.   Mailing lists:
  313.      General questions/discussion: MH-users@ics.uci.edu
  314.      (gatewayed to comp.mail.mh).
  315.      MH developers and maintainers: MH-workers@ics.uci.edu.
  316.      Please use MH-users-request and MH-workers-request to request
  317.      an addition or deletion.
  318.  
  319.   MH-users archives:
  320.     ftp.ics.uci.edu    [128.195.1.1]    mh/mh-users/*
  321.  
  322.     The files are in packf(1) format, compressed with compress(1).  To
  323.     get them, use anonymous ftp and set "binary" transfer mode.
  324.                     
  325.       mh-users.86.Z       8549        mh-users.86.scan.Z      771
  326.       mh-users.87.Z      55449        mh-users.87.scan.Z     3679
  327.       mh-users.88.Z     182805        mh-users.88.scan.Z    11339
  328.       mh-users.89.Z      89151        mh-users.89.scan.Z     5522
  329.       mh-users.90.Z     402470        mh-users.90.scan.Z    21551
  330.       mh-users.91.Z     878763        mh-users.91.scan.Z    36992
  331.       mh-users.92.Z    1281585        mh-users.92.scan.Z    44975
  332.       mh-users.mbox: current archive, uncompressed.
  333.  
  334.     There are directions in the README file.  Basically, you can use
  335.     either "msh" or the individual commands "inc -file" to get the
  336.     messages into a folder, and then "scan", "pick", "show", and so on
  337.     (or your favorite commands in xmh, mh-e, etc.).  --Jerry Peek
  338.     <jerry@ora.com>
  339.  
  340.   This document:
  341.     via anonymous ftp:
  342.       pit-manager.mit.edu  [18.172.1.27]      /pub/usenet/news.answers/mh-faq.Z
  343.       ftp.uu.net        [137.39.1.9]   /archive/usenet/news.answers/mh-faq.Z
  344.       ftp.cs.ruu.nl       [131.211.80.17]    /pub/NEWS.ANSWERS/mh-faq
  345.  
  346.     via mail:
  347.       Each of the following addresses is following by commands which
  348.       should be included as the body of the message.
  349.       
  350.       mail-server@pit-manager.mit.edu
  351.         send usenet/comp.mail.mh/mh-faq
  352.  
  353.       mail-server@cs.ruu.nl
  354.     send pub/NEWS.ANSWERS/mh-faq
  355.     
  356.   
  357. Subject: ! What other MH software is available?
  358. From: Intro-4
  359.  
  360.   vmh 
  361.     Vmh is designed for people using the bulletin-board features
  362.     of MH, where mail is stored in packed (single-file) folders.  As
  363.     a result, use of this program cannot be mixed with the use of
  364.     normal MH commands.  Vmh is a part of the official MH
  365.     distribution.  --James Perkins <jamesp@sp-eug.com> [1.93]
  366.  
  367.   xmh
  368.     Xmh is a X11 mouse-based MH browsing tool.  It is very powerful
  369.     and feature-filled and thus comes with a moderate learning
  370.     curve.  Its dependence on the X11 environment makes it very
  371.     reconfigurable, but only by people well-versed in X applications
  372.     programming.  Its message reply built-in-editor interface is not
  373.     always popular among those used to having MH bring up the editor
  374.     of their choice.  --James Perkins <jamesp@sp-eug.com>
  375.  
  376.     xmh is part of the standard X Window System distribution from
  377.     MIT.  Ultrix also ships dxmail which is similar.
  378.  
  379.     cs.utk.edu     [128.169.201.1]    pub/xmh.shar.Z        161KB
  380.  
  381.     Here's a version of xmh that includes MIME.  --Harald Tveit
  382.     Alvestrand <hta@boheme.er.sintef.no> [1.93]
  383.  
  384.     aun.uninett.no        pub/unix/mixmh-0.2.tar.Z
  385.  
  386.   olmh
  387.     Sun's Open Windows 3 comes with a demo for OLIT (Open Look
  388.     Interface Toolkit, the Open Look wrapper to Xt) named olmh that
  389.     does handle 3rd and subsequent levels of nesting of folders.
  390.     --Dale Carstensen <dlc@c3file.c3.lanl.gov>
  391.  
  392.     Obtain the Open Windows 3 distribution CD/ROM from Sun (SPARC
  393.     only).  To do this, call 1-800-USA-4SUN and send tone "2" for
  394.     telemarketing after it answers.  The 4.1.2 CD/ROM may also have
  395.     Open Windows 3.  The list price for the 4.1.2 CD/ROM is $200.
  396.  
  397.   mh-e
  398.     Mh-e is the GNU Emacs front end for MH.  It offers all the
  399.     functionality of MH, the visual orientation and simplicity of
  400.     use of xmh, and full integration with Emacs, including thorough
  401.     configurability.  The command set is similar to that of rmail
  402.     (the Emacs front end for BSD mail) and BSD mail itself.  On-line
  403.     help is available.
  404.  
  405.     Mh-e allows one to read and process mail very quickly: commands
  406.     are single characters and completion and defaults are available
  407.     for file and folder names.  During a reply, the original message
  408.     is displayed simultaneously in another window for easy reference
  409.     where a mh-e command can quickly incorporate and format this
  410.     text into your reply.
  411.  
  412.     With mh-e you compose outgoing messages in Emacs.  This is a big
  413.     plus for Emacs users, but it has been known for non-Emacs users
  414.     to be able use mh-e after only learning the most basic cursor
  415.     motion commands.  Mh-e is easily configured via the Emacs
  416.     edit-options menu, and people familiar with Emacs Lisp will be
  417.     able to further reconfigure mh-e beyond recognition.  --Stephen
  418.     Gildea <gildea@expo.lcs.mit.edu>
  419.  
  420.     Mh-e is part of the standard GNU Emacs distribution.  Note
  421.     that mh-e got much faster in Emacs 18.56.
  422.  
  423.     primost.cs.wisc.edu [128.105.2.115] pub/mh-e.el.Z        36KB
  424.  
  425.     mime-compose.el allows one to easily include MIME components into
  426.     a mh-e message.  --Marc Andreessen <marca@ncsa.uiuc.edu>  [1.93]
  427.  
  428.     archive.cis.ohio-state.edu
  429.       pub/gnu/emacs/elisp-archive/misc/mime-compose.el.Z    19KB
  430.  
  431.   vmail 
  432.     Vmail is a curses-based, vi-like message browser which calls on
  433.     MH programs to manipulate mail.  It can be used on almost any
  434.     terminal.  It organizes mail folders into index pages, from
  435.     which a message can be selected to be shown, replied-to,
  436.     forwarded, refiled, deleted, and so on.  The vi-like interface
  437.     and command keystrokes are comfortable to less-experienced UNIX
  438.     users, and it is a small, compact program, unlike the mh-e Emacs
  439.     package.
  440.  
  441.     This version of vmail has been bugfixed and enhanced from the
  442.     original vmail published on the net in 1987 by J. Zobel.
  443.     --James Perkins <jamesp@sp-eug.com> [1.93]
  444.  
  445.     ftp.uu.net    [137.39.1.9]
  446.     comp.sources.unix/volume12/vmail/part0*.Z        46KB
  447.  
  448.     ftp.ucs.ubc.ca     [137.82.27.61]    pub/mh/vmail[1-3]of3.Z    58KB
  449.     Or mail requests to James Perkins <jamesp@sp-eug.com>.  [1.93]
  450.  
  451.   vmailtool
  452.     If you have a Sun workstation, vmailtool may be for you.  It is a
  453.     button gadget panel for the above-mentioned vmail program.  It
  454.     brings vmail into the windows era where people no longer need to
  455.     memorize specific command keystrokes.  It also provides a mail
  456.     icon with the flag that pops up when new mail arrives.  Again,
  457.     this is a compact, simple tool, unlike the powerful xmh program.
  458.     Still, it's a welcome alternative for many people who are running
  459.     SunView or OpenWindows.  --James Perkins <jamesp@sp-eug.com> [1.93]
  460.  
  461.     ftp.ucs.ubc.ca     [137.82.27.61]    pub/mh/vmailtool.Z    18KB
  462.     or mail requests to James Perkins <jamesp@sp-eug.com>. [1.93]
  463.  
  464.   plum
  465.     Plum is a highly configurable and extensible screen-oriented front-end
  466.     for processing MH mail on ASCII terminals.  Unlike mh-e, the extension
  467.     language used in plum is perl, not LISP.  Plum offers many of the
  468.     advantages of xmh, but lacks several of xmh's disadvantages.  The
  469.     look&feel derives more from vi than from emacs.  Key bindings and
  470.     functions may be changed on the fly to suit the user's preference.  It
  471.     offers filename and word completion on folder, variables, and command
  472.     names.
  473.  
  474.     Until it is included in the standard distribution (under miscellany),
  475.     you can find a copy on:
  476.  
  477.     convex.com    [130.168.1.1]    pub/plum/plum*        55KB
  478.     or mail requests to Tom Christiansen <tchrist@convex.com>.
  479.  
  480.   mmh     
  481.     MMH, My Mail Handler, is a Motif interface for reading and sending mail.
  482.     It uses the MH commands to actually handle sending a receiving messages.
  483.     It does not support all the capabilities of MH, but offers a large
  484.     enough subset to handle the majority of users.  Its intended user is
  485.     someone between "bumbling e-mail novice" and "sophisticated user".
  486.     Hooks are provided to allow the user to customize and add new commands.
  487.  
  488.     ftp.eos.ncsu.edu    [152.1.9.25]    /pub/bill.tar.Z
  489.  
  490.   metamail
  491.     Metamail is a package that can be used to convert virtually ANY
  492.     mail-reading program on UNIX into a multimedia mail-reading program.
  493.     It is an extremely generic implementation of MIME (Multipurpose
  494.     Internet Mail Extensions), the proposed standard for multimedia mail
  495.     formats on the Internet.  The implementation is extremely flexible and
  496.     extensible, using a "mailcap" file mechanism for adding support for new
  497.     data formats when sent through the mail.  At a heterogeneous site where
  498.     many mail readers are in use, the mailcap mechanism can be used to
  499.     extend them all to support new types of multimedia mail by a single
  500.     addition to a mailcap file.
  501.  
  502.     The metamail distribution comes complete with a small patch for
  503.     each of over a dozen popular mail reading programs, including
  504.     Berkeley mail, mh, Elm, Xmh, Xmail, Mailtool, Emacs Rmail, Emacs
  505.     VM, Andrew, and others.  Note that the MH patches are now integrated
  506.     into MH 6.8 --Nathaniel Borenstein <nsb@thumper.bellcore.com>
  507.  
  508.     thumper.bellcore.com     [128.96.41.1]    /pub/nsb/mm.tar.Z
  509.  
  510.   X.500 lookups  
  511.     If a name is enclosed in square brackets, when entering a destination
  512.     address, ie:
  513.  
  514.     To: [Greg Wickham,CSIRO]
  515.  
  516.     a search will be made in the X.500 Directory for the individual's entry.
  517.     If an address exists then it will be extracted and placed into the
  518.     headers.  Mail requests for the software to the author.  --Andrew
  519.     Waugh <ajw@mel.dit.csiro.au>
  520.  
  521.   QueueMH
  522.     QuemeMH is an e-mail based service request and tracking system
  523.     based on the Rand Mail Handler. --Barbara Dyker
  524.     <dyker@teal.csn.org>  [1.93]
  525.  
  526.     ftp.cs.colorado.edu        pub/cs/sysadmin/utilities/queuemh.tar.Z
  527.  
  528.   MacMH and PC/MH:
  529.     These were available only for non-commercial degree-granting
  530.     institutions from:
  531.  
  532.     Networking & Communication Systems
  533.     115 Pine Hall
  534.     Stanford University
  535.     Stanford, CA 94305-4122
  536.     Phone: +1 415-723-3909
  537.  
  538.     --Jerry Peek <jerry@ora.com>
  539.  
  540.     The authorized distributor for PC/MH is:
  541.  
  542.     NEI, Inc.
  543.     210 Technology Drive, STE 210
  544.     Irvine, Ca 92718
  545.     Phone: +1 714-753-8588
  546.     FAX:   +1 714-753-8593
  547.     Internet: info@netix.com
  548.  
  549.     --Shannon Yeh <yeh@orion.oac.uci.edu>
  550.  
  551.     In addition, you might try Wollongong, to see if they have something you
  552.     can get.
  553.  
  554.   
  555. Subject: How can I print a MH manual?
  556. From: Intro-5
  557.  
  558.   To order a copy by mail, see the section on how to get MH by mail in
  559.   "Where can I get MH?"  Also, check "What references exist for MH?"
  560.  
  561.   To print your own copy, first obtain the MH sources ("Where can I
  562.   get MH?") if you don't already have it.  Go into the "doc" directory
  563.   and run "make guide" to create the administrators guide and "make
  564.   manual" to create a user's manual which includes tutorials and man
  565.   pages.  If the doc directory is empty or is missing the Makefile,
  566.   you'll have to run "mhconfig MH" in the conf directory so that the
  567.   documentation with correct local information is created.
  568.  
  569.   For properly formatting the documentation (at least the manual
  570.   pages) you might even have to install MH, because a reference to a
  571.   tmac.h file in the MH lib directory is made in the manual pages.
  572.  
  573.   You can also ftp the ASCII or postscript versions:
  574.  
  575.     ftp.ics.uci.edu    [128.195.1.1]    mh/doc/tutorial.ps.Z        64KB
  576.                     mh/doc/ADMIN.ps.Z        57KB
  577.                     mh/doc/MH.ps.Z (man pages)    273KB  
  578.     ftp.uu.net        [137.39.1.9]    same files, but in dir mail/mh/doc
  579.  
  580.   Or, you can send a note to mail-server@nluug.nl with a body containing the
  581.   following:
  582.  
  583.     send mail/mh/papers-ps/tutorial.ps.Z
  584.  
  585.   --Bill Wohler and Jos Vos <jos@bull.nl> [1.93]  
  586.  
  587.   
  588. Subject: How should I report bugs?
  589. From: Intro-6
  590.  
  591.   Mail them to Bug-MH@ics.uci.edu and be sure to include the output of
  592.   the -help option as well as what hardware and operating system you
  593.   are using.
  594.  
  595.   
  596. Subject: How can I convert from my mailer to MH?
  597. From: Intro-7
  598.  
  599.   If you use one of a mail agent like 'mail', 'mailx', 'elm' or
  600.   'mush', converting to MH is easy.  When you run the 'inc' command,
  601.   it reads all new messages from the system mailbox into your 'inbox'
  602.   folder.  Those mail agents also have separate files or "folders"
  603.   that hold messages in the same format as the system mailbox.  You
  604.   can read them with the 'inc -file' command.  For example, to read
  605.   the messages from your 'mbox' mail file into your MH 'inbox' folder,
  606.   you'd type:
  607.  
  608.     % cd
  609.     % cp mbox mbox.backup
  610.     % inc -file mbox
  611.  
  612.   If you see the usual "Incorporating new mail into inbox..." message
  613.   and a scan listing, the messages probably were converted.  Read some
  614.   or all of them (with the 'show' command) and be sure.  The 'inc'
  615.   won't remove your mbox unless you use '-truncate'. 
  616.  
  617.   Section D.4 (C.4) of the MH book lists two scripts to convert mail
  618.   files to MH folders: babyl2mh to convert from rmail's babyl format;
  619.   vmsmail2mh to convert from VMS's mail (see "What references exist
  620.   for MH" to see where the book's examples can be ftped from).
  621.   --Jerry Peek <jerry@ora.com>
  622.  
  623.   Vivek Khera <khera@cs.duke.edu> rewrote this in Perl since the
  624.   original script doesn't work for some people.  See appendix
  625.   "babyl2mh.pl." [1.93]
  626.  
  627.   Juergen Nickelsen <nickel@cs.tu-berlin.de> provides yet another
  628.   short script.  He says,
  629.  
  630.   "You can remove the second to last second line ("> $input"), so
  631.   that the script doesn't zero out your RMAIL file.
  632.  
  633.   "Another alternative is to replace this line with "inc -file $tmpmbox
  634.   $folder && > $input", so that the RMAIL is only zeroed if inc
  635.   successfully incorporated the mail.  Finally one could add a switch
  636.   -z, so that the RMAIL file is only zeroed if the switch is given.
  637.   See appendix "inco." [1.93]
  638.  
  639.   Use the following to convert a Babyl format file to UNIX mail format.
  640.   --Barry A. Warsaw <warsaw@nlm.nih.gov>.
  641.   durer.cme.nist.gov    [129.6.32.4]    pub/gnu/rmailtovm.el
  642.  
  643.   See also MH book appendix D (appendix C).
  644.  
  645.   
  646. Subject: What machines does MH run on?
  647. From: Building MH-10
  648.  
  649.   If you have a computer running UNIX, you can probably run MH.
  650.   --Jerry Peek <jerry@ora.com>
  651.  
  652.   
  653. Subject: How do I build MH?
  654. From: Building MH-11 
  655.  
  656.   By carefully reading the READ-ME in the root of the source
  657.   hierarchy, one should not have any trouble building MH.
  658.  
  659.   
  660. Subject: What options should I use?
  661. From: Building MH-12
  662.  
  663.   BERK: Do NOT include the BERK option (in versions 6.7 or later)!
  664.   BERK breaks the mh-format functions that take apart address lines,
  665.   for example mbox, from, and friendly.  This would really put a crimp
  666.   on my replcomps file.
  667.  
  668.   LOCKF: if you have NFS, you need to lock your mailbox with lockf()
  669.   so the lock will be honored by all machines on the local network.
  670.   If you have the lockf() system call, include LOCKF.
  671.  
  672.   JQ Johnson <jqj@duff.uoregon.edu> makes the point that one should
  673.   use this option carefully since it requires a roboust lockf() call.
  674.   For example, this option caused serious problems on his SunOS 4.1.1.
  675.   He suggested using LOK_BELL instead, and adding "lockstyle: 1" to
  676.   mtstailor.
  677.  
  678.   ATZ: makes your timezones print like "EST" instead of "-0500".  Much
  679.   prettier.
  680.  
  681.   --Stephen Gildea <gildea@expo.lcs.mit.edu>
  682.  
  683.   However, Tony Landells <ahl@technix.oz.au> replies: "Yes; very
  684.   pretty.  How unfortunate that timezone names are so ambiguous, so
  685.   that EST can be interpreted, at a minimum, as (American) Eastern
  686.   Standard Time, (Australian) Eastern Standard Time, or (Australian)
  687.   Eastern Summer Time (and yes, I think it's dumb having the same
  688.   acronym for both normal and Summer time, but that's a different
  689.   problem).  While the numeric timezones may not look as nice, they
  690.   are, at least, reasonably unambiguous.  I would urge anyone who ever
  691.   intends/hopes/expects to use e-mail outside the U.S. to NOT use ATZ
  692.   (sorry Stephen)."
  693.  
  694.   At any rate, the conf/examples directory has been updated and
  695.   contains many examples show you which options are required on your
  696.   platform and which are optional (in the upcoming version MH 6.8).  At
  697.   any rate, it is recommended that you examine the options in the
  698.   example configuration files, and read about them in READ-ME.
  699.  
  700.   RPATHS: a side-effect is that slocal writes messages to your system
  701.   maildrop without the MMDF C-A's that separate messages, so your BSD
  702.   tools like from work. [12.92]
  703.  
  704.   
  705. Subject: Fixing "post: problem initializing server; [BHST] no servers available"
  706. From: Building MH-13
  707.  
  708.   The error message itself is essentially correct.  However, what this
  709.   really means is: MH's post cannot connect to a running sendmail over
  710.   an SMTP port (MH configured with SMTP and SENDMTS).
  711.  
  712.   The potential problems:
  713.  
  714.   1. Your local sendmail daemon is dying or not running for some
  715.   reason.
  716.  
  717.   2. You use BIND and your local nameserver is not responding.
  718.  
  719.   3. Your mtstailor has its "servers:" pointing to a non-existant
  720.   machine or a machine which is a) not reachable or b) not running the
  721.   sendmail daemon.  --Peter Marvit <marvit@hplabs.hpl.hp.com>
  722.  
  723.   
  724. Subject: Where can I get POP3?
  725. From: Building MH-14
  726.  
  727.   MH6.7 (and earlier versions too) include a server for version 3 of POP.
  728.  
  729.   
  730. Subject: ! What do I do if scan shows the wrong date?
  731. From: Building MH-15
  732.  
  733.   Upgrade to MH 6.8. [1.93]
  734.  
  735.   
  736. Subject: ! Why slocal writes messages to system maildrop that from(1) can't read.
  737. From: Building MH-16 
  738.  
  739.   Upgrade to MH 6.8 and set the RPATHS option.  Better yet, use a more
  740.   MH-like command instead: "scan -file $MAIL".  [1.93]
  741.  
  742.  
  743. Subject: Why does repl add a "Re:" to a message that already has one?
  744. From: Building MH-17
  745.  
  746.   I carefully reconfigured and rebuilt MH from scratch and the problem
  747.   went away.  --Larry McVoy <lm@slovax.Eng.Sun.COM>
  748.  
  749.   
  750. Subject: Does MH support IMAP2 (RFC 1064)?
  751. From: Building MH-18  
  752.  
  753.   No.  MH only supports retrieving mail using POP3.  POP3 is on the
  754.   "standards track"--it is now an elective Internet Draft Standard
  755.   (see RFC1280 for more details).  At this point, IMAP[23] are
  756.   "experimental, limited use" protocols; it is unlikely that MH will
  757.   support them.  --John Romine <jromine@ics.uci.edu>
  758.  
  759.   
  760. Subject: + Why does "mailgroup mail" only affect inc but not slocal?
  761. From: Building MH-19
  762.  
  763.   If "mailgroup" is set, inc is made set-group-id to this group name.
  764.   Some SYS5 systems want this to be set to "mail".  Set this if
  765.   /usr/spool/mail (or /usr/mail) is not world-writeable.  These
  766.   changes were contributed by Peter Marvit, and "inc" is very careful
  767.   about its use of the set-gid privilege.
  768.  
  769.   Note that slocal doesn't know how to deal with this, and will not
  770.   work under these systems; just making it set-group-id will open a
  771.   security hole (since it doesn't know when to drop the set-gid
  772.   privileges).  If you're using "mailgroup", you should remove slocal
  773.   (and its man page) from your system. --John Romine
  774.   <jromine@ics.uci.edu> [1.93]
  775.  
  776.   Alternatives to slocal include deliver, procmail, and mailagent.
  777.   Archie can help you find where they are kept.
  778.  
  779.   
  780. Subject: ! Where can I read about slocal and the format of the .maildelivery file?
  781. From: Using MH-20 
  782.  
  783.   See the slocal man page.
  784.  
  785.   Here is brief example of a .maildelivery file that stores messages
  786.   to babble in a folder and the system mailbox, stores mh-users in a
  787.   folder but not the system mailbox, and puts the rest in the system
  788.   mailbox.
  789.  
  790.     to  mh-users  | A "/usr/local/lib/mh/rcvstore -create +lists/mh-users"
  791.     cc  mh-users  | A "/usr/local/lib/mh/rcvstore -create +lists/mh-users"
  792.     to  babble    | R "/usr/local/lib/mh/rcvstore -create +lists/babble"
  793.     cc  babble    | R "/usr/local/lib/mh/rcvstore -create +lists/babble"
  794.     default -     > ? /usr/spool/mail/wohler
  795.  
  796.   In addition, the following may be used to automatically send
  797.   replies while on vacation.  See vacation(1) to see how to set up
  798.   vacation itself.  The sed script removes the ">" that slocal added
  799.   so that vacation knows where to send the reply.
  800.  
  801.     to  wohler   | R "sed -e '1s/>From /From /' | /usr/ucb/vacation wohler"
  802.     cc  wohler   | R "sed -e '1s/>From /From /' | /usr/ucb/vacation wohler"
  803.  
  804.   Your .forward file may look like (quotes necessary):
  805.  
  806.     "| /usr/local/lib/mh/slocal -user your_login"
  807.  
  808.   In some implentations, the "-user your_login" is not needed.  If
  809.   not, manually running slocal with the flag will produce an error.
  810.  
  811.   See also MH book chapter 11.
  812.  
  813.   Alternatives to slocal include deliver, procmail, and mailagent.
  814.   Archie can help you find where they are kept.
  815.  
  816.   
  817. Subject: ! How do I include messages in repl with or without ">"?
  818. From: Using MH-21
  819.     
  820.   When making a reply, specify a filter file on the command line:
  821.  
  822.     repl -filter repl.format
  823.  
  824.   This filter file must be in your MH mail directory (usually "Mail",
  825.   in your home directory).  Here are a couple of example repl.format
  826.   files:
  827.  
  828.     overflowtext="",overflowoffset=0
  829.     message-id:nocomponent,formatfield=\
  830.     "In message %{text}you write:"
  831.     body:component=">",overflowtext=">",overflowoffset=0
  832.  
  833.           or
  834.  
  835.     overflowtext="",overflowoffset=0
  836.     date:component="Your message dated",formatfield=\
  837.     "%<(nodate{text})%{text}%|%(pretty{text})%>"
  838.     body:component=">",overflowtext=">",overflowoffset=0
  839.  
  840.   Setting overflowoffset to 0 keeps MH from doing anything to
  841.   extra-long lines in the headers.  In the body, however, this
  842.   behavior is overridden so that long lines are automatically broken
  843.   and a ">" is inserted before every line.  You could put almost
  844.   whatever you want between those quotes, although the "standard" ">"
  845.   makes it easier to read notes that have been included several times.
  846.   The examples differ with the descriptive text that is inserted
  847.   before the included body.
  848.  
  849.   It is suggested not to use the "prompter" editor in this case, since
  850.   it is likely that you'll not want to use all of the included
  851.   message.  Indeed, it is proper etiquette to edit out all unnecessary
  852.   include verbiage so readers don't have to wade through the morass to
  853.   read your pearls of wisdom.
  854.  
  855.   WARNING: the '>' appears on the first line ONLY in versions prior
  856.   to 6.7.2.  Upgrade to MH 6.8.
  857.     
  858.   --Alan Thew <qq11@liv.ac.uk>, Mike Schwager <schwager@cs.uiuc.edu>,
  859.   James T Perkins <jamesp@sp-eug.com> [1.93]
  860.  
  861.   See also MH book sections 6.7.4, 6.7.5, 9.4.1 (9.3.1).
  862.  
  863.   
  864. Subject: How can I eliminate duplicate copies of letters to myself?
  865. From: Using MH-22
  866.  
  867.   Add these two lines to your MH profile file:
  868.  
  869.     Alternate-Mailboxes: user@host1, user@host2, ...
  870.         repl: -nocc me
  871.  
  872.   To get one copy, you can either:
  873.  
  874.   - Take out the "-nocc me"... then you'll get exactly one copy of
  875.     your replies (assuming all your addresses are listed in
  876.     Alternate-Mailboxes), or
  877.  
  878.   - Add an "Fcc: foldername" to the headers of messages you send.
  879.     That will drop a copy of the message in the folder "foldername".
  880.     You can do this for *all* MH messages you send (not just with
  881.     repl) by putting an "Fcc:" entry in your personal copy of the
  882.     files "components", "replcomps", and "forwcomps" in your MH
  883.     directory.  (If you make a "distcomps" file, it needs
  884.     "Resent-Fcc:".)  For more info, see the man pages comp(1),
  885.     repl(1), forw(1), dist(1) and mh-mail(5). --Jerry Peek <jerry@ora.com>
  886.  
  887.   The Alternate-Mailboxes also tells scan which messages are really
  888.   from you so that it can place the recipient in the scan line instead
  889.   of the sender.  --Bill Wohler
  890.  
  891.   See also MH book sections 6.7.2, 8.6.
  892.  
  893.   This is also a convenient way to AVOID automatically cc-ing a
  894.   mailing list when replying to a person who sent the message to the
  895.   mailing-list, by listing the name of that mailing list in your
  896.   alternate mailboxes.  --Alec Wolman <wolman@crl.dec.com>
  897.  
  898.   
  899. Subject: How would one go about reading Usenet with MH?
  900. From: Using MH-23
  901.  
  902.   Although news readers are better, if one really wants to use
  903.   MH, bbc will do the job.  For example, "bbc comp.mail.mh" reads this
  904.   newsgroup.  To enable bbc, you have to specify "bboards" when you
  905.   build MH.  --Stephen Gildea <gildea@expo.lcs.mit.edu>
  906.  
  907.   You can save articles in the news readers for later perusal with MH.
  908.  
  909.   First, create a symbolic link from your mail directory (ie. usenet) to
  910.   your news directory (ie. "ln -s ~/News ~/Mail/usenet").  You can then
  911.   treat your news directory as a mail folder.  Thus, to select a news
  912.   group, use "folder +usenet/comp/mail/mh".
  913.  
  914.   To set the default save location correctly in rn, use:
  915.  
  916.     rn -M -/
  917.  
  918.   or in your nn presentation sequence:
  919.  
  920.     news.announce.        +$F/$N
  921.     comp.mail.mh        +
  922.     .
  923.     .
  924.  
  925.   See also MH book section 8.7.
  926.  
  927.   
  928. Subject: ! Can I append MH messages (ie. +inbox/1) to a UNIX mailbox format file?
  929. From: Using MH-24 
  930.  
  931.   Yes, see support/general/packmbox.sh in the distribution.  [1.93]
  932.  
  933.   
  934. Subject: How can I include my signature?
  935. From: Using MH-25
  936.  
  937.   There are several ways.
  938.  
  939.   1) The MH way.
  940.  
  941.   1a) In your Mail directory, create files that
  942.       include your signature into the format of the message.
  943.  
  944.      ~/Mail/components:
  945.     To: 
  946.     cc: 
  947.     Subject: 
  948.     --------
  949.  
  950.     --
  951.     Eric Ziegast        ziegast@uunet.uu.net
  952.     UUNET Technologies    uunet!ziegast
  953.  
  954.      ~/Mail/replcomps
  955.     body:component="> ",compwidth=2
  956.     :--
  957.     :Eric Ziegast          ziegast@uunet.uu.net
  958.     :UUNET Technologies    uunet!ziegast
  959.  
  960.      To use the replcomps file, add the following to your ~/.mh_profile:
  961.  
  962.     repl: -filter replfmt
  963.  
  964.      When comp is used, your signature is already there along with my
  965.      headers.  When repl is used, the mhl program takes the body of
  966.      the letter you're replying to, prepends '> ' to each line and
  967.      then adds your signature at the end (available after version 6.7).
  968.  
  969.   1b) Create an "editor" which can be called from whatnow to add the
  970.      signature when desired or create a frontend to post (use the
  971.      .mh_profile line "postproc: postproc" to call it) that always
  972.      appends the .signature file before calling post to mail the
  973.      message.  David J. Fiander <david@golem.uucp>, David A.
  974.      Truesdell <truesdel@sun418.nas.nasa.gov> and Tom Wilmore
  975.      <sastjw@unx.sas.com> have sample scripts to do these.
  976.  
  977.   1c) Section 13.13 of the MH book lists mysend, a sendproc script to
  978.     process a message after "What now? send" (see "What references
  979.     exist for MH" to see where the book's examples can be ftped from).
  980.     --Jerry Peek <jerry@ora.com> [9.92]
  981.  
  982.   2) Using your editor.  If you use vi, you can use something like:
  983.  
  984.       map S :r ~/.signature
  985.  
  986.      to load your signature out of .signature every time you
  987.      hit 'S'.
  988.  
  989.   3) Use your windowing system.  xterm, for example, can provide key
  990.      and button mappings for the utterly lazy.
  991.  
  992.   4) And if you use Emacs with mh-e, C-c C-s will append the signature.
  993.  
  994.   --Eric W. Ziegast <ziegast@uunet.uu.net> & Hardy Mayer
  995.   <hardy@golem.ps.uci.edu> except where noted.
  996.  
  997.   Tired of the same old signature?  Want different signatures for
  998.   different newsgroups?  Here's a program to help you out.
  999.  
  1000.   The way it works is to have .signature be a named pipe, so if you
  1001.   don't have named pipes, just say 'n'.
  1002.  
  1003.   The sigrand program then feeds stuff down the pipe everytime someone
  1004.   wants to read it.  That way it works for more than just news, but
  1005.   for anything that wants to read your .signature, like a mailer.
  1006.  
  1007.   You have your choice of three kinds of signatures:
  1008.  
  1009.       1) random (short) fortune from "fortune -s"; you get these if
  1010.      you don't have a global sig file.
  1011.       2) random fortune from ~/News/SIGNATURES [global sig file]
  1012.       3) random fortune form ~/News/(newsgroup)/SIGNATURES [local sig files]
  1013.  
  1014.   Ask Tom Christiansen <tchrist@convex.com> for more details.
  1015.  
  1016.   
  1017. Subject: ! What to do with "Problems with edit - draft removed".
  1018. From: Using MH-26
  1019.  
  1020.   If your users are using an AT&T version of "vi", it's exiting with
  1021.   non-zero status (supposedly a count of the "errors" during the edit).
  1022.   Move "vi" to "broken_vi" and put it its place:
  1023.  
  1024.     #! /bin/sh
  1025.     /usr/ucb/broken_vi $*
  1026.     exit 0
  1027.  
  1028.   Alternatively, compile MH with the ATTVIBUG option.
  1029.  
  1030.   Then complain to your vendor that "vi" is broken, and they should
  1031.   fix it.  --John Romine <jromine@ics.uci.edu>
  1032.  
  1033.   
  1034. Subject: How do I call my editor with arguments?
  1035. From: Using MH-27 
  1036.  
  1037.   Set your editor (in .mh_profile) to the following shellscript:
  1038.  
  1039.     #/bin/sh
  1040.     <youreditor> <yourargs> $*
  1041.     exit 0
  1042.  
  1043.   --John Romine <jromine@ics.uci.edu>
  1044.  
  1045.   You might find it useful to make <youreditor> $EDITOR, or to use
  1046.   different arguments depending on your EDITOR environment variable.
  1047.   --Ray Nickson <Ray.Nickson@comp.vuw.ac.nz>
  1048.  
  1049.   
  1050. Subject: How do I debug my .maildelivery file?  
  1051. From: Using MH-28
  1052.  
  1053.   Put a message into a file and call slocal directly on it.
  1054.  
  1055.     slocal -user $USER [-verbose] [-debug] < test-msg 
  1056.  
  1057.   Use the verbose or debug flags as necessary.
  1058.  
  1059.   See also MH book section 11.11.
  1060.  
  1061.   
  1062. Subject: How can I digestify the messages in a folder for mail to another user?
  1063. From: Using MH-29
  1064.  
  1065.   How about:
  1066.  
  1067.     forw [-digest tmp] [-form forwcomps] [-filter mhl.digest]
  1068.          messages +folder
  1069.  
  1070.   These messages can be un-digestified :-) by the MH burst(1) program.
  1071.   --Jerry Peek <jerry@ora.com> and Bill Wohler
  1072.  
  1073.   See also MH book sections 6.8, 7.9.
  1074.  
  1075.   
  1076. Subject: Can I run my message through a program (ie. ispell) before sending?  
  1077. From: Using MH-30 
  1078.  
  1079.   It's pretty simple.  If your speller is called myspell, use:
  1080.  
  1081.     What now? edit myspell
  1082.  
  1083.   MH will actually execute:
  1084.  
  1085.     myspell /your-mail-draft-directory/draftfile
  1086.  
  1087.   and give the entire draft message to your speller.  The header will
  1088.   probably be "misspelled," of course, though you might be able to
  1089.   tell the speller to ignore it--or you could hack up a little shell
  1090.   script to run the speller on just the message body, then tack the
  1091.   corrected body back onto the header before sending.
  1092.  
  1093.   You can automate this some more.  For example, if you want your
  1094.   speller to run after your first edit with "prompter" and also after
  1095.   you leave the "vi" editor, add these lines to your MH profile:
  1096.  
  1097.       prompter-next: myspell
  1098.       vi-next: myspell
  1099.  
  1100.   Then, at the "What now?" prompt:
  1101.  
  1102.       What now? e
  1103.  
  1104.   your speller will run.  For more info, see the mh-profile(5) man
  1105.   page or section 6.2.1 of the MH book. --Jerry Peek <jerry@ora.com>
  1106.  
  1107.   
  1108. Subject: Can I append MH messages to a GNU Emacs rmail BABYL-format file?
  1109. From: Using MH-31 
  1110.       
  1111.   To convert your MH folders to BABYL folders, first run the following script
  1112.   on your Mail directory.
  1113.  
  1114.   #!/bin/sh
  1115.  
  1116.   for f in Mail/*; do
  1117.     if [ -d $f ]; then
  1118.         touch msgbox
  1119.         folder=`basename $f`
  1120.         echo -n packing $folder ...
  1121.         packf +$folder
  1122.         echo done
  1123.         mv msgbox Mail-rmail/$folder
  1124.     fi
  1125.   done
  1126.  
  1127.   This assumes you don't have nested folders.  Your rmail folders will be
  1128.   left in $HOME/Mail-rmail in MMDF format which rmail can read.  Then run
  1129.   rmail-input for each folder, which converts each folder into BABYL format.
  1130.  
  1131.   Be sure not to append any messages before they are converted from MMDF
  1132.   to BABYL, since there may be really strange results.
  1133.  
  1134.   
  1135. Subject: Is there documentation for mh-e?
  1136. From: Using MH-32
  1137.  
  1138.   Yes, sort of.  Run "C-h m" (describe-mode) in both scan and
  1139.   letter modes to see which commands and variables are available.
  1140.   Browsing the code is also helpful.
  1141.  
  1142.   
  1143. Subject: How can I change my return address?
  1144. From: Using MH-33
  1145.  
  1146.   If you find that your mailer creates a From header that others have
  1147.   trouble replying to, you can add a Reply-To header to override the
  1148.   From header in replies.
  1149.  
  1150.   Copy the components and replcomps files which are normally found in
  1151.   /usr/local/lib/mh into your Mail directory and add a line like the
  1152.   following after the Subject header replacing my address with your
  1153.   address:
  1154.  
  1155.     Reply-To: wohler@sap-ag.de
  1156.  
  1157.   [12.92]
  1158.   
  1159. Subject: How can I change my From header?
  1160. From: Using MH-34
  1161.  
  1162.   If you're just interested in changing the hostname, add a line to
  1163.   $LIB/mtstailor:
  1164.  
  1165.     localname: desired_host_name
  1166.  
  1167.   --Bill Wisner <wisner@netcom.com> [12.92]
  1168.  
  1169.   Just put a "From:" header in your "components", "replcomps" and
  1170.   "forwcomps" files.  MH will add a "Sender:" header with what it thinks
  1171.   is your real address, but (almost) no one cares about the "Sender:"
  1172.   header anyway.  --Jerry Peek <jerry@ora.com>  [12.92]
  1173.  
  1174.   
  1175. Subject: What to do with "bad address 'xxx' - no at-sign after local-part".
  1176. From: Using MH-35
  1177.  
  1178.   You may find that post returns the following message:
  1179.  
  1180.     post: bad address 'Mr. Foo Bar <fb@somewhere.edu>' - no at-sign
  1181.     after local-part (Bar), continuing...
  1182.  
  1183.   The unquoted dot causes "Mr. Foo" to be parsed as the local part of
  1184.   the address.  Either remove the dot, or rewrite the address as
  1185.   follows: 
  1186.  
  1187.     "Mr. Foo Bar" <fb@somewhere.edu>
  1188.     (Mr. Foo Bar) <fb@somewhere.edu>
  1189.     (Mr. Foo Bar) fb@somewhere.edu
  1190.  
  1191.   --Owen Rees <rtor@ansa.co.uk> [1.93]
  1192.  
  1193.   
  1194. Subject: How can I get xmh to use Emacs as the editor?
  1195. From: Xmh-40 
  1196.  
  1197.   The modifications to xmh to support an external editor, annotations,
  1198.   and an append command can be found in the these places.  --Bob
  1199.   Ellison <ellison@sei.cmu.edu>
  1200.  
  1201.   export.lcs.mit.edu                R5fixes/xmh.editor/*
  1202.   ftp.sei.cmu.edu                pub/xmh
  1203.  
  1204.   As of R5, xmh has a new action proc called XmhShellCommand.  A
  1205.   string parameter will be executed as a shell command with the
  1206.   currently selected messages as parameters (or the current message if
  1207.   there are no selected messages).
  1208.  
  1209.   Using this new action, a couple of shell scripts, a window version
  1210.   of emacs (e.g. xemacs) and some elisp code, xmh can use emacs as its
  1211.   editor instead of the built in Athena text widget editor.  This
  1212.   doesn't require any source code changes to xmh.  These are included
  1213.   in the appendix "Switching xmh's editor".  --Andrew Wason
  1214.   <aw@bae.bellcore.com> 
  1215.  
  1216.   
  1217. Subject: Does xmh support subfolders?
  1218. From: Xmh-41 
  1219.  
  1220.   Yes. Create one by invoking "Create Folder" as usual, and enter
  1221.   something like: existing-folder/new-sub-folder. You can then access
  1222.   the subfolder by popping up a menu over the "existing-folder" button
  1223.   item.  --Steve Malowany <malowany@cenparmi.concordia.ca>
  1224.  
  1225.   But:
  1226.  
  1227.   The R5 version of xmh does *not* handle nested sub-folders.  If you
  1228.   create a folder as 'grab/some/bandwidth', xmh displays this
  1229.   foldername for the remainder of the session where it was created,
  1230.   BUT if you later re-run xmh, the folder is no longer visible to xmh.
  1231.   --John Cooper <jsc@saxon.Eng.Sun.COM>
  1232.  
  1233.   See also MH book section 15.6.2 (14.6.2).
  1234.  
  1235.   
  1236. Subject: How do I precede included messages with ">" when replying in xmh?
  1237. From: Xmh-42
  1238.  
  1239.   Include the following line in your ~/app-defaults/XMh file:
  1240.  
  1241.     Xmh*replyInsertFilter: "sed 's/^/> /'"
  1242.  
  1243.   --Len Makin <len@mel.dit.csiro.au>
  1244.  
  1245.   or, 
  1246.  
  1247.     Xmh.ReplyInsertFilter: /usr/local/lib/mh/mhl -form repl.filter
  1248.  
  1249.   Using this means that you can chose to insert the original by use of
  1250.   the "Insert" button in the Draft message pane.  See "How do I
  1251.   include messages in repl with or without ">"?" to find examples of
  1252.   repl.filter. --Andy Linton <andy.linton@comp.vuw.ac.nz>
  1253.  
  1254.   See also MH book sections 15.1.4 (14.1.4), 16.3.3 (15.2.3).
  1255.  
  1256.   
  1257. Subject: Glossary
  1258. From: Appendix
  1259.  
  1260.   MH    Mail Handler
  1261.   POP3    Post Office Protocol, RFC 1225    
  1262.   MMDF
  1263.   MIME    Multipurpose Internet Mail Extensions
  1264.  
  1265.   
  1266. Subject: Acknowledgements
  1267. From: Appendix
  1268.  
  1269. I'd like to thank the following people for providing ideas on the
  1270. layout of this article:
  1271.  
  1272. Joe Wells <jbw@bigbird.bu.edu>          Richard M. Stallman <rms@gnu.ai.mit.edu>
  1273. David Elliott <dce@smsc.sony.com>     Tom Christiansen <tchrist@convex.com>
  1274. Eugene N. Miya <eugene@nas.nasa.gov>
  1275.  
  1276.  
  1277. We are also grateful to the individuals mentioned below and in the
  1278. text of this document who have provided answers or other information
  1279. to make this a better document.  I regret that it is possible that
  1280. some names have been accidently omitted.  I would also like to thank
  1281. all the readers of comp.mail.mh.
  1282.  
  1283. Kim F. Storm <storm@texas.dk>          Edward Vielmetti <emv@ox.com>
  1284.  
  1285.   
  1286. Subject: Warranty
  1287. From: Appendix
  1288.  
  1289. [The following statement epitomizes the ridiculous state of affairs in
  1290. our country (I'm an American) and can be ignored outside the US...]
  1291.  
  1292. No Warranty: Because this article is provided free of charge as a
  1293. service to comp.mail.mh readers, we provide absolutely no warranty, to
  1294. the extent permitted by applicable state law.  This article is
  1295. provided "as is" without warranty of any kind, either expressed or
  1296. implied, including, but not limited to, the implied warranties of
  1297. merchantability and fitness for a particular purpose.  Should the
  1298. information prove defective, you assume the cost of all necessary
  1299. servicing, repair or correction.
  1300.  
  1301.   
  1302. Subject: Switching xmh's editor
  1303. From: Appendix
  1304.  
  1305. #! /bin/sh
  1306. # This is a shell archive.  Remove anything before this line, then unpack
  1307. # it by saving it into a file and typing "sh file".  To overwrite existing
  1308. # files, type "sh file -c".  You can also feed this as standard input via
  1309. # unshar, or by typing "sh <file", e.g..  If this archive is complete, you
  1310. # will see the following message at the end:
  1311. #        "End of shell archive."
  1312. # Contents:  README Xmh.ad xmh-command.el xmhcommand xmhemacs
  1313. # Wrapped by aw@jello on Fri Nov 15 17:10:34 1991
  1314. PATH=/bin:/usr/bin:/usr/ucb ; export PATH
  1315. if test -f 'README' -a "${1}" != "-c" ; then 
  1316.   echo shar: Will not clobber existing file \"'README'\"
  1317. else
  1318. echo shar: Extracting \"'README'\" \(1269 characters\)
  1319. sed "s/^X//" >'README' <<'END_OF_FILE'
  1320. XThis is a short description of what to do with each of the enclosed files.
  1321. X
  1322. XXmh.ad
  1323. X  Merge this in with your xmh resources.  If you already have
  1324. X  user defined buttons, then you may need to renumber the
  1325. X  buttons in this resource file.
  1326. X
  1327. Xxmh-command.el
  1328. X  Byte compile this file and put it in your GNU emacs load-path.
  1329. X
  1330. Xxmhcommand
  1331. Xxmhemacs
  1332. X  Put these somewhere in your path.
  1333. X
  1334. X
  1335. XOnce you have installed these, restart the R5 xmh with the new
  1336. Xresources.  When you press the repl, forw or comp buttons
  1337. Xan xemacs window will come up with your draft message.
  1338. X
  1339. XOnce you have written your mail, save it and exit GNU emacs (C-xC-c).
  1340. XYou will be prompted if you want to send the current message.
  1341. XIf you enter 'y', the message will be sent and the output will
  1342. Xbe displayed in an emacs window (in case you use -verbose or -snoop).
  1343. XThen you will be prompted to exit emacs.  Enter 'y' when you are ready.
  1344. X
  1345. XIf you answered 'n' when prompted to send the message,
  1346. Xthen the draft message will be deleted and emacs will exit.
  1347. X
  1348. XYou can modify the Xmh.ad resources to add more buttons.
  1349. XAny MH command which accepts "+folder msg" can be used
  1350. X(e.g. a replx shell script which includes the body of the
  1351. Xmessage being replied to can be bound to a replx button)
  1352. X
  1353. X
  1354. XAndrew Wason
  1355. Xaw@bae.bellcore.com
  1356. END_OF_FILE
  1357. if test 1269 -ne `wc -c <'README'`; then
  1358.     echo shar: \"'README'\" unpacked with wrong size!
  1359. fi
  1360. # end of 'README'
  1361. fi
  1362. if test -f 'Xmh.ad' -a "${1}" != "-c" ; then 
  1363.   echo shar: Will not clobber existing file \"'Xmh.ad'\"
  1364. else
  1365. echo shar: Extracting \"'Xmh.ad'\" \(457 characters\)
  1366. sed "s/^X//" >'Xmh.ad' <<'END_OF_FILE'
  1367. XXmh*CommandButtonCount:            3
  1368. X
  1369. XXmh*commandBox.button1.label:        repl
  1370. XXmh*commandBox.button1.translations:\
  1371. X    #override\n\
  1372. X    <Btn1Up>:    XmhShellCommand(xmhcommand y repl) unset()
  1373. X
  1374. XXmh*commandBox.button2.label:        forw
  1375. XXmh*commandBox.button2.translations:\
  1376. X    #override\n\
  1377. X    <Btn1Up>:    XmhShellCommand(xmhcommand y forw) unset()
  1378. X
  1379. XXmh*commandBox.button3.label:        comp
  1380. XXmh*commandBox.button3.translations:\
  1381. X    #override\n\
  1382. X    <Btn1Up>:    XmhShellCommand(xmhcommand n comp) unset()
  1383. END_OF_FILE
  1384. if test 457 -ne `wc -c <'Xmh.ad'`; then
  1385.     echo shar: \"'Xmh.ad'\" unpacked with wrong size!
  1386. fi
  1387. # end of 'Xmh.ad'
  1388. fi
  1389. if test -f 'xmh-command.el' -a "${1}" != "-c" ; then 
  1390.   echo shar: Will not clobber existing file \"'xmh-command.el'\"
  1391. else
  1392. echo shar: Extracting \"'xmh-command.el'\" \(1294 characters\)
  1393. sed "s/^X//" >'xmh-command.el' <<'END_OF_FILE'
  1394. X;;; These functions are for use with xemacs and xmh.
  1395. X;;; The R5 xmh has a new action - XmhShellCommand which executes
  1396. X;;; a shell command with the current msg as an arg.
  1397. X;;; By executing something like:
  1398. X;;;    XmhShellCommand(xmhcommand repl)
  1399. X;;; you can use xemacs as your editor with xmh.
  1400. X;;;
  1401. X;;; The following elisp functions perform the basic whatnowproc functionality
  1402. X;;; (quitting and deleting, sending)
  1403. X;;;
  1404. X;;; Andrew Wason  aw@bae.bellcore.com
  1405. X
  1406. X
  1407. X;;; Override C-xC-c
  1408. X(define-key indented-text-mode-map "\C-x\C-c" 'xmh-command-send-or-delete)
  1409. X
  1410. X
  1411. X(setq mhdraft (getenv "mhdraft"))    ; save the filename of the draft
  1412. X
  1413. X
  1414. X(find-file mhdraft)            ; load the draft letter
  1415. X(indented-text-mode)
  1416. X(setq draft-buffer (current-buffer))    ; save the buffer the draft is in
  1417. X
  1418. X
  1419. X(defun xmh-command-send-or-delete ()
  1420. X  "Prompt to send or delete letter, then quit."
  1421. X  (interactive)
  1422. X  (set-buffer draft-buffer)
  1423. X  (if (y-or-n-p "Send message? ")
  1424. X      (progn
  1425. X    (save-buffer)                ; save the draft buffer
  1426. X    (message "Sending...")
  1427. X    (pop-to-buffer "MH mail delivery"); pop to a buffer for "send" output
  1428. X    (erase-buffer)
  1429. X    (call-process "send" nil t t mhdraft)    ; call MH "send"
  1430. X    (if (y-or-n-p "Exit? ")
  1431. X        (kill-emacs)))            ; exit emacs
  1432. X    (delete-file mhdraft)            ; delete the draft letter
  1433. X    (kill-emacs)))                ; exit emacs
  1434. END_OF_FILE
  1435. if test 1294 -ne `wc -c <'xmh-command.el'`; then
  1436.     echo shar: \"'xmh-command.el'\" unpacked with wrong size!
  1437. fi
  1438. # end of 'xmh-command.el'
  1439. fi
  1440. if test -f 'xmhcommand' -a "${1}" != "-c" ; then 
  1441.   echo shar: Will not clobber existing file \"'xmhcommand'\"
  1442. else
  1443. echo shar: Extracting \"'xmhcommand'\" \(669 characters\)
  1444. sed "s/^X//" >'xmhcommand' <<'END_OF_FILE'
  1445. X#!/bin/sh
  1446. X# This shell should be invoked by the xmh XmhShellCommand() action as
  1447. X#   XmhShellCommand(xmhcommand y repl)
  1448. X#   XmhShellCommand(xmhcommand n comp) etc.
  1449. X# If the second arg is y, then the message list will be used.
  1450. X
  1451. X# We invoke the passed MH command on the identified message
  1452. X# (we must strip the message number and folder from the pathname)
  1453. X(if [ $1 = "y" ]
  1454. Xthen
  1455. X    $2 -whatnowproc xmhemacs +`dirname \`echo $3 | \
  1456. X        sed "s;\\\`mhpath +\\\`/;;"\`` `basename $3`
  1457. X
  1458. X# You can use this more readable version instead if you have ksh
  1459. X#    $2 -whatnowproc xmhemacs +$(dirname $(echo $3 | \
  1460. X#        sed "s;$(mhpath +)/;;")) $(basename $3)
  1461. X
  1462. Xelse
  1463. X    $2 -whatnowproc xmhemacs
  1464. Xfi)&
  1465. END_OF_FILE
  1466. if test 669 -ne `wc -c <'xmhcommand'`; then
  1467.     echo shar: \"'xmhcommand'\" unpacked with wrong size!
  1468. fi
  1469. chmod +x 'xmhcommand'
  1470. # end of 'xmhcommand'
  1471. fi
  1472. if test -f 'xmhemacs' -a "${1}" != "-c" ; then 
  1473.   echo shar: Will not clobber existing file \"'xmhemacs'\"
  1474. else
  1475. echo shar: Extracting \"'xmhemacs'\" \(116 characters\)
  1476. sed "s/^X//" >'xmhemacs' <<'END_OF_FILE'
  1477. X#!/bin/sh
  1478. X# Invoke xemacs and load the xmh-command.el stuff.
  1479. X# xmhemacs is used by xmhcommand
  1480. Xxemacs -l xmh-command
  1481. END_OF_FILE
  1482. if test 116 -ne `wc -c <'xmhemacs'`; then
  1483.     echo shar: \"'xmhemacs'\" unpacked with wrong size!
  1484. fi
  1485. chmod +x 'xmhemacs'
  1486. # end of 'xmhemacs'
  1487. fi
  1488. echo shar: End of shell archive.
  1489. exit 0
  1490.  
  1491.   
  1492. Subject: + babyl2mh.pl
  1493. From: Appendix
  1494.  
  1495. #!/usr/gnu/bin/perl
  1496. # incorporate an RMAIL babyl file into an MH folder
  1497. #
  1498. # usage: babyl2mh +folder babyl-file
  1499. #
  1500. # V. Khera <khera@cs.duke.edu> 17-JUL-1991
  1501.  
  1502. # where to find rcvstore
  1503. $rcvstore = "/usr/local/lib/mh/rcvstore";
  1504.  
  1505. #
  1506. # pull out command line args
  1507. #
  1508. die "usage: babyl2mh +folder babyl-file\n" unless @ARGV == 2;
  1509.  
  1510. $folder = shift;
  1511. # make sure folder name starts with a "+"
  1512. (substr($folder,0,1) eq "+") || (substr($folder,0,0) = "+");
  1513. $bfname = shift;
  1514.  
  1515. print "Incorporating RMAIL file $bfname into MH folder $folder\n";
  1516.  
  1517. #
  1518. # read in babyl file.
  1519. #
  1520. $/ = "\037";    # this separates the records in a babyl file
  1521. $* = 1;        # records are multi-lines
  1522.  
  1523. open(BABYL,$bfname) || die "Couldn't open $bfname\n";
  1524.  
  1525. $_ = <BABYL>;    # discard header.
  1526.  
  1527. $msgnum = 0;
  1528.  
  1529. while (<BABYL>) {
  1530.   chop;        # get rid of delimeter
  1531.   s/\f(.|\n)*\*\*\* EOOH \*\*\*\n//;    # remove duplicate header information
  1532.   open(RCVSTORE,"|" . $rcvstore . " $folder");
  1533.   print RCVSTORE $_;
  1534.   $msgnum++;
  1535.   print "Message $msgnum done.\n";
  1536. }
  1537.  
  1538.   
  1539. Subject: + inco
  1540. From: Appendix
  1541.  
  1542. #!/bin/sh
  1543. # Usage: inco [from [folder]]
  1544. # "from" defaults to $HOME/Mail/outbound, "folder" to +inbox.
  1545.  
  1546. lispfile=/tmp/inco.$$.el
  1547. input=${1-$HOME/Mail/outbound}
  1548. tmpmbox=/tmp/inc.$$.mbox
  1549. folder=${2-+inbox}
  1550.  
  1551. if [ $# -ge 3 ]; then
  1552.     echo Usage: `basename $0` [ from [ folder ]]
  1553.     exit 2
  1554. fi
  1555.  
  1556. trap "rm -f $lispfile $tmpmbox ; exit 1" 1 2 15
  1557.  
  1558. touch $tmpmbox
  1559. chmod 600 $tmpmbox
  1560.  
  1561. echo '(rmail-input "'$input'")
  1562. (rmail-last-message)
  1563. (setq last (rmail-what-message))
  1564. (rmail-show-message 1)
  1565. (while (not (equal (rmail-what-message) last))
  1566.   (rmail-output "'$tmpmbox'")
  1567.   (rmail-delete-forward nil))
  1568. (rmail-output "'$tmpmbox'")
  1569. (kill-buffer (current-buffer))
  1570. ' > $lispfile
  1571.  
  1572. emacs -batch -l $lispfile
  1573. inc -file $tmpmbox $folder
  1574.  
  1575. > $input
  1576. rm -f $lispfile $tmpmbox
  1577.  
  1578.  
  1579. Local Variables:
  1580. mode: outline
  1581. outline-regexp: "^Subject:"
  1582. fill-prefix: "  "  
  1583. eval: (progn (setq buffer-read-only nil) (hide-body))
  1584. End:
  1585.