Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
EXMH TOUR(1)			  INTRO TO EXMH 		    EXMH TOUR(1)

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, man-
     age 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 informa-
     tion 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  sec-
     tion  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  envi-
     ronment.	This  includes a Mail directory which will have one subdirectory
     for each mail folder, plus several files that MH mail uses for its own pur-
     poses.  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  mes-
     sages.   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 pro-
     file.  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  set-
     tings  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, sim-
     ply  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  op-
     tions 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  es-
     tate.   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 opera-
     tions 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 con-
     tents 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 con-
     tents 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 cov-
     ered 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  compo-
     nent 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 differ-
     ent 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  cur-
     sor  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  key-
     bindings.

     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 peo-
     ple 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 Back-
     space 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  tem-
     plates, 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 success-
     fully.

     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 mes-
     sages.  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  ad-
     dresses  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 con-
     tents  and  the current message.  The entry widgets are used in various di-
     alogs 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 but-
     ton 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 up-
     dated to reflect the new messages in your inbox.  New messages will be  un-
     derlined (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  short-
     cut 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/al-
     ternative 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/en-
     riched content displayed in part 1.2.  If you want to see the other  alter-
     natives,  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  au-
     dio  clip is handled directly by exmh, and it displays two active text but-
     tons 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 but-
     ton 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...
     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  func-
     tion  is available through the text button, but not all MIME parts displays
     buttons like this.  The next uses the mailcap specifications to run another
     program that displays the content.  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 en-
     tries 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 com-
     ponents  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  Re-
     ply... 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  opera-
     tions  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 mes-
     sages.  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  selec-
     tion 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" but-
     ton.  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  be-
     fore 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",  "Mon-
     day", and so on.)

     The  Search attribute is used to search for something in the body of a mes-
     sage.  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 crite-
     ria.  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 se-
     lection.

     Finally,  use the "Pick" button to do the search.	Once the search has com-
     pleted 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 ap-
     peared 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  de-
     scribed  in  the previous section, then press the Forward button.	The key-
     board 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  mes-
     sages.

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 op-
     erations  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" op-
     eration 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  high-
     lighted  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 mes-
     sages 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 automati-
     cally 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 com-
     mand 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  pro-
     grams 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  Exten-
     sions)  messages,	either directly or with the help of the mailcap 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 com-
     mands 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.

Exmh 2.0			December 3, 1996		    EXMH TOUR(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=exmh&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help