Man Linux: Main Page and Category List

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.