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, 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-Se-
       quence  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 se-
       lect 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  ap-
       pear  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 in-
       troduced	in this	man page.  All of these	 buttons  and  menus  are  ex-
       plained 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 de-
       scribed 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 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 be-
       low.  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 op-
       tions 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
       function	 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 but-
       ton 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  re-
       ply  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 ex-
       plains 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  ex-
       pressions  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 ex-
       isting 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, al-
       though 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  an-
       other 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 Re-
       set  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 re-
       source  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	 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)

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.0>

home | help