home *** CD-ROM | disk | FTP | other *** search
/ Dream 49 / Amiga_Dream_49.iso / beos / emacs / emacs-19.34-bin / emacs-19 / info / mh-e-1 < prev    next >
Encoding:
GNU Info File  |  1997-09-17  |  48.1 KB  |  1,339 lines
  1. This is Info file ../info/mh-e, produced by Makeinfo-1.63 from the
  2. input file mh-e.texi.
  3.  
  4.    This is Edition 1.2, last updated 22 August 1995, of `mh-e, The
  5. Emacs Interface to MH', for mh-e, Version 5.0.2.
  6.  
  7.    Copyright 1995 Free Software Foundation, Inc.
  8.  
  9.    Permission is granted to make and distribute verbatim copies of this
  10. manual provided the copyright notice and this permission notice are
  11. preserved on all copies.
  12.  
  13.    Permission is granted to copy and distribute modified versions of
  14. this manual under the conditions for verbatim copying, provided also
  15. that the section entitled "Copying" is included exactly as in the
  16. original, and provided that the entire resulting derived work is
  17. distributed under the terms of a permission notice identical to this
  18. one.
  19.  
  20.    Permission is granted to copy and distribute translations of this
  21. manual into another language, under the above conditions for modified
  22. versions, except that this permission notice may be stated in a
  23. translation approved by the Free Software Foundation.
  24.  
  25. 
  26. File: mh-e,  Node: Top,  Next: Preface,  Prev: (dir),  Up: (dir)
  27.  
  28. MH and Emacs
  29. ************
  30.  
  31.    This is Edition 1.2 of `mh-e, The Emacs Interface to MH', last
  32. updated 22 August 1995 for mh-e Version 5.0.2.
  33.  
  34. * Menu:
  35.  
  36. * Preface::                     Introduction to mh-e.
  37. * Tour Through mh-e::           Use mh-e quickly!
  38. * Using mh-e::                  Documentation for all commands.
  39. * Customizing mh-e::            Documentation for all variables.
  40. * Odds and Ends::               Getting mh-e, reporting bugs, mailing
  41.                                 list and FAQ.
  42. * History::                     The authors speak up!
  43. * Changes to mh-e::             Actual changes between Versions 3 and beyond.
  44. * Copying::                     The GNU General Public License
  45. * Command Index::
  46. * Variable Index::
  47. * Concept Index::
  48.  
  49. 
  50. File: mh-e,  Node: Preface,  Next: Tour Through mh-e,  Prev: Top,  Up: Top
  51.  
  52. Preface
  53. *******
  54.  
  55.    These chapters introduce another interface to MH that is accessible
  56. through the GNU Emacs editor, namely, *mh-e*.  mh-e is easy to use.  I
  57. don't assume that you know GNU Emacs or even MH at this point, since I
  58. didn't know either of them when I discovered mh-e.  However, mh-e was
  59. the tip of the iceberg, and I discovered more and more niceties about
  60. GNU Emacs and MH.  Now I'm fully hooked on both of them.
  61.  
  62.    The mh-e package is distributed with GNU Emacs, (1) so you shouldn't
  63. have to do anything special to use it.  But it's important to note a
  64. brief history of mh-e.  Version 3 was prevalent through the Emacs 18
  65. and early Emacs 19 years.  Then Version 4 came out (Emacs 19.23), which
  66. introduced several new and changed commands.  Finally, Version 5.0 was
  67. released, which fixed some bugs and incompatibilities.  This is the
  68. version covered by this manual.  *Note Getting Started:: will help you
  69. decide which version you have.
  70.  
  71.    If you don't already use GNU Emacs but want to learn more, you can
  72. read an online tutorial by starting GNU Emacs and typing `C-h t'
  73. (`help-with-tutorial').  (This notation is described in *Note
  74. Conventions::.)  If you want to take the plunge, consult the *Note GNU
  75. Emacs Manual: (emacs)top, from the Free Software Foundation.
  76.  
  77.    If more information is needed, you can go to the Unix manual pages of
  78. the individual MH commands.  When the name is not obvious, I'll guide
  79. you to a relevant MH manual page that describes the action more fully.
  80.  
  81.    I hope you enjoy these chapters!  If you have any comments, or
  82. suggestions for this document, please let me know.
  83.  
  84. Bill Wohler <wohler@newt.com>
  85. 8 February 1995
  86.  
  87.    ---------- Footnotes ----------
  88.  
  89.    (1)  Note that mh-e is supported with MH 6 and either Emacs 18 or
  90. Emacs 19.  Reportedly, large parts of it work with MH 5 and also with
  91. Lucid/XEmacs and Epoch, but there are no guarantees.  It is also
  92. distributed with Lucid/XEmacs, as well as with MH itself.
  93.  
  94. 
  95. File: mh-e,  Node: Tour Through mh-e,  Next: Using mh-e,  Prev: Preface,  Up: Top
  96.  
  97. Tour Through mh-e
  98. *****************
  99.  
  100.    This chapter introduces some of the terms you'll need to know and
  101. then takes you on a tour of mh-e. (1)  When you're done, you'll be able
  102. to send, read, and file mail, which is all that a lot of people ever
  103. do.  But if you're the curious type, you'll read *Note Using mh-e:: to
  104. be able to use all the features of mh-e.  If you're the adventurous
  105. type, you'll read *Note Customizing mh-e:: to make mh-e do what you
  106. want.  I suggest you read this chapter first to get the big picture,
  107. and then you can read the other two as you wish.
  108.  
  109. * Menu:
  110.  
  111. * Conventions::                 GNU Emacs Terms and Conventions
  112. * Getting Started::
  113. * Sending Mail Tour::
  114. * Reading Mail Tour::
  115. * Processing Mail Tour::
  116. * Leaving mh-e::
  117. * More About mh-e::
  118.  
  119.    ---------- Footnotes ----------
  120.  
  121.    (1)  The keys mentioned in these chapters refer to the default key
  122. bindings.  If you've changed the bindings, refer to the command
  123. summaries at the beginning of each major section in *Note Using mh-e::,
  124. for a mapping between default key bindings and function names.
  125.  
  126. 
  127. File: mh-e,  Node: Conventions,  Next: Getting Started,  Prev: Tour Through mh-e,  Up: Tour Through mh-e
  128.  
  129. GNU Emacs Terms and Conventions
  130. ===============================
  131.  
  132.    If you're an experienced Emacs user, you can skip the following
  133. conventions and definition of terms and go directly to *Note Getting
  134. Started:: below.  The conventions are as follows:
  135.  
  136. `C-x'
  137.      Hold down the CTRL (Control) key and press the `x' key.
  138.  
  139. `M-x'
  140.      Hold down the META or ALT key and press the `x' key.
  141.  
  142.      Since some keyboards don't have a META key, you can generate
  143.      `M-x', for example, by pressing ESC (Escape), *releasing it*, (1)
  144.      and then pressing the `x' key.
  145.  
  146. `RET'
  147.      Press the RETURN or ENTER key.  This is normally used to complete
  148.      a command.
  149.  
  150. `SPC'
  151.      Press the space bar.
  152.  
  153. `TAB'
  154.      Press the TAB key.
  155.  
  156. `DEL'
  157.      Press the DELETE key.  This may also be a Backspace key, depending
  158.      on your keyboard or Emacs configuration.
  159.  
  160.    A "prefix argument" allows you to pass an argument to any Emacs
  161. function.  To pass an argument, type `C-u' before the Emacs command or
  162. keystroke.  Numeric arguments can be passed as well.  For example, to
  163. insert five f's, use `C-u 5 f'.  There is a default of four when using
  164. `C-u', and you can use multiple prefix arguments to provide arguments
  165. of powers of four.  To continue our example, you could insert four f's
  166. with `C-u f', 16 f's with `C-u C-u f', 64 f's with `C-u C-u C-u f', and
  167. so on.  Numeric and valueless negative arguments can also be inserted
  168. with the META key.  Examples include `M-5' to specify an argument of 5,
  169. or `M--' which specifies a negative argument with no particular value.
  170.  
  171.                                 *NOTE*
  172.  
  173.      The prefix `C-u' or `M-' is not necessary in mh-e's MH-Folder
  174.      modes (*note Reading Mail Tour::.).  In these modes, simply enter
  175.      the numerical argument before entering the command.
  176.  
  177.    There are several other terms that are used in Emacs that you should
  178. know.  The "point" is where the cursor currently is.  You can save your
  179. current place in the file by setting a "mark".  This operation is
  180. useful in several ways.  The mark can be later used when defining a
  181. "region", which is the text between the point and mark.  Many commands
  182. operate on regions, such as those for deleting text or filling
  183. paragraphs.  A mark can be set with `C-@' (or `C-SPC').
  184.  
  185.    The "minibuffer" is the bottom line of the Emacs window, where all
  186. prompting and multiple-character input is directed.  If you are prompted
  187. for information in the minibuffer, such as a filename, Emacs can help
  188. you complete your answer if you type SPC or TAB.  A second SPC or TAB
  189. will list all possibilities at that point.  The minibuffer is also
  190. where you enter Emacs function names after typing `M-x'.  For example,
  191. in the first paragraph, I mentioned that you could obtain help with
  192. `C-h t' (`help-with-tutorial').  What this means is that you can get a
  193. tutorial by typing either `C-h t' or `M-x help-with-tutorial'.  In the
  194. latter case, you are prompted for `help-with-tutorial' in the
  195. minibuffer after typing `M-x'.
  196.  
  197.    In case of trouble: Emacs can be interrupted at any time with `C-g'.
  198. For example, if you've started a command that requests that you enter
  199. something in the minibuffer, but then you change your mind, type `C-g'
  200. and you'll be back where you started.  If you want to exit Emacs
  201. entirely, use `C-x C-c'.
  202.  
  203.    ---------- Footnotes ----------
  204.  
  205.    (1)  This is emphasized because pressing ESC twice or holding it
  206. down a second too long so that it repeats gives you an error message.
  207.  
  208. 
  209. File: mh-e,  Node: Getting Started,  Next: Sending Mail Tour,  Prev: Conventions,  Up: Tour Through mh-e
  210.  
  211. Getting Started
  212. ===============
  213.  
  214.    Because there are many old versions of mh-e out there, it is
  215. important to know which version you have.  I'll be talking about
  216. Version 5 which is similar to Version 4 and vastly different from
  217. Version 3.
  218.  
  219.    First, enter `M-x load-library RET mh-e RET'. (1)  The message,
  220. `Loading mh-e...done', should be displayed in the minibuffer.  If you
  221. get `Cannot open load file: mh-e', then your Emacs is very badly
  222. configured, or mh-e is missing.  You may wish to have your system
  223. administrator install a new Emacs or at least the latest mh-e files.
  224.  
  225.    Having loaded mh-e successfully, enter `M-x mh-version RET'.  The
  226. version of mh-e should be displayed.  Hopefully it says that you're
  227. running Version 5.0.2 which is the latest version as of this printing.
  228. If instead Emacs beeps and says `[No match]', then you're running an
  229. old version of mh-e.
  230.  
  231.    If these tests reveal a non-existent or old version of mh-e, please
  232. consider obtaining a new version.  You can have your system
  233. administrator upgrade the system-wide version, or you can install your
  234. own personal version.  It's really quite easy; instructions for getting
  235. and installing mh-e are in *Note Getting mh-e::.  In the meantime, see
  236. *Note Changes to mh-e::, which compares the old and new names of
  237. commands, functions, variables, and buffers.
  238.  
  239.    Also, older versions of mh-e assumed that you had already set up
  240. your MH environment.  Newer versions set up a new MH environment for
  241. you by running `install-mh' and notifying you of this fact with the
  242. message in a temporary buffer:
  243.  
  244.      I'm going to create the standard MH path for you.
  245.  
  246.    Therefore, if you've never run MH before and you're using an old
  247. version of mh-e, you need to run `install-mh' from the shell before you
  248. continue the tour.  If you don't, you'll be greeted with the error
  249. message: `Can't find MH profile'.
  250.  
  251.    If, during the tour described in this chapter, you see a message
  252. like: `Searching for program: no such file or directory,
  253. /usr/local/bin/mhpath', it means that the MH programs and files are kept
  254. in a nonstandard directory.  In this case, simply add the following to
  255. `~/.emacs' and restart `emacs'.
  256.  
  257.      (setq mh-progs "/PATH/TO/MH/BINARY/DIRECTORY/")
  258.      (setq mh-lib "/PATH/TO/MH/LIBRARY/DIRECTORY/")
  259.  
  260.    The `~' notation used by `~/.emacs' above represents your home
  261. directory.  This is used by the `bash' and `csh' shells.  If your shell
  262. does not support this feature, you could use the environment variable
  263. `$HOME' (such as `$HOME/.emacs') or the absolute path (as in
  264. `/home/wohler/.emacs') instead.
  265.  
  266.    At this point, you should see something like the screen in the
  267. figure in *Note Reading Mail Tour::.  We're now ready to move on.
  268.  
  269.    ---------- Footnotes ----------
  270.  
  271.    (1)  You wouldn't ordinarily do this.
  272.  
  273. 
  274. File: mh-e,  Node: Sending Mail Tour,  Next: Reading Mail Tour,  Prev: Getting Started,  Up: Tour Through mh-e
  275.  
  276. Sending Mail
  277. ============
  278.  
  279.    Let's start our tour by sending ourselves a message which we can
  280. later read and process.  Enter `M-x mh-smail' to invoke the mh-e program
  281. to send messages.  You will be prompted in the minibuffer by `To:'.
  282. Enter your login name.  The next prompt is `cc:'.  Hit RET to indicate
  283. that no carbon copies are to be sent.  At the `Subject:' prompt, enter
  284. `Test' or anything else that comes to mind.
  285.  
  286.    Once you've specified the recipients and subject, your message
  287. appears in an Emacs buffer whose mode (1) is MH-Letter.  Enter some
  288. text in the body of the message, using normal Emacs commands.  You
  289. should now have something like this: (2)
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.      -----Emacs: *scratch*         (Lisp Interaction)--All---------------------
  298.      To: wohler
  299.      cc:
  300.      Subject: Test
  301.      --------
  302.        This is a test message to get the wheels churning...#
  303.      
  304.      
  305.      --**-{draft}      (MH-Letter)--All----------------------------------------
  306.      mh-e message composition window
  307.  
  308.    Note the line of dashes that separates the header and the body of the
  309. message.  It is essential that these dashes (or a blank line) are
  310. present or the body of your message will be considered to be part of
  311. the header.
  312.  
  313.    There are several commands specific to MH-Letter mode, but at this
  314. time we'll only use `C-c C-c' to send your message.  Type `C-c C-c'
  315. now.  That's all there is to it!
  316.  
  317.    ---------- Footnotes ----------
  318.  
  319.    (1)  A "mode" changes Emacs to make it easier to edit a particular
  320. type of text.
  321.  
  322.    (2)  If you're running Emacs under the X Window System, then you
  323. would also see a menubar.  I've left out the menubar in all of the
  324. example screens.
  325.  
  326. 
  327. File: mh-e,  Node: Reading Mail Tour,  Next: Processing Mail Tour,  Prev: Sending Mail Tour,  Up: Tour Through mh-e
  328.  
  329. Receiving Mail
  330. ==============
  331.  
  332.    To read the mail you've just sent yourself, enter `M-x mh-rmail'.
  333. This incorporates the new mail and put the output from `inc' (called
  334. "scan lines" after the MH program `scan' which prints a one-line
  335. summary of each message) into a buffer called `+inbox' whose major mode
  336. is MH-Folder.
  337.  
  338.                                 *NOTE*
  339.  
  340.      The `M-x mh-rmail' command will show you only new mail, not old
  341.      mail.  If you were to run this tour again, you would use `M-r' to
  342.      pull all your messages into mh-e.
  343.  
  344.    You should see the scan line for your message, and perhaps others.
  345. Use `n' or `p' to move the cursor to your test message and type RET to
  346. read your message.  You should see something like:
  347.  
  348.         3  24Aug  root       received fax files on Wed Aug 24 11:00:13 PDT 1994
  349.      #  4+ 24Aug  To:wohler  Test<<This is a test message to get the wheels chu
  350.      
  351.      --%%-{+inbox} 4 msgs (1-4)      (MH-Folder Show)--Bot---------------------
  352.      To: wohler
  353.      Subject: Test
  354.      Date: Wed, 24 Aug 1994 13:01:13 -0700
  355.      From: Bill Wohler <wohler@newt.com>
  356.      
  357.        This is a test message to get the wheels churning...
  358.      
  359.      
  360.      
  361.      
  362.      
  363.      -----{show-+inbox} 4      (MH-Show)--Bot----------------------------------
  364.      After incorporating new messages
  365.  
  366.    If you typed a long message, you can view subsequent pages with SPC
  367. and previous pages with DEL.
  368.  
  369. 
  370. File: mh-e,  Node: Processing Mail Tour,  Next: Leaving mh-e,  Prev: Reading Mail Tour,  Up: Tour Through mh-e
  371.  
  372. Processing Mail
  373. ===============
  374.  
  375.    The first thing we want to do is reply to the message that we sent
  376. ourselves.  Ensure that the cursor is still on the same line as your
  377. test message and type `r'.  You are prompted in the minibuffer with
  378. `Reply to whom:'.  Here mh-e is asking whether you'd like to reply to
  379. the original sender only, to the sender and primary recipients, or to
  380. the sender and all recipients.  If you simply hit RET, you'll reply
  381. only to the sender.  Hit RET now.
  382.  
  383.    You'll find yourself in an Emacs buffer similar to that when you were
  384. sending the original message, like this:
  385.  
  386.      To: wohler
  387.      Subject: Re: Test
  388.      In-reply-to: Bill Wohler's message of Wed, 24 Aug 1994 13:01:13 -0700
  389.                   <199408242001.NAA00505@newt.com>
  390.      --------
  391.      #
  392.      
  393.      --**-{draft}      (MH-Letter)--All----------------------------------------
  394.      To: wohler
  395.      Subject: Test
  396.      Date: Wed, 24 Aug 1994 13:01:13 -0700
  397.      From: Bill Wohler <wohler@newt.com>
  398.      
  399.        This is a test message to get the wheels churning...
  400.      
  401.      -----{show-+inbox} 4      (MH-Show)--Bot----------------------------------
  402.      Composing a reply...done
  403.      Composition window during reply
  404.  
  405.    By default, MH will not add you to the address list of your replies,
  406. so if you find that the `To:' header field is missing, don't worry.  In
  407. this case, type `C-c C-f C-t' to create and go to the `To:' field,
  408. where you can type your login name again.  You can move around with the
  409. arrow keys or with `C-p' (`previous-line'), `C-n' (`next-line'), `C-b'
  410. (`backward-char'), and `C-f' (`forward-char') and can delete the
  411. previous character with DEL.  When you're finished editing your
  412. message, send it with `C-c C-c' as before.
  413.  
  414.    You'll often want to save messages that were sent to you in an
  415. organized fashion.  This is done with "folders".  You can use folders
  416. to keep messages from your friends, or messages related to a particular
  417. topic.  With your cursor in the MH-Folder buffer and positioned on the
  418. message you sent to yourself, type `o' to output (`refile' in MH
  419. parlance) that message to a folder.  Enter `test' at the `Destination:'
  420. prompt and type `y' (or SPC) when mh-e asks to create the folder
  421. `+test'.  Note that a `^' (caret) appears next to the message number,
  422. which means that the message has been marked for refiling but has not
  423. yet been refiled.  We'll talk about how the refile is actually carried
  424. out in a moment.
  425.  
  426.    Your previous reply is now waiting in the system mailbox.  You
  427. incorporate this mail into your MH-Folder buffer named `+inbox' with
  428. the `i' command.  Do this now.  After the mail is incorporated, use `n'
  429. or `p' to move the cursor to the new message, and read it with RET.
  430. Let's delete this message by typing `d'.  Note that a `D' appears next
  431. to the message number.  This means that the message is marked for
  432. deletion but is not yet deleted.  To perform the deletion (and the
  433. refile we did previously), use the `x' command.
  434.  
  435.    If you want to send another message you can use `m' instead of `M-x
  436. mh-smail'.  So go ahead, send some mail to your friends!
  437.  
  438. 
  439. File: mh-e,  Node: Leaving mh-e,  Next: More About mh-e,  Prev: Processing Mail Tour,  Up: Tour Through mh-e
  440.  
  441. Leaving mh-e
  442. ============
  443.  
  444.    You may now wish to exit `emacs' entirely.  Use `C-x C-c' to exit
  445. `emacs'.  If you exited without running `x' in the `+inbox' buffer,
  446. Emacs will offer to save it for you.  Type `y' or SPC to save `+inbox'
  447. changes, which means to perform any refiles and deletes that you did
  448. there.
  449.  
  450.    If you don't want to leave Emacs, you can type `q' to bury (hide)
  451. the mh-e folder or delete them entirely with `C-x k'.  You can then
  452. later recall them with `C-x b' or `M-x mh-rmail'.
  453.  
  454. 
  455. File: mh-e,  Node: More About mh-e,  Prev: Leaving mh-e,  Up: Tour Through mh-e
  456.  
  457. More About mh-e
  458. ===============
  459.  
  460.    These are the basic commands to get you going, but there are plenty
  461. more.  If you think that mh-e is for you, read *Note Using mh-e:: and
  462. *Note Customizing mh-e:: to find out how you can:
  463.  
  464.    * Print your messages.  (*Note Printing:: and *Note Customizing
  465.      Printing::.)
  466.  
  467.    * Edit messages and include your signature.  (*Note Draft Editing::
  468.      and *Note Customizing Draft Editing::.)
  469.  
  470.    * Forward messages.  (*Note Forwarding:: and *Note Customizing
  471.      Forwarding::.)
  472.  
  473.    * Read digests.  (*Note Viewing::.)
  474.  
  475.    * Edit bounced messages.  (*Note Old Drafts:: and *Note Customizing
  476.      Old Drafts::.)
  477.  
  478.    * Send multimedia messages.  (*Note Editing MIME:: and *Note
  479.      Customizing Editing MIME::.)
  480.  
  481.    * Process mail that was sent with `shar' or `uuencode'.  (*Note
  482.      Files and Pipes::.)
  483.  
  484.    * Use sequences conveniently.  (*Note Sequences::.)
  485.  
  486.    * Show header fields in different fonts.  (*Note Customizing
  487.      Viewing::.)
  488.  
  489.    * Find previously refiled messages.  (*Note Searching::.)
  490.  
  491.    * Place messages in a file.  (*Note Files and Pipes::.)
  492.  
  493.    Remember that you can also use MH commands when you're not running
  494. mh-e (and when you are!).
  495.  
  496. 
  497. File: mh-e,  Node: Using mh-e,  Next: Customizing mh-e,  Prev: Tour Through mh-e,  Up: Top
  498.  
  499. Using mh-e
  500. **********
  501.  
  502.    This chapter leaves the tutorial style and goes into more detail
  503. about every mh-e command.  The default, or "out of the box," behavior is
  504. documented.  If this is not to your liking (for instance, you print with
  505. something other than `lpr)', see the associated section in *Note
  506. Customizing mh-e:: which is organized exactly like this chapter.
  507.  
  508.    There are many commands, but don't get intimidated.  There are
  509. command summaries at the beginning of each section.  In case you have
  510. or would like to rebind the keys, the command summaries also list the
  511. associated Emacs Lisp function.  Furthermore, even if you're stranded
  512. on a desert island with a laptop and are without your manuals, you can
  513. get a summary of all these commands with GNU Emacs online help: use
  514. `C-h m' (`describe-mode') for a brief summary of commands or `C-h i' to
  515. read this manual via Info.  The online help is quite good; try running
  516. `C-h C-h C-h'.  This brings up a list of available help topics, one of
  517. which displays the documentation for a given key (like `C-h k C-n').
  518. In addition, review *Note Conventions::, if any of the GNU Emacs
  519. conventions are strange to you.
  520.  
  521.    Let's get started!
  522.  
  523. * Menu:
  524.  
  525. * Reading Mail::
  526. * Sending Mail::
  527. * Draft Editing::
  528. * Moving Mail::
  529. * Searching::
  530. * Sequences::
  531. * Miscellaneous::
  532.  
  533. 
  534. File: mh-e,  Node: Reading Mail,  Next: Sending Mail,  Prev: Using mh-e,  Up: Using mh-e
  535.  
  536. Reading Your Mail
  537. =================
  538.  
  539.    The mh-e entry point for reading mail is `M-x mh-rmail'.  This
  540. command incorporates your mail and creates a buffer called `+inbox' in
  541. MH-Folder mode.  The `M-x mh-rmail' command shows you only new mail,
  542. not old mail. (1)  The `+inbox' buffer contains "scan lines", which are
  543. one-line summaries of each incorporated message.  You can perform most
  544. MH commands on these messages via one-letter commands discussed in this
  545. chapter.  See `scan'(1) for a description of the contents of the scan
  546. lines, and see the Figure in *Note Reading Mail Tour::, for an example.
  547.  
  548. `RET'
  549.      Display a message (`mh-show').
  550.  
  551. `SPC'
  552.      Go to next page in message (`mh-page-msg').
  553.  
  554. `DEL'
  555.      Go to previous page in message (`mh-previous-page').
  556.  
  557. `, (comma)'
  558.      Display a message with all header fields (`mh-header-display').
  559.  
  560. `M-SPC'
  561.      Go to next message in digest (`mh-page-digest').
  562.  
  563. `M-DEL'
  564.      Go to previous message in digest (`mh-page-digest-backwards').
  565.  
  566. `M-b'
  567.      Break up digest into separate messages (`mh-burst-digest').
  568.  
  569. `n'
  570.      Display next message (`mh-next-undeleted-msg').
  571.  
  572. `p'
  573.      Display previous message (`mh-previous-undeleted-msg').
  574.  
  575. `g'
  576.      Go to a message (`mh-goto-msg').
  577.  
  578. `M-<'
  579.      Go to first message (`mh-first-msg').
  580.  
  581. `M->'
  582.      Go to last message (`mh-last-msg').
  583.  
  584. `t'
  585.      Toggle between MH-Folder and MH-Folder Show modes
  586.      (`mh-toggle-showing').
  587.  
  588. * Menu:
  589.  
  590. * Viewing::
  591. * Moving Around::
  592.  
  593.    ---------- Footnotes ----------
  594.  
  595.    (1)  If you want to see your old mail as well, use `M-r' to pull all
  596. your messages into mh-e.  Or, give a prefix argument to `mh-rmail' so
  597. it will prompt you for folder to visit like `M-f' (for example, `C-u
  598. M-x mh-rmail RET bob RET').  Both `M-r' and `M-f' are described in
  599. *Note Organizing::.
  600.  
  601. 
  602. File: mh-e,  Node: Viewing,  Next: Moving Around,  Prev: Reading Mail,  Up: Reading Mail
  603.  
  604. Viewing Your Mail
  605. -----------------
  606.  
  607.    The `RET' (`mh-show') command displays the message that the cursor
  608. is on.  If the message is already displayed, it scrolls to the
  609. beginning of the message.  Use SPC (`mh-page-msg') and DEL
  610. (`mh-previous-page') to move forwards and backwards one page at a time
  611. through the message.  You can give either of these commands a prefix
  612. argument that specifies the number of lines to scroll (such as `10
  613. SPC').  mh-e normally hides a lot of the superfluous header fields that
  614. mailers add to a message, but if you wish to see all of them, use the
  615. `,' (comma; `mh-header-display') command.
  616.  
  617. * Menu:
  618.  
  619. * Reading Digests::
  620. * Reading MIME::
  621.  
  622. 
  623. File: mh-e,  Node: Reading Digests,  Next: Reading MIME,  Prev: Viewing,  Up: Viewing
  624.  
  625. Reading Digests
  626. ...............
  627.  
  628.    A digest is a message that contains other messages.  Special mh-e
  629. commands let you read digests conveniently.  You can use SPC and DEL to
  630. page through the digest as if it were a normal message, but if you wish
  631. to skip to the next message in the digest, use `M-SPC'
  632. (`mh-page-digest').  To return to a previous message, use `M-DEL'
  633. (`mh-page-digest-backwards').
  634.  
  635.    Another handy command is `M-b' (`mh-burst-digest').  This command
  636. uses the MH command `burst' to break out each message in the digest
  637. into its own message.  Using this command, you can quickly delete
  638. unwanted messages, like this: Once the digest is split up, toggle out
  639. of MH-Folder Show mode with `t' (*note Moving Around::.) so that the
  640. scan lines fill the screen and messages aren't displayed.  Then use `d'
  641. (*note Deleting::.) to quickly delete messages that you don't want to
  642. read (based on the `Subject:' header field).  You can also burst the
  643. digest to reply directly to the people who posted the messages in the
  644. digest.  One problem you may encounter is that the `From:' header
  645. fields are preceded with a `>' so that your reply can't create the
  646. `To:' field correctly.  In this case, you must correct the `To:' field
  647. yourself.  This is described later in *Note Editing Textual::.
  648.  
  649. 
  650. File: mh-e,  Node: Reading MIME,  Prev: Reading Digests,  Up: Viewing
  651.  
  652. Reading Multimedia Mail
  653. .......................
  654.  
  655.    MH has the ability to read "MIME" (Multipurpose Internet Mail
  656. Extensions) messages.  Unfortunately, mh-e does not yet have this
  657. ability, so you have to use the MH commands `show' or `mhn' from the
  658. shell to read MIME messages.  (1)
  659.  
  660.    ---------- Footnotes ----------
  661.  
  662.    (1)  You can call them directly from Emacs if you're running the X
  663. Window System: type `M-!  xterm -e mhn MESSAGE-NUMBER'.  You can leave
  664. out the `xterm -e' if you use `mhn -list' or `mhn -store'.
  665.  
  666. 
  667. File: mh-e,  Node: Moving Around,  Prev: Viewing,  Up: Reading Mail
  668.  
  669. Moving Around
  670. -------------
  671.  
  672.    To move on to the next message, use the `n'
  673. (`mh-next-undeleted-msg') command; use the `p'
  674. (`mh-previous-undeleted-msg') command to read the previous message.
  675. Both of these commands can be given a prefix argument to specify how
  676. many messages to skip (for example, `5 n').  You can also move to a
  677. specific message with `g' (`mh-goto-msg').  You can enter the message
  678. number either before or after typing `g'.  In the latter case, Emacs
  679. prompts you.  Finally, you can go to the first or last message with
  680. `M-<' (`mh-first-msg') and `M->' (`mh-last-msg') respectively.
  681.  
  682.    You can also use the Emacs commands `C-p' (`previous-line') and
  683. `C-n' (`next-line') to move up and down the scan lines in the MH-Folder
  684. window.  These commands can be used in conjunction with `RET' to look
  685. at deleted or refiled messages.
  686.  
  687.    The command `t' (`mh-toggle-showing') switches between MH-Folder
  688. mode and MH-Folder Show mode.  (1) MH-Folder mode turns off the
  689. associated show buffer so that you can perform operations on the
  690. messages quickly without reading them.  This is an excellent way to
  691. prune out your junk mail or to refile a group of messages to another
  692. folder for later examination.
  693.  
  694.    ---------- Footnotes ----------
  695.  
  696.    (1)  For you Emacs wizards, this is implemented as an Emacs minor
  697. mode.
  698.  
  699. 
  700. File: mh-e,  Node: Sending Mail,  Next: Draft Editing,  Prev: Reading Mail,  Up: Using mh-e
  701.  
  702. Sending Mail
  703. ============
  704.  
  705.    You can send a mail message in several ways.  You can call `M-x
  706. mh-smail' directly, or from the command line like this:
  707.  
  708.      % `emacs -f mh-smail'
  709.  
  710.    From within mh-e's MH-Folder mode, other methods of sending mail are
  711. available as well:
  712.  
  713. `m'
  714.      Compose a message (`mh-send').
  715.  
  716. `r'
  717.      Reply to a message (`mh-reply').
  718.  
  719. `f'
  720.      Forward message(s) (`mh-forward').
  721.  
  722. `M-d'
  723.      Redistribute a message (`mh-redistribute').
  724.  
  725. `M-e'
  726.      Edit a message that was bounced by mailer
  727.      (`mh-extract-rejected-mail').
  728.  
  729. `M-a'
  730.      Edit a message to send it again (`mh-edit-again').
  731.  
  732.    From within a MH-Folder buffer, you can simply use the command `m'
  733. (`mh-send').  However you invoke `mh-send', you are prompted for the
  734. `To:', `cc:', and `Subject:' header fields.  Once you've specified the
  735. recipients and subject, your message appears in an Emacs buffer whose
  736. mode is MH-Letter (see the Figure in *Note Sending Mail:: to see what
  737. the buffer looks like).  MH-Letter mode allows you to edit your
  738. message, to check the validity of the recipients, to insert other
  739. messages into your message, and to send the message.  We'll go more
  740. into depth about editing a "draft" (1) (a message you're composing) in
  741. just a moment.
  742.  
  743.    `mh-smail' always creates a two-window layout with the current
  744. buffer on top and the draft on the bottom.  If you would rather preserve
  745. the window layout, use `M-x mh-smail-other-window'.
  746.  
  747. * Menu:
  748.  
  749. * Replying::
  750. * Forwarding::
  751. * Redistributing::
  752. * Old Drafts::
  753.  
  754.    ---------- Footnotes ----------
  755.  
  756.    (1)  I highly recommend that you use a "draft folder" so that you
  757. can edit several drafts in parallel.  To do so, create a folder (e.g.,
  758. `+drafts'), and add a profile component called `Draft-Folder:' which
  759. contains `+drafts' (see `mh-profile'(5)).
  760.  
  761. 
  762. File: mh-e,  Node: Replying,  Next: Forwarding,  Prev: Sending Mail,  Up: Sending Mail
  763.  
  764. Replying to Mail
  765. ----------------
  766.  
  767.    To compose a reply to a message, use the `r' (`mh-reply') command.
  768. If you supply a prefix argument (as in `C-u r'), the message you are
  769. replying to is inserted in your reply after having first been run
  770. through `mhl' with the format file `mhl.reply'.  See `mhl'(1) to see
  771. how you can modify the default `mhl.reply' file.
  772.  
  773.    When you reply to a message, you are first prompted with `Reply to
  774. whom?'.  You have several choices here.
  775.  
  776.      Response     Reply Goes To
  777.      
  778.      `from'         The person who sent the message.  This is the default,
  779.                   so RET is sufficient.
  780.      
  781.      `to'           Replies to the sender, plus all recipients in the
  782.                   `To:' header field.
  783.      
  784.      `all'
  785.      `cc'           Forms a reply to the sender, plus all recipients.
  786.  
  787.    Depending on your answer, `repl' is given a different argument to
  788. form your reply.  Specifically, a choice of `from' or none at all runs
  789. `repl -nocc all', and a choice of `to' runs `repl -cc to'.  Finally,
  790. either `cc' or `all' runs `repl -cc all -nocc me'.
  791.  
  792.    Two windows are then created.  One window contains the message to
  793. which you are replying.  Your draft, in MH-Letter mode (described in
  794. *Note Draft Editing::), is in the other window.
  795.  
  796.    If you wish to customize the header or other parts of the reply
  797. draft, please see `repl'(1) and `mh-format'(5).
  798.  
  799. 
  800. File: mh-e,  Node: Forwarding,  Next: Redistributing,  Prev: Replying,  Up: Sending Mail
  801.  
  802. Forwarding Mail
  803. ---------------
  804.  
  805.    To forward a message, use the `f' (`mh-forward') command.  You are
  806. given a draft to edit that looks like it would if you had run the MH
  807. command `forw'.  You are given a chance to add some text (see *Note
  808. Draft Editing::).
  809.  
  810.    You can forward several messages by using a prefix argument; in this
  811. case, you are prompted for the name of a "sequence", a symbolic name
  812. that represents a list or range of message numbers (for example, `C-u f
  813. forbob RET').  All of the messages in the sequence are inserted into
  814. your draft.  By the way, although sequences are often mentioned in this
  815. chapter, you don't have to worry about them for now; the full
  816. description of sequences in mh-e is at the end in *Note Sequences::.
  817. To learn more about sequences in general, please see `mh-sequence'(5).
  818.  
  819. 
  820. File: mh-e,  Node: Redistributing,  Next: Old Drafts,  Prev: Forwarding,  Up: Sending Mail
  821.  
  822. Redistributing Your Mail
  823. ------------------------
  824.  
  825.    The command `M-d' (`mh-redistribute') is similar in function to
  826. forwarding mail, but it does not allow you to edit the message, nor does
  827. it add your name to the `From:' header field.  It appears to the
  828. recipient as if the message had come from the original sender.  For more
  829. information on redistributing messages, see `dist'(1).  Also
  830. investigate the `M-a' (`mh-edit-again') command in *Note Old Drafts::,
  831. for another way to redistribute messages.
  832.  
  833. 
  834. File: mh-e,  Node: Old Drafts,  Prev: Redistributing,  Up: Sending Mail
  835.  
  836. Editing Old Drafts and Bounced Messages
  837. ---------------------------------------
  838.  
  839.    If you don't complete a draft for one reason or another, and if the
  840. draft buffer is no longer available, you can pick your draft up again
  841. with `M-a' (`mh-edit-again').  If you don't use a draft folder, your
  842. last `draft' file will be used.  If you use draft folders, you'll need
  843. to visit the draft folder with `M-f drafts RET', use `n' to move to the
  844. appropriate message, and then use `M-a' to prepare the message for
  845. editing.
  846.  
  847.    The `M-a' command can also be used to take messages that were sent
  848. to you and to send them to more people.
  849.  
  850.    Don't use `M-a' to re-edit a message from a Mailer-Daemon who
  851. complained that your mail wasn't posted for some reason or another.  In
  852. this case, use `M-e' (`mh-extract-rejected-mail') to prepare the
  853. message for editing by removing the Mailer-Daemon envelope and unneeded
  854. header fields.  Fix whatever addressing problem you had, and send the
  855. message again with `C-c C-c'.
  856.  
  857. 
  858. File: mh-e,  Node: Draft Editing,  Next: Moving Mail,  Prev: Sending Mail,  Up: Using mh-e
  859.  
  860. Editing a Draft
  861. ===============
  862.  
  863.    When you edit a message that you want to send (called a "draft" in
  864. this case), the mode used is MH-Letter.  This mode provides several
  865. commands in addition to the normal Emacs editing commands to help you
  866. edit your draft.
  867.  
  868. `C-c C-y'
  869.      Insert contents of message to which you're replying
  870.      (`mh-yank-cur-msg').
  871.  
  872. `C-c C-i'
  873.      Insert a message from a folder (`mh-insert-letter').
  874.  
  875. `C-c C-f C-t'
  876.      Move to `To:' header field (`mh-to-field').
  877.  
  878. `C-c C-f C-c'
  879.      Move to `cc:' header field (`mh-to-field').
  880.  
  881. `C-c C-f C-s'
  882.      Move to `Subject:' header field (`mh-to-field').
  883.  
  884. `C-c C-f C-f'
  885.      Move to `From:' header field (`mh-to-field').
  886.  
  887. `C-c C-f C-b'
  888.      Move to `Bcc:' header field (`mh-to-field').
  889.  
  890. `C-c C-f C-f'
  891.      Move to `Fcc:' header field (`mh-to-fcc').
  892.  
  893. `C-c C-f C-d'
  894.      Move to `Dcc:' header field (`mh-to-field').
  895.  
  896. `C-c C-w'
  897.      Display expanded recipient list (`mh-check-whom').
  898.  
  899. `C-c C-s'
  900.      Insert signature in message (`mh-insert-signature').
  901.  
  902. `C-c C-m C-f'
  903.      Include forwarded message (MIME) (`mh-mhn-compose-forw').
  904.  
  905. `C-c C-m C-e'
  906.      Include anonymous ftp reference (MIME) (`mh-mhn-compose-anon-ftp').
  907.  
  908. `C-c C-m C-t'
  909.      Include anonymous ftp reference to compressed tar file (MIME)
  910.      (`mh-mhn-compose-external-compressed-tar').
  911.  
  912. `C-c C-m C-i'
  913.      Include binary, image, sound, etc. (MIME)
  914.      (`mh-mhn-compose-insertion').
  915.  
  916. `C-c C-e'
  917.      Run through `mhn' before sending (`mh-edit-mhn').
  918.  
  919. `C-c C-m C-u'
  920.      Undo effects of `mhn' (`mh-revert-mhn-edit').
  921.  
  922. `C-c C-c'
  923.      Save draft and send message (`mh-send-letter').
  924.  
  925. `C-c C-q'
  926.      Quit editing and delete draft message (`mh-fully-kill-draft').
  927.  
  928. * Menu:
  929.  
  930. * Editing Textual::
  931. * Editing MIME::
  932. * Sending Message::
  933. * Killing Draft::
  934.  
  935. 
  936. File: mh-e,  Node: Editing Textual,  Next: Editing MIME,  Prev: Draft Editing,  Up: Draft Editing
  937.  
  938. Editing Textual Messages
  939. ------------------------
  940.  
  941.    The following sections show you how to edit a draft.  The commands
  942. described here are also applicable to messages that have multimedia
  943. components.
  944.  
  945. * Menu:
  946.  
  947. * Inserting Letter::
  948. * Inserting Messages::
  949. * Header::
  950. * Recipients::
  951. * Signature::
  952.  
  953. 
  954. File: mh-e,  Node: Inserting Letter,  Next: Inserting Messages,  Prev: Editing Textual,  Up: Editing Textual
  955.  
  956. Inserting letter to which you're replying
  957. .........................................
  958.  
  959.    It is often useful to insert a snippet of text from a letter that
  960. someone mailed to provide some context for your reply.  The command
  961. `C-c C-y' (`mh-yank-cur-msg') does this by yanking a portion of text
  962. from the message to which you're replying and inserting `> ' before
  963. each line.
  964.  
  965.    You can control how much text is included when you run this command.
  966. If you run this command right away, without entering the buffer
  967. containing the message to you, this command will yank the entire
  968. message, as is, into your reply. (1) If you enter the buffer containing
  969. the message sent to you and move the cursor to a certain point and
  970. return to your reply and run `C-c C-y', then the text yanked will range
  971. from that point to the end of the message.  Finally, the most common
  972. action you'll perform is to enter the message sent to you, move the
  973. cursor to the beginning of a paragraph or phrase, set the "mark" with
  974. `C-SPC' or `C-@', and move the cursor to the end of the paragraph or
  975. phrase.  The cursor position is called the "point", and the space
  976. between the mark and point is called the "region".  Having done that,
  977. `C-c C-y' will insert the region you selected.
  978.  
  979.    ---------- Footnotes ----------
  980.  
  981.    (1)  If you'd rather have the header cleaned up, use `C-u r' instead
  982. of `r' when replying (see *Note Replying::).
  983.  
  984. 
  985. File: mh-e,  Node: Inserting Messages,  Next: Header,  Prev: Inserting Letter,  Up: Editing Textual
  986.  
  987. Inserting messages
  988. ..................
  989.  
  990.    Messages can be inserted with `C-c C-i' (`mh-insert-letter').  This
  991. command prompts you for the folder and message number and inserts the
  992. message, indented by `> '.  Certain undesirable header fields are
  993. removed before insertion.  If given a prefix argument (like `C-u C-c
  994. C-i'), the header is left intact, the message is not indented, and `> '
  995. is not inserted before each line.
  996.  
  997. 
  998. File: mh-e,  Node: Header,  Next: Recipients,  Prev: Inserting Messages,  Up: Editing Textual
  999.  
  1000. Editing the header
  1001. ..................
  1002.  
  1003.    Because the header is part of the message, you can edit the header
  1004. fields as you wish.  However, several convenience functions exist to
  1005. help you create and edit them.  For example, the command `C-c C-f C-t'
  1006. (`mh-to-field'; alternatively, `C-c C-f t') moves the cursor to the
  1007. `To:' header field, creating it if necessary.  The functions to move to
  1008. the `cc:', `Subject:', `From:', `Bcc:', and `Dcc:' header fields are
  1009. similar.
  1010.  
  1011.    One function behaves differently from the others, namely, `C-c C-f
  1012. C-f' (`mh-to-fcc'; alternatively, `C-c C-f f').  This function will
  1013. prompt you for the folder name in which to file a copy of the draft.
  1014.  
  1015.    Be sure to leave a row of dashes or a blank line between the header
  1016. and the body of the message.
  1017.  
  1018. 
  1019. File: mh-e,  Node: Recipients,  Next: Signature,  Prev: Header,  Up: Editing Textual
  1020.  
  1021. Checking recipients
  1022. ...................
  1023.  
  1024.    The `C-c C-w' (`mh-check-whom') command expands aliases so you can
  1025. check the actual address(es) in the alias.  A new buffer is created
  1026. with the output of `whom'.
  1027.  
  1028. 
  1029. File: mh-e,  Node: Signature,  Prev: Recipients,  Up: Editing Textual
  1030.  
  1031. Inserting your signature
  1032. ........................
  1033.  
  1034.    You can insert your signature at the current cursor location with the
  1035. `C-c C-s' (`mh-insert-signature') command.  The text of your signature
  1036. is taken from the file `~/.signature'.
  1037.  
  1038. 
  1039. File: mh-e,  Node: Editing MIME,  Next: Sending Message,  Prev: Editing Textual,  Up: Draft Editing
  1040.  
  1041. Editing Multimedia Messages
  1042. ---------------------------
  1043.  
  1044.    mh-e has the capability to create multimedia messages.  It uses the
  1045. MIME (Multipurpose Internet Mail Extensions) protocol.  The MIME
  1046. protocol allows you to incorporate images, sound, video, binary files,
  1047. and even commands that fetch a file with `ftp' when your recipient
  1048. reads the message!  If you were to create a multimedia message with
  1049. plain MH commands, you would use `mhn'.  Indeed, the mh-e MIME commands
  1050. merely insert `mhn' directives which are later expanded by `mhn'.
  1051.  
  1052.    Each of the mh-e commands for editing multimedia messages or for
  1053. incorporating multimedia objects is prefixed with `C-c C-m' .
  1054.  
  1055.    Several MIME objects are defined.  They are called "content types".
  1056. The table in *Note Customizing Draft Editing:: contains a list of the
  1057. content types that mh-e currently knows about.  Several of the mh-e
  1058. commands fill in the content type for you, whereas others require you to
  1059. enter one.  Most of the time, it should be obvious which one to use
  1060. (e.g., use `image/jpeg' to include a JPEG image).  If not, you can
  1061. refer to RFC 1521, (1) which defines the MIME protocol, for a list of
  1062. valid content types.
  1063.  
  1064.    You are also sometimes asked for a "content description".  This is
  1065. simply an optional brief phrase, in your own words, that describes the
  1066. object.  If you don't care to enter a content description, just press
  1067. return and none will be included; however, a reader may skip over
  1068. multimedia fields unless the content description is compelling.
  1069.  
  1070.    Remember: you can always add `mhn' directives by hand.
  1071.  
  1072. * Menu:
  1073.  
  1074. * Forwarding MIME::
  1075. * FTP::
  1076. * Tar::
  1077. * Other MIME Objects::
  1078. * Sending MIME::
  1079.  
  1080.    ---------- Footnotes ----------
  1081.  
  1082.    (1)  This RFC (Request For Comments) is available via the URL
  1083. `ftp://ds.internic.net/rfc/rfc1521.txt'.
  1084.  
  1085. 
  1086. File: mh-e,  Node: Forwarding MIME,  Next: FTP,  Prev: Editing MIME,  Up: Editing MIME
  1087.  
  1088. Forwarding multimedia messages
  1089. ..............................
  1090.  
  1091.    Mail may be forwarded with MIME using the command `C-c C-m C-f'
  1092. (`mh-mhn-compose-forw').  You are prompted for a content description,
  1093. the name of the folder in which the messages to forward are located,
  1094. and the messages' numbers.
  1095.  
  1096. 
  1097. File: mh-e,  Node: FTP,  Next: Tar,  Prev: Forwarding MIME,  Up: Editing MIME
  1098.  
  1099. Including an ftp reference
  1100. ..........................
  1101.  
  1102.    You can even have your message initiate an `ftp' transfer when the
  1103. recipient reads the message.  To do this, use the `C-c C-m C-e'
  1104. (`mh-mhn-compose-anon-ftp') command.  You are prompted for the remote
  1105. host and pathname, the content type, and the content description.
  1106.  
  1107. 
  1108. File: mh-e,  Node: Tar,  Next: Other MIME Objects,  Prev: FTP,  Up: Editing MIME
  1109.  
  1110. Including tar files
  1111. ...................
  1112.  
  1113.    If the remote file (*note FTP::.) is a compressed tar file, you can
  1114. use `C-c C-m C-t' (`mh-mhn-compose-external-compressed-tar').  Then, in
  1115. addition to retrieving the file via anonymous *ftp*, the file will also
  1116. be uncompressed and untarred.  You are prompted for the remote host and
  1117. pathname and the content description.  The pathname should contain at
  1118. least one `/' (slash), because the pathname is broken up into directory
  1119. and name components.
  1120.  
  1121. 
  1122. File: mh-e,  Node: Other MIME Objects,  Next: Sending MIME,  Prev: Tar,  Up: Editing MIME
  1123.  
  1124. Including other multimedia objects
  1125. ..................................
  1126.  
  1127.    Images, sound, and video can be inserted in your message with the
  1128. `C-c C-m C-i' (`mh-mhn-compose-insertion') command.  You are prompted
  1129. for the filename containing the object, the content type, and a content
  1130. description of the object.
  1131.  
  1132. 
  1133. File: mh-e,  Node: Sending MIME,  Prev: Other MIME Objects,  Up: Editing MIME
  1134.  
  1135. Readying multimedia messages for sending
  1136. ........................................
  1137.  
  1138.    When you are finished editing a MIME message, it might look like
  1139. this:
  1140.  
  1141.         3  24Aug  root               received fax files on Wed Aug 24 11:00:13
  1142.         4+ 24Aug  To:wohler          Test<<This is a test message to get the wh
  1143.      
  1144.      
  1145.      
  1146.      
  1147.      
  1148.      --%%-{+inbox} 4 msgs (1-4)      (MH-Folder Show)--Bot-------------------
  1149.      To: wohler
  1150.      cc:
  1151.      Subject: Test of MIME
  1152.      --------
  1153.      #@application/octet-stream [Nonexistent ftp test file] \
  1154.      access-type=anon-ftp; site=berzerk.com; name=panacea.tar.gz; \
  1155.      directory="/pub/"
  1156.      #audio/basic [Test sound bite] /tmp/noise.au
  1157.      --**-{draft}      (MH-Letter)--All--------------------------------------
  1158.      mh-e MIME draft
  1159.  
  1160.    The lines added by the previous commands are `mhn' directives and
  1161. need to be converted to MIME directives before sending.  This is
  1162. accomplished by the command `C-c C-e' (`mh-edit-mhn'), which runs `mhn'
  1163. on the message.  The following screen shows what those commands look
  1164. like in full MIME format.  You can see why mail user agents are usually
  1165. built to hide these details from the user.
  1166.  
  1167.      To: wohler
  1168.      cc:
  1169.      Subject: Test of MIME
  1170.      MIME-Version: 1.0
  1171.      Content-Type: multipart/mixed; boundary="----- =_aaaaaaaaaa0"
  1172.      Content-ID: <1623.777796162.0@newt.com>
  1173.      
  1174.      ------- =_aaaaaaaaaa0
  1175.      Content-Type: message/external-body; access-type="anon-ftp";
  1176.              site="berzerk.com"; name="panacea.tar.gz"; directory="/pub/"
  1177.      
  1178.      Content-Type: application/octet-stream
  1179.      Content-ID: <1623.777796162.1@newt.com>
  1180.      Content-Description: Nonexistent ftp test file
  1181.      
  1182.      ------- =_aaaaaaaaaa0
  1183.      Content-Type: audio/basic
  1184.      Content-ID: <1623.777796162.2@newt.com>
  1185.      Content-Description: Test sound bite
  1186.      Content-Transfer-Encoding: base64
  1187.      
  1188.      Q3JlYXRpdmUgVm9pY2UgRmlsZRoaAAoBKREBQh8AgwCAgH9/f35+fn59fX5+fn5+f39/f39/f3
  1189.      f4B/f39/f39/f39/f39/f39+f39+f39/f39/f4B/f39/fn5/f39/f3+Af39/f39/gH9/f39/fn
  1190.      -----{draft}      (MH-Letter)--Top--------------------------------------
  1191.      mh-e MIME draft ready to send
  1192.  
  1193.    This action can be undone by running `C-c C-m C-u'
  1194. (`mh-revert-mhn-edit').  It does this by reverting to a backup file.
  1195. You are prompted to confirm this action, but you can avoid the
  1196. confirmation by adding an argument (for example, `C-u C-c C-m C-u').
  1197.  
  1198. 
  1199. File: mh-e,  Node: Sending Message,  Next: Killing Draft,  Prev: Editing MIME,  Up: Draft Editing
  1200.  
  1201. Sending a Message
  1202. -----------------
  1203.  
  1204.    When you are all through editing a message, you send it with the
  1205. `C-c C-c' (`mh-send-letter') command.  You can give an argument (as in
  1206. `C-u C-c C-c') to monitor the first stage of the delivery.
  1207.  
  1208. 
  1209. File: mh-e,  Node: Killing Draft,  Prev: Sending Message,  Up: Draft Editing
  1210.  
  1211. Killing the Draft
  1212. -----------------
  1213.  
  1214.    If for some reason you are not happy with the draft, you can kill it
  1215. instead with `C-c C-q' (`mh-fully-kill-draft').  Emacs then kills the
  1216. draft buffer and deletes the draft message.
  1217.  
  1218. 
  1219. File: mh-e,  Node: Moving Mail,  Next: Searching,  Prev: Draft Editing,  Up: Using mh-e
  1220.  
  1221. Moving Your Mail Around
  1222. =======================
  1223.  
  1224.    This section covers how messages and folders can be moved about or
  1225. manipulated.  Messages may be incorporated into your `+inbox', deleted,
  1226. and refiled.  Messages containing `shar' or `uuencode' output can be
  1227. stored.  Folders can be visited, sorted, packed, or deleted.  Here's a
  1228. list of the available commands to do these things:
  1229.  
  1230. `i'
  1231.      Incorporate new mail into folder (`mh-inc-folder').
  1232.  
  1233. `d'
  1234.      Delete message (`mh-delete-msg').
  1235.  
  1236. `C-d'
  1237.      Delete message, don't move to next message
  1238.      (`mh-delete-msg-no-motion').
  1239.  
  1240. `M-s'
  1241.      Find messages that meet search criteria (`mh-search-folder').
  1242.  
  1243. `o'
  1244.      Output (refile) message to folder (`mh-refile-msg').
  1245.  
  1246. `c'
  1247.      Copy message to folder (`mh-copy-msg').
  1248.  
  1249. `C-o'
  1250.      Output (write) message to file (`mh-write-msg-to-file').
  1251.  
  1252. `!'
  1253.      Repeat last output command (`mh-refile-or-write-again').
  1254.  
  1255. `l'
  1256.      Print message with `lpr' (`mh-print-msg').
  1257.  
  1258. `|'
  1259.      Pipe message through shell command (`mh-pipe-msg').
  1260.  
  1261. `M-n'
  1262.      Unpack message created with `uudecode' or `shar' (`mh-store-msg').
  1263.  
  1264. `M-l'
  1265.      List all folders (`mh-list-folders').
  1266.  
  1267. `M-f'
  1268.      Visit folder (`mh-visit-folder').
  1269.  
  1270. `M-r'
  1271.      Regenerate scan lines (`mh-rescan-folder').
  1272.  
  1273. `M-x mh-sort-folder'
  1274.      Sort folder.
  1275.  
  1276. `M-p'
  1277.      Pack folder (`mh-pack-folder').
  1278.  
  1279. `M-k'
  1280.      Remove folder (`mh-kill-folder').
  1281.  
  1282. `x'
  1283.      Execute pending refiles and deletes (`mh-execute-commands').
  1284.  
  1285. `u'
  1286.      Undo pending refile or delete (`mh-undo').
  1287.  
  1288. `M-u'
  1289.      Undo all pending refiles and deletes (`mh-undo-folder').
  1290.  
  1291. `q'
  1292.      Quit (`mh-quit').
  1293.  
  1294. * Menu:
  1295.  
  1296. * Incorporating::
  1297. * Deleting::
  1298. * Organizing::
  1299. * Printing::
  1300. * Files and Pipes::
  1301. * Finishing Up::
  1302.  
  1303. 
  1304. File: mh-e,  Node: Incorporating,  Next: Deleting,  Prev: Moving Mail,  Up: Moving Mail
  1305.  
  1306. Incorporating Your Mail
  1307. -----------------------
  1308.  
  1309.    If at any time you receive new mail, incorporate the new mail into
  1310. your `+inbox' buffer with `i' (`mh-inc-folder').  Note that `i' will
  1311. display the `+inbox' buffer, even if there isn't any new mail.  You can
  1312. incorporate mail from any file into the current folder by specifying a
  1313. prefix argument; you'll be prompted for the name of the file to use
  1314. (for example, `C-u i ~/mbox RET').
  1315.  
  1316.    Emacs can notify you when you have new mail by displaying `Mail' in
  1317. the mode line.  To enable this behavior, and to have a clock in the mode
  1318. line besides, add the following to `~/.emacs':
  1319.  
  1320.      (display-time)
  1321.  
  1322. 
  1323. File: mh-e,  Node: Deleting,  Next: Organizing,  Prev: Incorporating,  Up: Moving Mail
  1324.  
  1325. Deleting Your Mail
  1326. ------------------
  1327.  
  1328.    To mark a message for deletion, use the `d' (`mh-delete-msg')
  1329. command.  A `D' is placed by the message in the scan window, and the
  1330. next message is displayed.  If the previous command had been `p', then
  1331. the next message displayed is the message previous to the message just
  1332. deleted.  If you specify a prefix argument, you will be prompted for a
  1333. sequence (*note Sequences::.) to delete (for example, `C-u d frombob
  1334. RET').  The `x' command actually carries out the deletion (*note
  1335. Finishing Up::.).  `C-d' (`mh-delete-msg-no-motion') marks the message
  1336. for deletion but leaves the cursor at the current message in case you
  1337. wish to perform other operations on the message.
  1338.  
  1339.