Provided by: exmh_2.8.0-5_all bug

NAME

       exmh - An introduction to the exmh mail user interface.

INTRODUCTION

       This  man  page  provides  a quick tour through some of the basic features of exmh version
       2.0, which provides a graphical user interface to the MH mail system.

       After you read this tutorial you should be able to use exmh  for  your  basic  daily  mail
       reading  needs.   You  will  learn  how  to  send mail, read mail, manage your messages in
       folders, and adjust some of the exmh features by means of its Preferences user interface.

       There is much more documentation available on-line through HTML pages  that  are  viewable
       from  within  exmh.   In  particular.   exmh-use provides information about using the more
       advanced features of exmh.  If you are already an experienced email user, you may want  to
       just  read the GETTING STARTED section here and then skip to the exmh-use man page.  exmh-
       custom describes how to customize exmh to suit your needs.  exmh-ref lists each button and
       menu  entry  in exmh and explains what they do.  If you are an experienced exmh user, this
       may be the most useful man page for you.

       A cleaned up version of these man pages appear in the 3rd edition of  the  book  by  Jerry
       Peek,  MH  &  xmh:  email  for  users  and  programmers,  which is published by O'Reilly &
       Associates.

       Web versions of the documentation can also be found at

       http://www.beedub.com/exmh/

GETTING STARTED

       If you are already an MH or xmh user, you can start with the examples given in this  tour.
       If  you  are a new user, exmh will set up your basic MH environment.  This includes a Mail
       directory which will have one subdirectory for each mail folder, plus several  files  that
       MH  mail  uses  for  its  own  purposes.   You also get a ~/.mh_profile file that has user
       settings for MH and exmh.

       Exmh uses the regular MH programs to manipulate your  mail  folders  and  messages.   This
       means  it  is  compatible  with command-line use of MH programs, and its actions should be
       familiar if you are an experienced MH user.  If you are a new MH user, then the details of
       running  MH  programs  is  hidden behind the graphical interface.  The MH programs used by
       exmh are described towards the end of this man page.

       When you run exmh for the first time it checks a  few  things  in  your  MH  profile.   In
       particular,  it  depends  on  the Draft-Folder and Unseen-Sequence profile components.  If
       these profile components are not present, a dialog appears and exmh can set  them  up  for
       you.   If  you  do  not  let  exmh create them nor set them up by hand, exmh will not work
       properly.  These profile entries are described in the exmh-ref man page.

       Exmh has been designed to be very flexible, although it will work just fine  "out  of  the
       box".  The Preference package used to adjust some of the settings in exmh is introduced in
       this man page, and some of the important settings are described  here.   A  more  complete
       guide to customizing exmh is given in the exmh-custom man page.

RUNNING EXMH

       The  command  to  start  exmh  looks like this: exmh -display hostname:0 & If your DISPLAY
       environment variable is set up properly, then the -display argument is not needed, and the
       command  is  even simpler.  You do not need to specify a -geometry argument, although exmh
       supports one.  Instead, simply position and size the window  using  your  window  manager.
       When  exmh  quits,  it saves the geometry information so you don't have to worry about it.
       It does this with all its top level windows, so you can adjust  their  position  once  and
       then  forget  about it.  There are more command line options described in the exmh-ref man
       page.

       You can add the exmh command to your startup X environment by editing  your  startup  file
       (like  .xsession).  You might also want to add it to the main menu of your window manager.
       The details about this vary from X system to X system, so ask your local X guru for  help.
       Exmh  also  supports  the  window manager session protocol, which means that session-smart
       window managers will automatically start exmh for you if you quit X when exmh is running.

THE EXMH DISPLAY

       This section describes the main parts of the exmh display.  It probably makes sense to run
       exmh  at  this  point  so  you  can  follow along.  There are three sets of buttons in the
       interface, and three main subwindows.

       Main Buttons.  Along the top of the window is a set of buttons and  menus  that  apply  to
       exmh  itself.  Quit, for example, quits exmh.  The Help button pops up a menu, and you can
       select the entries there to get more on-line information about exmh.  Use the  left  mouse
       button  to  select  the  buttons  and menus.  A button will change its appearance when you
       press it, and it will be invoked when you release the mouse over the button.  If you slide
       the mouse off the button before releasing it, nothing happens.

       Folder Display.  Below the main buttons is the folder display subwindow.  It has a special
       button for each of your top-level folders, and these are called folder labels.  As  a  new
       user  you  will  see two folder labels, one for inbox and drafts.  The inbox folder is for
       your new messages, and the drafts folder is for messages you are  writing.   If  you  have
       used  MH  (or  xmh)  before,  then you may have many more folders that will appear in this
       display.  The mouse bindings for folder labels are explained in  the  exmh-use  man  page.
       The  Color Legend from the Help menu also tells you how the folder labels respond to mouse
       clicks.

       Folder Cache.  A second folder display called the folder cache may appear under  the  main
       folder display.  This shows the folder labels for recently used folders.  If you only have
       a few folders this wastes screen real estate.  The PREFERENCES section  near  the  end  of
       this  man page explains how to turn this off via the Folder Cache preferences setting.  If
       you are a first-time exmh user, Exmh tries to guess if you need this display based on  the
       number of folders and nested folders you have.

       Folder  Buttons.   The middle set of buttons is for operations that apply to folders.  For
       example, you can create a new folder  with  the  New  button  here.   The  More...  button
       displays  a  popup  menu  with  several more operations you can apply to folders.  Some of
       these buttons will be introduced in this man page.  All of these  buttons  and  menus  are
       explained in detail in the exmh-ref man page.

       To  the  left  of  the  folder  buttons,  summary  information about the current folder is
       displayed.

       Table of Contents.  The middle subwindow of the display shows a summary of the messages in
       the  folder.   It  shows  the  message number, the date of the message, the subject of the
       message, and, space permitting, the first few words of the message.  Left click on a  line
       in  the  table  of contents to view the corresponding message.  The mouse bindings for the
       table of contents are described in more detail in the exmh-use man page.

       MH experts: The display in this window comes from both the  MH  scan  program  or  MH  inc
       programs, so it is affected by the form specification used by these programs.

       Color  and  Monochrome  Highlights.  Both the folder display and table of contents windows
       use highlights to give you visual clues about the state of  messages  and  folders.   Your
       unread  messages  are  highlighted  in  the table of contents and the folders that contain
       unread message are highlighted in the folder display.  Pull down the main  Help  menu  and
       select Color Legend to display a key to the highlights for your display.  The highlighting
       is covered in more detail later in the exmh-use man page.  The exmh-custom man page  tells
       how you can control the highlighting yourself.

       Status  Line.   Just  below the table of contents is the status line.  This has two parts.
       The left part shows the name of the folder and the message number for the current message,
       if  any.   The  right  part  gives feedback about what exmh is doing.  After it displays a
       message, the Subject component is displayed there.

       Subwindow Resize Diamond.  The black diamond to the right of the status line  is  used  to
       change  the size of the internal windows.  Press the first mouse button on this target and
       a horizontal line appears.  Drag it up and down to adjust the window sizes.  Try  dragging
       it  all  the  way  to the top and bottom of the exmh window to see how the mode changes to
       adjust different windows.

       Message Buttons The bottom row of buttons are for operations that  apply  to  the  current
       message.  Several of these operations will be introduced in this man page.  The right hand
       button labeled More... brings up a menu with several more advanced message operations.

       Hint: Many of these message operations have keyboard shortcuts that make it  easy  to  use
       exmh  with  your hands on the keyboard.  Some of the short-cuts are introduced in this man
       page, and all of them are listed in the exmh-use man page.

       Message Display.  The bottom subwindow displays the current message, if any.  Some of  the
       less interesting mail headers start out scrolled off the top of this window.

SENDING MAIL

       A  good  way  to test things out is to send a message to yourself.  Here are the steps you
       take to do that:

       1.  Click the Send button, which is in the Message buttons in the  bottom  group.   A  new
       window  will open that contains the template for your message.  The built-in editor, which
       is called sedit, will start out with the insert cursor positioned at the end of the  first
       empty  header  line.   Enter your user name after the To: header.  If you want to send the
       message to more than one person, use a comma to separate the names.

       2.  Position the insert cursor on the next header line.  You can do this a  few  different
       ways.   The most direct way is to click the left mouse button where you want the cursor to
       be.  There are keyboard shortcuts, too.  If you press <Tab> the editor will  take  you  to
       the  end  of  the  next  header  line.  You can also use the arrow keys or some emacs-like
       bindings to move the cursor.  <Control-n> goes to the next  line,  <Control-f>  moves  the
       cursor  forward  a  character.   <Control-p> moves up a line, and <Control-b> moves back a
       character.  The Simple Edit menu entry shows you all the keybindings.

       3.  The next header is the Cc: line.  People listed in the Cc: line get a  "courtesy"  (or
       "carbon")  copy  of  the  message.  By convention, the message is primarily for the people
       listed in the To: component, and the people in the Cc: component are getting  the  message
       "for information."  In this case, you can leave the Cc: component empty.

       Move  the insert cursor to the Subject: line and enter a Subject.  The people that receive
       your message will get an idea of what the message is about from the  subject,  so  take  a
       moment  to  think  of  a  good one.  For this test, you can type something like "exmh test
       message".

       4.  Make sure the headers are OK.  In particular, make sure there are no  blank  lines  in
       the  headers.   The  mail  system  treats a blank line as meaning "end-of-headers", so you
       don't want to prematurely end the header section.  If you have a blank line, position  the
       insert cursor on it and use Backspace to remove the empty line.

       Position  the cursor at the start of the message body.  You can use the mouse for this, or
       you can press <Tab> twice quickly and the editor will position the cursor correctly.  When
       using the default MH message templates, this will be right after the line of all dashes.

       5.   Type  in  your  message.   When  you  type  in  a  long  message, the lines will wrap
       automatically at word boundaries.  To get a blank line  for  paragraph  boundaries,  press
       <Return>.  The built-in editor supports several editing commands that are based on the GNU
       emacs key bindings.  If you select the Simple Edit menu  entry  under  the  main  Bindings
       menu, you will bring up a dialog that lets you view and edit the key bindings.

       6.  If you are happy with the message, you send it by pressing the Send button at the top-
       right corner of the window.  The Send button will turn grey, and the window will disappear
       once the message has been sent successfully.

       If  you  do  not want to send the message, press the Abort button instead.  If you want to
       save the message draft and continue to work on  it  later,  press  the  Save&Quit  button.
       Working on a saved draft message is described in the exmh-use man page.

       Send yourself a few messages, or have a friend send you a few test messages.  You will use
       these test messages to practice moving around in a folder and deleting messages.  Make one
       of the messages pretty long so you can practice scrolling through it.

       Finally,  try  sending  mh-mime-sample@online.ora.com a message.  This addresses a program
       that will return a MIME message to you.  Just put  this  address  in  the  To  field  with
       anything as the message body and subject.  Reading this message will be described below.

MOUSING AROUND

       The  selection is dragged out with the left mouse button.  You can modify the selection by
       holding the Shift key while pressing the left  button.   A  double-click  begins  a  word-
       oriented  selection,  and  a triple-click begins a line-oriented selection.  If you drag a
       selection off the bottom or top of a window the text will be  scrolled  automatically  and
       the selection will be extended.

       Paste  is  done  with  the middle mouse button.  The current insert point is used, not the
       point at which you middle-click.  If you drag the middle mouse button, then the window  is
       scrolled  instead  as  described  below.   There is also a key-binding for paste, which is
       <Control-y>.  Use <Control-w> or the <Delete> key to delete the selection.

       The middle mouse button is used for "drag-scrolling".  To scroll, simply press the  middle
       mouse  button  over the text and drag the text.  If you press the Shift key, the scrolling
       is faster.  Drag-scrolling works in the text widgets, for vertical scrolling, and the one-
       line  entry  widgets,  for horizontal scrolling.  The text widgets are used to display the
       folder contents and the current message.  The entry widgets are used in various dialogs in
       order to enter values.  You can change the scrolling button to the right button or to only
       work with shift-middle.  Set this up in the Simple Edit Bindings... dialog.

       Buttons and menus are also sensitive to which mouse button  is  pressed.   Only  the  left
       button  activates a button, and it is the <ButtonRelease> event that is important.  If you
       accidentally move the mouse off of the button as you  release  it,  nothing  will  happen.
       Don't worry, the wrong button will not be invoked.

       Press  the left button over a menu button to  pull down a menu.  Most of the menus in exmh
       are distinguished with a "..."  in their label, e.g. "More...".  The  menu  will  go  away
       when  the button is released.  Release the mouse button off the menu if you do not want to
       invoke any menu item.  (In some versions of Tk, the middle button will  "tear  off"  a  Tk
       menu.   This  is  quite  handy if you use the menu often.  To get the menu to go away, you
       must click the left button over the menu button.  This will reattach the menu to the  menu
       button,  and another left click will make the menu go away.  In the latest versions of Tk,
       the first menu entry is a dashed line that invokes this tear-off operation.)

GETTING NEW MAIL

       By now you should have some new mail waiting.  Press the Inc button from the middle set of
       buttons  that  do  Folder  operations.  This will transfer messages from your system spool
       file into your inbox folder.  You will hear an audible cue if there was new mail, and  the
       table of contents will be updated to reflect the new messages in your inbox.  New messages
       will be underlined (on a monochrome screen), or blue (on a color screen), to indicate that
       you have not read them yet.

       To  view  the  new  message, click on its line in the table of contents, or press the Next
       button in the bottom group of buttons.  The  message  will  be  displayed  in  the  bottom
       subwindow,  and  the line in the table of contents will be highlighted to remind you which
       message is being displayed.

       To view the next message, click the Next button.  The keyboard shortcut for  this  is  the
       'n' key.

       The  view  the previous message, click the Prev button.  The keyboard shortcut for this is
       the 'p' key.

       Scrolling through messages.  If you get a message that is too long to fit into the message
       window,  then  the  scrollbar  will  change  its  appearance  to indicate how much text is
       displayed.  The scrollbar is Motif-like.  You can click on the arrows at either end to  go
       up and down one line.  If you click above or below the elevator box you go up and down one
       page.  You can drag the elevator box to scroll, too.

       You can also scroll text windows in exmh by dragging with the middle mouse button.   Press
       the  middle  button over the text area, not the scrollbar, and hold it down while you move
       the mouse up or down.  If you hold the shift key  at  the  same  time,  the  scrolling  is
       faster.  This works in the folder Table of Contents window, too.

       Hint.   The  space  bar  is  a keyboard short-cut that does a combination of scrolling and
       advancing to the next message.  If the message is long, then  space  will  scroll  by  one
       screen.   Once  you are at the end of the message, space will advance to the next message,
       just like the 'n' key.  You can use the BackSpace key to scroll back through a message.

READING MIME MESSAGES

       By  now  you  should  have  also  received  the  sample   MIME   message   from   mh-mime-
       sample@online.ora.com.  The MIME message has three parts to it, and these are numbered and
       labeled in the display.  The first part is a multipart/alternative  content,  which  means
       there  are  a  few  different  ways to view the content.  This is indicated by the message
       under the heading 1. that there are alternative views of the following content.  Exmh will
       go ahead and display what it thinks is the best alternative, and you see the text/enriched
       content displayed in part 1.2.  If you want to see the other alternatives,  then  you  can
       press the right button over section 1 to get a popup menu with some choices.

       The  next  two  parts  are  an  audio clip and a picture in GIF format.  The audio clip is
       handled directly by exmh, and it displays two active text buttons labeled  "Play  attached
       audio"  and  "Save audio file".  Click on either of these with the left mouse button.  The
       part corresponding to the image displays a message about what the type  is,  and  suggests
       that  you  press the right mouse button to display a menu.  You can always press the right
       button to get a MIME menu that has type-specific options for parts of  your  message.   If
       you press the right button over part 2., then the popup menu will offer you these choices:
       Decode part as MIME Save Hello from the author...  View using  mailcap  rule...   Pass  an
       audio  fragment  to metamail...  The first item is a checkbox menu item that lets you view
       the raw content if you want to.  The Save... menu entry displays a file selection  box  so
       you can choose a non-temporary file to store the content.  This same function is available
       through the text button, but not all MIME parts displays buttons like this.  The next  two
       entries  should  result  in  the  same  thing.  They use the mailcap specifications to run
       another program that displays the content.  In the first case, View using mailcap rule...,
       exmh  runs  the  program  directly.   In the other case, Pass to metamail..., the metamail
       program is run first, and it decodes the mailcap  file  and  runs  the  external  program.
       Again, the text button labeled "Play attached audio" also plays the audio.

REPLYING TO MAIL

       Select  one  of  the  messages from your friend that you'd like to answer.  Press the left
       button over the Reply... menu button.  A menu  with  a  few  entries  will  be  displayed.
       Select the Reply to sender menu entry by dragging the mouse down to that entry and letting
       up over it.  The menu entry has a <Key-r> in it, which means that you could also press the
       'r' key to invoke this function.

       This  time the built-in editor will open a window with a message that is partly filled in.
       All the headers are initialized based on the header components from the original  message.
       The built-in editor will automatically position the cursor at the beginning of the message
       body.  You can enter your reply message like you did  with  the  previous  messages.   You
       should  also  double-check  the  header components.  In this case, add yourself to the Cc:
       component so you will get a copy of the reply message.  When you are done, press the  Send
       button in the editor window to send the message.

       There  are  a  number  of  ways to control the format of your reply messages.  The MH repl
       command has several formatting options, and because exmh uses repl to  set  up  the  reply
       message,  you can customize your reply format.  Exmh lets you define several variations on
       reply and add them to the Reply... menu.  This is described in the exmh-custom man page.

       It should not take long for you to get the copy of the reply message.  Wait a minute or so
       and press the Inc button.  The keyboard short-cut for Inc is the 'i' key.

SELECTING MESSAGES

       Before  we  go on to more things you can do with messages, we need to talk about selecting
       multiple messages at once.  Several of the message operations in exmh can operate on a set
       of  messages.   You  can  manually select multiple messages by using the mouse, or you can
       select messages based on their content.

       Using the Mouse.  To select messages with the mouse, press the left button and  then  drag
       out  a  selection.   This will select a contiguous range of messages.  If the messages you
       want to select are not so nicely organized, you can make a disjoint selection  by  holding
       down  the Shift key while making your selection.  This adds new messages to the selection.
       If you shift-click on a message that is already selected, then it becomes unselected.   If
       you  need  to select a lot of messages, simply drag the mouse off the top or bottom of the
       window.  It will be scrolled automatically and the selection will be extended.

SEARCHING

       The Search... menu has several operations for finding messages and finding text  within  a
       message.  There is also a help entry that explains searching in more detail.

       If  you select "Find in message body" or "Find in table of contents" a small search dialog
       appears.  Enter the search string and use the Next or Prev buttons to find the next match.
       When  you  are  searching  over  the  table  of contents, you can select All to select all
       matching messages.

       The other way to search a folder is with "Pick by attributes".  The  MH  pick  program  is
       used  to  search  the  current  folder  for  messages that match mail headers like From or
       Subject.  You can build up boolean expressions among search criteria.  This is a much more
       general search mechanism than the "Find in table of contents" operation.

       Get  started in the Pick dialog by pressing the "Choose pick attribute" button.  A menu of
       attribute types appears, including the Subject, From, To, and Cc header  components.   You
       can  type a regular expression pattern in these entries to search for messages that have a
       matching header component.

       The Before and After attributes are dates.  You can find all messages before  or  after  a
       given  date by using these fields.  You can specify dates as mm/dd/yy.  Be sure to include
       the year.  Dates can also be keywords like "today", "yesterday", "tomorrow", and  any  day
       of the week ("Sunday", "Monday", and so on.)

       The  Search attribute is used to search for something in the body of a message.  This will
       run little slower because pick must read through all of  your  messages,  not  just  their
       headers.

       If  you  select  more than one attribute, pick finds messages that match all the criteria.
       In other words, it does the logical and of the search criteria.  If you want to search for
       this  or  that, then you need to press the Or button in the dialog.  This adds another set
       of fields to the dialog, and pick will search for everything that matches the first set or
       matches the second set.

       The  "Add  to  Sel"  checkbutton  should  be  set before you do the search.  This controls
       whether or not the selected messages are added to any existing selection.

       Finally, use the "Pick" button to do the search.  Once the search has  completed  you  can
       perform  a  few  operations  on  the  selection.   You  can  delete and refile messages as
       described later.  You can also display a new table of  contents  that  only  contains  the
       selected  messages.   Use  the  "New FTOC" button for this.  You can also clear the unseen
       state of the messages with the "Mark Seen" button.

       The "Clear" button resets the fields.

       The two entries in the dialog are used to control MH sequences.  The  only  sequence  exmh
       really  supports well is the "unseen" sequence, although you can define up to 10 sequences
       in each folder.

       If you use New FTOC to get a new scan listing, it would be better if it appeared in a  new
       window,  but  currently  it  replaces  the  table  of  contents.   You can move around and
       manipulate messages in this table of contents.  However, if you do another pick,  it  will
       only find things in this limited table of contents, not the whole folder.  (Yes, this is a
       bug.)  Use the Rescan Folder menu entry in the folder  More...  menu  to  get  a  complete
       folder listing.

FORWARDING MESSAGES

       If  you  want  to send someone a copy of a message or messages that you have received, use
       the Forward message operation.  Select the messages as described in the previous  section,
       then press the Forward button.  The keyboard short-cut for forward is the 'f' key.

       The  message template will have a copy of the selected messages.  You fill in the headers,
       and you can also add a short message before the start of the forwarded messages.  When you
       are done, press Send to forward the messages.

DELETING MESSAGES

       After you have read a message, you might want to remove it to keep your mail folders tidy.
       Exmh uses two steps to remove mail.  In the  first  step  you  mark  a  message  as  being
       deleted.   In  the second step you commit the operations on all marked messages.  It turns
       out that delete just renames your message files.  They will survive until you get  another
       message  by  the  same  number and remove it, too.  In addition, exmh has a "Purge Folder"
       operation that removes these renamed files if they are more than a week old.

       The Delete operation applies to the current message, or you can also  select  a  range  of
       messages by dragging out a selection in the table of contents.  You can delete the current
       message(s) by pressing the Delete button.  The keyboard short-cut is  the  'd'  key.   The
       deleted  message(s)  will  be highlighted after the delete operation so you can easily see
       the state of the message.  On a monochrome screen, a cross hatching will be drawn  through
       the table of contents line for the message.  On a color screen, the table of contents line
       will get a dark grey background.

       After you mark a message for delete, you are automatically advanced to the  next  message.
       This  makes  it  easy  to go through your folder and clean it up.  Click 'd' to delete, or
       click 'n' to leave it alone.

       Hint.  If you are really in a hurry, use 'D' and 'N' as your  keyboard  short-cuts.   This
       prevents  the next message from being displayed, which can be slow for complex multi-media
       messages.

       When you are ready to commit the pending delete actions, press  the  Commit  button.   The
       keyboard shortcut for commit is <Control-Return>.

       If  you  decide  you  do  not  want to delete a message you can unmark it.  Use the Unmark
       (Undo) menu entry that is under the message More... menu.  The unmark operation applies to
       the  current message or messages, so you have to select the messages to unmark first.  The
       keyboard short-cut for unmark is 'u'.

       Hint.  The minus, '-', keyboard shortcut takes you to the previous message, even if it has
       been marked for delete.  Ordinarily the Prev operation, and the 'p' short-cut for it, will
       skip over marked messages.

LEAVING EXMH

       Press the Quit button to leave exmh.  It will take a few moments to close down because  it
       saves  some  state  information  before quitting.  The Quit button will grey out after you
       click it, and you will see a few status messages as it shuts itself down.

PREFERENCES

       Try out the Preferences by turning off the folder cache.  This just takes up display space
       if  you  don't  have  many folders.  If you have lots of nested folders, though, you might
       even want to make this display bigger!

       Click the Preference button, which brings up a dialog that has buttons for several of  the
       modules  that  make  up exmh.  Click on the Folder Cache button to bring up the preference
       items that control the folder cache.  In this case there are just two items: the number of
       lines  of  labels  in  the  cache,  and the names of folders that are always in the cache.
       Click in the first field and backspace over the default value of 1.  Type  in  0  instead,
       and press <Return>.  Voila!  The folder cache disappears.

       If  you  like this setting, press Save on the main Preference dialog and your changes will
       be saved to a file named ~/.exmh-defaults.  Press Reset if you want to undo your  changes.
       You  should  be  a  little careful here, because you are allowed to Dismiss the preference
       dialog without saving.

       Another useful preference item to set is under Background Processing.  You can arrange for
       exmh  to  periodically  run  inc  so your messages are automatically transferred into your
       inbox.  The advantage of doing this is that the folder label highlighting works best  this
       way.   Unfortunately, exmh does not give you any visual clues when mail is only waiting in
       your system spool file.

       More details about the Preferences dialog are given in  the  exmh-use  man  page,  and  an
       overview of the various preference sections is given in the exmh-custom man page..

WHAT IS MH MAIL?

       MH  is  a  collection  of  UNIX programs that store, manipulate, and display your mail. MH
       originated from RAND, and it is now in the public domain.  Exmh uses these programs to  do
       all the hard work, while it concentrates on the user interface.

       You  can  use the MH programs to read your mail.  Run them from the UNIX command line like
       you would cd, ls, cc, or make.  They are useful when you are connecting over a  slow  line
       or  cannot  run  exmh  for  some other reason.  For more details, there are individual man
       pages for each MH program, plus one overview man page called MH.  Below is a short summary
       of the main MH programs used by exmh.

       folder Query or set the current folder.

       inc    Incorporate mail from your system spool file into your folders.

       scan   Display a listing of a mail folder.

       show   Display a mail message.

       next   Display the next mail message.  (Exmh doesn't actually run this.)

       prev   Display the previous mail message.  (Exmh doesn't actually run this.)

       rmm    Delete a mail message.

       refile Move a message into another mail folder.

       repl   Reply to a mail message

       forw   Forward one or more mail messages.

       comp   Compose a new mail message.

       MH  keeps  track of the current folder and the current message in between uses of these MH
       programs.  For example: % scan +inbox  unseen  1713   04/14  foote.PARC@xerox.   Have  you
       started  blasting  cdroms  yet?<<Probably.   1715   04/14  FlashBack Publish  1232: Tactix
       Introduces Break through in Unix Ad 1716  04/14 FlashBack Publish  1234: CERT  Advisory  -
       NCSA  HTTP  Daemon  for  UNIX<  1717  M04/15  To:welch            PGP test<<-----BEGIN PGP
       MESSAGE----- Version: 2 1718 M04/17  flash@flashback.c   mime-flashback-w  MIME  FlashBack
       April 13th, 1995 1719 -04/16 Bill Wohler        Notes for MH Chapters 20-22<<Brent, I have
       been 1720+-04/17 "Allen R. Carl"    Re: Tabs<<Brent, where is this  -tabs  resource  se  %
       show  1717  (Message  1717  displayed) % next (Message 1718 displayed) % rmm (Message 1718
       deleted) % repl 1717 (Set up template for reply to message 1717, invoke editor)

       Each user has a .mh_profile file that stores general MH settings as  well  as  per-command
       settings.  Each line has a key, and a value.  For example, your mail directory is set with
       the Path profile entry: Path: Mail

       If your old mail system uses that directory already, just edit your .mh_profile to  change
       the name used for your MH mail folders.

MORE ABOUT EXMH

       This man page should get you started with exmh.  If you decide you want to know more about
       it, here are some of the features described in the other exmh man pages.

       MIME support.  Exmh can display MIME (Multipurpose  Internet  Mail  Extensions)  messages,
       either  directly  or  with the help of the metamail package.  The built-in editor lets you
       compose enriched text messages and insert files as parts of a multipart message.

       Mail Folders.  You can create other mail folders to hold messages about certain topics  or
       from  certain people.  You can create a hierarchical arrangement of folders, just like the
       hierarchical directory structure of the file system.  The folder  display  supports  these
       nested folders, and it allows you to nest folders to any depth.

       Mail  Filtering.  Mail filtering lets you sort mail into different folders before you read
       it.  If you get lots of mail, this is a great way to avoid plowing through junk mail  just
       to  get  your  important  messages.   The  folder labels are highlighted to indicate which
       folders have unread mail in them.

       Facesaver bitmap display.  If you have a facesaver database on your system, exmh  displays
       the bitmap face of the person that sent the current message (or their organization).

       Background  processing.   You can set exmh to run inc periodically, check for new messages
       arriving asynchronously in folders, run the MH msgchk program, or count up the messages in
       your mail spool file.

       Editor  interface.  You can hook exmh to your favorite editor using the exmh-async script.
       Or, Tcl-based editors such as mxedit can interact with exmh directly.

       Keybinding User Interface.  You can define new key bindings for Tcl commands that are part
       of the implementation.

       Aliases  User  Interface.   A  browser for your MH aliases lets you define new aliases and
       insert aliases into mail messages.

       Pretty Good Privacy (PGP).  If you have PGP, you can use it from exmh to  digitally  sign,
       encrypt, and decrypt messages.

       User Programming.  If the preference settings are not enough for you, you can program exmh
       more directly.  You can define new  buttons  and  menus  and  add  new  Tcl  code  to  its
       implementation.

SEE ALSO

       exmh-use, exmh-ref, exmh-custom, mh

AUTHOR

       Brent Welch, <welch@acm.org>

THANKS

       To  Xerox  PARC/CSL,  for supporting this work initially, to Sun Microsystems Laboratories
       for continuing the support, and to all the exmh users that contributed ideas and code.