exmh man page on DragonFly

Man page or keyword search:  
man Server   44335 pages
apropos Keyword Search (all sections)
Output format
DragonFly logo
[printable version]

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, manage your messages in folders, and adjust some of the exmh fea‐
       tures 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 GET‐
       TING 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 pro‐
       grams,  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  pro‐
       grams  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 cus‐
       tomizing 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 -dis‐
       play 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 subwin‐
       dow.  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 but‐
       ton 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 cur‐
       rent 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 pro‐
       gram  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 dis‐
       play.  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 high‐
       lighting 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  bot‐
       tom  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  informa‐
       tion."  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	 bind‐
       ings.

       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 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
       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 sub‐
       ject.  Reading this message will be described below.

MOUSING AROUND
       The  selection is dragged out with the left mouse button.  You can mod‐
       ify the selection by holding the Shift key while pressing the left but‐
       ton.   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 mid‐
       dle 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,  sim‐
       ply  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  dis‐
       play  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 con‐
       tents will be highlighted to remind you which  message  is  being  dis‐
       played.

       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 appear‐
       ance  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-tempo‐
       rary 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 auto‐
       matically position the cursor at the beginning  of  the	message	 body.
       You  can	 enter	your reply message like you did with the previous mes‐
       sages.  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 mes‐
       sages.  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 mes‐
       sages.

       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 con‐
       tents.  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 for‐
       ward 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  com‐
       mit  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	 back‐
       ground.

       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 Com‐
       mit 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 mes‐
       sage, even if it has been marked for delete.  Ordinarily the Prev oper‐
       ation, 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 dis‐
       play 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.   Unfortu‐
       nately, exmh does not give you any visual clues when mail is only wait‐
       ing 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 sum‐
       mary 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?<<Proba‐
       bly.   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@flash‐
       back.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 metamail pack‐
       age.  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 fold‐
       ers 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  cur‐
       rent 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 Microsys‐
       tems 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)
[top]

List of man pages available for DragonFly

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net