edits after Stephen proofed the man page.

1 files changed, 171 insertions, 72 deletions

diff --git a/xc/programs/xmh/xmh.man b/xc/programs/xmh/xmh.man
index 4d91f7e77..9c8e8c22d 100644
--- a/xc/programs/xmh/xmh.man
+++ b/xc/programs/xmh/xmh.man
@@ -1,4 +1,4 @@
-.\" $XConsortium: xmh.man,v 1.25 91/07/30 20:55:26 converse Exp $
+.\" $XConsortium: xmh.man,v 1.26 91/07/31 21:18:00 converse Exp $
 .TH XMH 1 "Release 5" "X Version 11"
 .SH NAME
 \fIxmh\fR \- send and read mail with an X interface to MH
@@ -22,7 +22,9 @@ This document introduces many aspects of the Athena Widget Set.
 This option specifies an alternate collection of mail folders in which to
 process mail.  The directory is specified as an absolute pathname.
 The default mail path is the value of the Path component in the \fIMH\fP
-profile, or $HOME/Mail if the \fIMH\fR Path is not given in the profile.
+profile, which is determined by the \fBMH\fP environment variable and 
+defaults to $HOME/.mh_profile.  $HOME/Mail will be used as the path if 
+the \fIMH\fP Path is not given in the profile.
 .TP 8
 .B \-initial \fIfolder\fP
 This option specifies an alternate folder which may receive new mail and is
@@ -32,7 +34,11 @@ The default initial folder is ``inbox''.
 .B \-flag
 This option will cause \fIxmh\fR to change the appearance of appropriate
 folder buttons and to request the window manager to change the appearance
-of the \fIxmh\fP icon when new mail has arrived.
+of the \fIxmh\fP icon when new mail has arrived.  By default,
+\fIxmh\fP will change the appearance of the ``inbox'' folder button when
+new mail is waiting.  The application-specific resource \fBcheckNewMail\fP
+can be used to turn off this notification, and the \fI\-flag\fP option will
+still override it.
 .PP
 These three options have corresponding application-specific resources, 
 \fBMailPath\fR, \fBInitialFolder\fR, and \fBMailWaitingFlag\fR, which
@@ -42,7 +48,7 @@ The standard toolkit command line options are given in \fIX(1)\fP.
 
 .SH INSTALLATION
 .PP
-The current version of \fIxmh\fR requires that the user is already set up
+fIxmh\fR requires that the user is already set up
 to use \fIMH\fR, version 6.  To do so, see if there is a file
 called .mh_profile in your home directory.  If it exists, check to see if it
 contains a line that starts with ``Current-Folder''.  If it does, 
@@ -54,11 +60,12 @@ If you do not already have a .mh_profile, you can create one (and
 everything else you need) by typing ``inc'' to the shell.  You should
 do this before using \fIxmh\fR to incorporate new mail.
 .PP
-For more information, refer to the \fImh(1)\fR documentation.
+For more information, refer to the \fImh(1)\fP documentation.
 .PP
-Much of the user interface of \fIxmh\fPis configured in the \fIXmh\fP
+Much of the user interface of \fIxmh\fP is configured in the \fIXmh\fP
 application class defaults file; if this file was not installed properly
-a warning message will appear when \fIxmh\fP is used.
+a warning message will appear when \fIxmh\fP is used.  \fIxmh\fP is 
+backwards compatible with the R4 application class defaults file.
 .PP 
 The default value of the SendBreakWidth resource has changed since R4.
 
@@ -72,7 +79,7 @@ Six buttons with pull-down command menus.
 .TP 4
 .B \-
 A collection of buttons, one for each top level folder. 
-New users of mh will have two folders, ``drafts'' and ``inbox''.
+New users of \fIMH\fP will have two folders, ``drafts'' and ``inbox''.
 .PP
 .TP 4
 .B \-
@@ -99,15 +106,15 @@ If only the first half is grey, then you are looking at the top half of
 your data.  
 The message viewing area will have a horizontal scrollbar if the text
 of the message is wider than the viewing area.
-
+.PP
 You can use the pointer in the scrollbar to change what part of the data is
-visible.  If you click with the middle button, then the top of the grey
+visible.  If you click with pointer button 2, the top of the grey
 area will move to where the pointer is, and the corresponding
-portion of data will be displayed.  If you hold down the middle button,
+portion of data will be displayed.  If you hold down pointer button 2,
 you can drag around the grey area.  This makes it easy to get to the top
-of the data: just press with the middle, drag off the top of the
+of the data: just press with button 2, drag off the top of the
 scrollbar, and release.
-
+.PP
 If you click with button 1, then the data to the right of the
 pointer will scroll to the top of the window.  If you click with pointer
 button 3, then the data at the top of the window will scroll down to where
@@ -115,13 +122,13 @@ the pointer is.
 
 .SS BUTTONBOXES, BUTTONS, AND MENUS
 Any area containing many words or short phrases, each enclosed in a
-rectangle or rounded boundary, is called a \fIbuttonbox\fR.  
+rectangular or rounded boundary, is called a \fIbuttonbox\fR.  
 Each rectangle or rounded area is actually a button that you
 can press by moving the pointer onto it and pressing pointer button 1.
 If a given buttonbox has more buttons in it than can fit, it will
 be displayed with a scrollbar, so you can always scroll to the button you
 want.
-
+.PP
 Some buttons have pull-down menus. 
 Pressing the pointer button while the pointer is over one of these 
 buttons will pull down a menu.  Continuing to hold the button down while 
@@ -137,18 +144,18 @@ they can easily be changed.  Near the right edge of the border between
 each region is a black box, called a \fIgrip\fR.  Simply point to that
 grip with the pointer, press a pointer button, drag up or down, and
 release.  Exactly what happens depends on which pointer button you press.
-
-If you drag with the middle button, then only that border will move.  This
+.PP
+If you drag with the pointer button 2, then only that border will move.  This
 mode is simplest to understand, but is the least useful.
-
+.PP
 If you drag with pointer button 1, then you are adjusting the size of
 the window above.  \fIxmh\fR will attempt to compensate by adjusting some
 window below it.
-
+.PP
 If you drag with pointer button 3, then you are adjusting the size
 of the window below.  \fIxmh\fR will attempt to compensate by adjusting
 some window above it.
-
+.PP
 All windows have a minimum and maximum size; you will never be allowed to
 move a border past the point where it would make a window have an invalid
 size.
@@ -157,7 +164,7 @@ size.
 This section will define the concepts of the selected folder, current folder,
 selected message(s), current message, selected sequence, and current 
 sequence.  Each \fIxmh\fR command is introduced.  
-
+.PP
 For use in customization,
 action procedures corresponding to each command are given; these action
 procedures can be used to customize the user interface, particularly the
@@ -166,26 +173,26 @@ button box created by the application resource \fBCommandButtonCount\fR.
 
 .SS FOLDERS AND SEQUENCES
 A folder contains a collection of mail messages, or is empty.  \fIxmh\fP
-will support folders with one level of subfolders.
-
+supports folders with one level of subfolders.
+.PP
 The selected folder is whichever foldername appears in the bar above the 
 folder buttons.  Note that this is not necessarily the same folder that is
 currently being viewed.  
 To change the selected folder, just press on the desired folder button
 with pointer button 1;
-if that folder has subfolders, select a folder from the pull down menu.
-
+if that folder has subfolders, select a folder from the pull-down menu.
+.PP
 The Table of Contents, or toc, lists the messages in the viewed folder.
 The title bar above the Table of Contents displays the name of the 
 viewed folder.
-
+.PP
 The toc title bar also displays the name of the viewed sequence of messages 
 within the viewed folder.
-Every folder has an ``all'' sequence, which contains all the messages
+Every folder has an implicit ``all'' sequence, which contains all the messages
 in the folder, and initially the toc title bar will show ``inbox:all''.
 
 .SS FOLDER COMMANDS
-The \fIfolder\fR command menu contains commands of a global nature:
+The \fIFolder\fR command menu contains commands of a global nature:
 
 .TP 8
 .B Open Folder
@@ -201,7 +208,7 @@ than the folder menu buttons or the folder menus.
 .TP 8
 .B Open Folder in New Window
 Displays the selected folder in an additional main window.
-Note, however, that you may not reliably display the same folder in more 
+Note, however, that you cannot reliably display the same folder in more 
 than one window at a time, although \fIxmh\fR will not prevent you from trying.
 The corresponding action is \fBXmhOpenFolderInNewWindow()\fR.
 .TP 8
@@ -246,20 +253,22 @@ The selected messages are the same as the highlighted messages, if any.  If no
 messages are highlighted, then the selected messages are considered the same
 as the current message.
 
-The current message is indicated by a '+' next to the message number.  It
-usually corresponds to the message currently being viewed. 
+The current message is indicated by a `+' next to the message number.  It
+usually corresponds to the message currently being viewed.  Upon opening
+a new folder, for example, the current message will be different from the
+viewed message.
 When a message is viewed, the title bar above the view will identify the message.
 
 .SS TABLE OF CONTENTS COMMANDS
 The \fITable of Contents\fP command menu
-contains commands which operate on the open, or viewed folder.
+contains commands which operate on the open, or viewed, folder.
 
 .TP 18
 .B Incorporate New Mail
 Add any new mail received to viewed folder, and set the current
-message to be the first new message.  This command is selectable and will
-execute only if the viewed folder is allowed to receive new mail.
-By default, ``inbox'' is allowed to incorporate new mail.
+message to be the first new message.  This command is selectable in the menu
+and will execute only if the viewed folder is allowed to receive new mail.
+By default, only ``inbox'' is allowed to incorporate new mail.
 The corresponding action is \fBXmhIncorporateNewMail()\fP.
 .TP 18
 .B Commit Changes
@@ -271,8 +280,8 @@ Renumber the messages in this folder so they start with 1 and increment by
 1.  The corresponding action is \fBXmhPackFolder()\fP.
 .TP 18
 .B Sort Folder
-Sort the messages in this folder in chronological order.  As a side
-effect, this also packs the folder.  The corresponding action is
+Sort the messages in this folder in chronological order.  (As a side
+effect, this may also pack the folder.)  The corresponding action is
 \fBXmhSortFolder()\fP.
 .TP 18
 .B Rescan Folder
@@ -351,7 +360,8 @@ The corresponding action is \fBXmhReply()\fP.
 .PP
 .TP 18
 .B Forward
-Create a composition window whose body is initialized to be the contents
+Create a composition window whose body is initialized to contain an
+encapsulation of
 of the selected messages, or the current message if none are highlighted.
 The corresponding action is \fBXmhForward()\fP.
 .PP
@@ -371,9 +381,9 @@ command is \fBXmhUseAsComposition()\fR.
 .B Print
 Print the selected messages, or the current message if none are selected.
 \fIxmh\fR normally prints by invoking
-the \fIenscript\fR(1) command, but this can be customized with the 
+the \fIenscript\fR(1) command, but this can be customized with the \fIxmh\fP
 application-specific resource \fBPrintCommand\fR.
-The action procedure corresponding to this command is \fBXmhPrint()\fR.
+The corresponding action is \fBXmhPrint()\fR.
 
 .SS SEQUENCE COMMANDS
 The \fISequence\fR command menu contains commands pertaining to
@@ -429,7 +439,8 @@ Create a composition window in reply to the viewed message.
 The related action procedure is \fBXmhViewReply()\fR.
 .TP 18
 .B Forward
-Create a composition window whose body is initialized to be the contents of
+Create a composition window whose body is initialized contain an 
+encapsulation of
 the viewed message.  The corresponding action is \fBXmhViewForward()\fR.
 .TP 18
 .B Use As Composition
@@ -467,12 +478,18 @@ The \fIOptions\fR menu contains one entry.
 .B Read in Reverse
 When selected, a check mark appears in the margin of this menu entry.
 Read in Reverse will switch the meaning of the next and previous 
-messages, and will increment in the opposite direction.  This is useful
+messages, and will increment to the current message marker
+in the opposite direction.  This is useful
 if you want to read your messages in the order of most recent first.
 The option acts as a toggle; select it from the menu a second time to
 undo the effect.  The check mark appears when the option is selected.
 
 .SH COMPOSITION WINDOWS
+Composition windows are created by selecting \fBCompose Message\fP
+from the \fIMessage\fP command menu, or by selecting 
+\fBReply\fP or \fBForward\fP or \fBUse as Composition\fP from the
+\fIMessage\fP or \fIView\fP command menu.
+These are used to compose mail messages.
 Aside from the normal text editing functions, there are six command
 buttons associated with composition windows:
 .TP 18
@@ -524,9 +541,10 @@ To select and view a message with a single click, use pointer button
 a folder or a sequence in a single action, make the folder or sequence
 selection with pointer button 2.
 
-To mark the highlighted messages to be moved in a single action,
+To mark the highlighted messages,
 or current message if none have been highlighted,
-use pointer button 3 to select the target folder.
+to be moved to a folder in a single action, use pointer button 3 to select
+the target folder and simultaneously mark the messages.
 Similarly, selecting a sequence with pointer button 3 will add 
 the highlighted or current message(s) to that sequence.
 In both of these operations, the selected folder or sequence 
@@ -647,17 +665,17 @@ the predefined ``all'' sequence.  (The
 sequence ``cur'' is also usually defined for every folder; it consists of
 only the current message.  \fIxmh\fR hides ``cur'' from the user, instead
 placing a ``+'' by the current message.  Also, \fIxmh\fR does not support
-the ``unseen'' sequence, so that one is also hidden from the user.)
+\fIMH\fP's``unseen'' sequence, so that one is also hidden from the user.)
 
 The message sequences for a folder (including one for ``all'') are
 displayed in the ``Sequence'' menu, below the sequence commands.
 The table of contents (also known as the ``toc'') is at any one time
 displaying one message sequence.  This is called the ``viewed sequence'',
-and its name will be displayed in the toc title bar just after the
+and its name will be displayed in the toc title bar after the
 folder name.  Also, at any time one of the sequences in the menu will
 have a check mark next to it.  This is called the ``selected sequence''.
 Note that the viewed sequence and the selected sequence are not necessarily
-the same.  (This all pretty much corresponds to the way the folders work.)
+the same.  (This all pretty much corresponds to the way folders work.)
 
 The \fBOpen Sequence\fR, \fBAdd to Sequence\fR, \fBRemove from Sequence\fR,
 and \fBDelete Sequence\fR commands are active only if the viewed folder
@@ -675,7 +693,7 @@ from a particular person, or with a particular subject, and so on.  You
 can also connect things up with boolean operators, so you can select all
 things from ``weissman'' with a subject containing ``xmh''.
 
-Hopefully, the layout is fairly obvious.  The simplest cases are the
+The layout should be fairly obvious.  The simplest cases are the
 easiest: just point to the proper field and type.  If you enter in more
 than one field, it will only select messages which match all non-empty
 fields.
@@ -702,7 +720,7 @@ look through for potential members of this sequence; it defaults to the
 viewed sequence when ``Pick'' was pressed.
 
 Two more boxes define a date range; only messages within that date range
-will be considered.  These dates must be entered in 822-style format: each
+will be considered.  These dates must be entered in RFC 822-style format: each
 date is of the form ``dd mmm yy hh:mm:ss zzz'', where dd is a one or two
 digit day of the month, mmm is the three-letter abbreviation for a month,
 and yy is a year.  The remaining fields are optional: hh, mm, and ss
@@ -711,8 +729,8 @@ is left out, it defaults to midnight; thus if you select a range of ``7
 nov 86'' \- ``8 nov 86'', you will only get messages from the 7th, as all
 messages on the 8th will have arrived after midnight.
 
-``Date field'' specifies which date field in the header to look at for
-this date range; it probably won't be useful to anyone.  If the sequence
+``Date field'' specifies which field in the header to look at for
+this date range; it defaults to ``Date''.  If the sequence
 you're defining already exists, you can optionally merge the old set with
 the new; that's what the ``Yes'' and ``No'' buttons are all about.
 Finally, you can ``OK'' the whole thing, or ``Cancel'' it.
@@ -931,7 +949,8 @@ Xmh xmh
 The application class name is \fBXmh\fP.
 Application-specific resources are listed below by name.
 Application-specific resource class names always begin with an upper case
-character, but unless noted otherwise, are identical to the instance name.
+character, but unless noted, are otherwise identical to the instance names
+given below.
 .PP
 Any of these options may also be specified on the command line by
 using the X Toolkit Intrinsics resource specification mechanism.
@@ -944,7 +963,7 @@ If \fBTocGeometry\fR, \fBViewGeometry\fR, \fBCompGeometry\fR, or
 specified, then the value of \fBGeometry\fR is used instead.  If the resulting
 height is not specified (e.g., "", "=500", "+0-0"), then the default
 height of windows is calculated from fonts and line counts. If
-the width is not specified (e.g., "", "=x300", "-0+0), then half of the
+the width is not specified (e.g., "", "=x300", "-0+0"), then half of the
 display width is used.  If unspecified, the height of a pick window
 defaults to half the height of the display.
 .PP
@@ -987,8 +1006,8 @@ and \fBrescanInterval\fP.
 .B checkNewMail
 If true, \fIxmh\fP will check at regular intervals to see if new mail
 has arrived for any of the top level folders and any opened subfolders.
-A visual indication will be given if new mail is waiting to be retrieved
-from a top level folder.
+A visual indication will be given if new mail is waiting to be incorporated
+into a top level folder.
 Default is true.
 The interval can be adjusted with \fBmailInterval\fR.
 .PP
@@ -1007,7 +1026,7 @@ the value of the resource is the empty string, or if no `%d' occurs in
 the string, or if "%d" is the value of the resource, the default will be
 used instead.  The default is "%d.CKP".  Checkpointing is done in the 
 folder of origin unless an absolute pathname is given.  \fIxmh\fP does
-not assist the user in recovering checkpoints, nor does it provide 
+not assist the user in recovering checkpoints, nor does it provide for
 removal of the checkpoint files.
 .PP
 .TP 8
@@ -1016,7 +1035,8 @@ The number of command buttons to create in a button box in between the toc
 and the view areas of the main window.  \fIxmh\fP will create these buttons
 with the names \fIbutton1, button2\fP and so on, in a box with the name
 \fIcommandBox\fR.  The user can specify labels and actions for the buttons
-in a private resource file; see the section on Actions.  The default is 0.
+in a private resource file; see the section titled "Actions and Interface
+Customization."  The default is 0.
 .PP
 .TP 8
 .B compGeometry
@@ -1028,7 +1048,8 @@ The name of the symbol used to represent the pointer.  Default is ``left_ptr''.
 .PP
 .TP 8
 .B debug
-Whether or not to print information to stderr as xmh runs.  Default is false.
+Whether or not to print information to stderr as \fIxmh\fP runs.
+Default is false.
 .PP
 .TP 8
 .B draftsFolder
@@ -1064,7 +1085,7 @@ the section on multiple mail drops.
 .TP 8
 .B "mailInterval (\fPclass\fB Interval)"
 Specifies the interval in minutes at which the mail should be checked, if
-\fBmailWaitingFlag\fP or \fBcheckNewMail\fP are true.
+\fBmailWaitingFlag\fP or \fBcheckNewMail\fP is true.
 The default is the value of \fBcheckFrequency\fR.
 .PP
 .TP 8
@@ -1135,7 +1156,7 @@ appended to the specified print command.  The default is ``enscript >/dev/null
 .PP
 .TP 8
 .B replyInsertFilter
-A shell command to be executed when the \fIInsert\fP button is activated
+An \fIsh\fP command to be executed when the \fIInsert\fP button is activated
 in a composition window.  The full path and filename of the source
 message is appended to the command before being passed to \fIsh\fP(1).
 The default filter is \fIcat\fP; i.e. it inserts the entire message
@@ -1145,7 +1166,7 @@ into the composition.  Interesting filters are:
 \fI<mh directory>/lib/mhl \-form mhl.body\fP.
 .PP
 .TP 8
-.B "rescanInterval \fP(Pclass \fBInterval\fP)"
+.B "rescanInterval \fP(class \fBInterval\fP)"
 How often to check the Table of Contents of currently viewed folders
 and of folders with messages currently being viewed, and to update the Table
 of Contents if \fIxmh\fP sees inconsistencies with the file system in these
@@ -1211,7 +1232,7 @@ might want to change this to a private directory.  Default is ``/tmp''.
 .PP
 .TP 8
 .B tocGeometry
-Initial geometry for master \fIxmh\fR windows.
+Initial geometry for main \fIxmh\fR toc and view windows.
 .PP
 .TP 8 
 .B tocPercentage
@@ -1221,8 +1242,10 @@ Contents.  Default is 33.
 .TP 8
 .B tocWidth
 How many characters to generate for each message in a folder's table of
-contents.  Default is 100.  Use 80 if you plan to use \fImhl\fR a lot,
-because it will be faster, and the extra 20 characters may not be useful.
+contents.  Default is 100.  Use less if the geometry of the main \fIxmh\fP
+window results in the listing being clipped at the right hand boundary, or
+if you plan to use \fImhl\fR a lot,
+because it will be faster, and the extra characters may not be useful.
 .PP
 .TP 8
 .B viewGeometry
@@ -1255,7 +1278,7 @@ inbox	/usr/spool/mail/converse
 xpert	/users/converse/maildrops/xpert
 .fi
 .sp
-.SH ACTIONS
+.SH ACTIONS AND INTERFACE CUSTOMIZATION
 .PP
 Because \fIxmh\fR provides action procedures which correspond to command
 functionality and installs accelerators, users can customize accelerators
@@ -1267,9 +1290,65 @@ on \fITranslation Table Syntax\fP.
 Unpredictable results can occur if 
 actions are bound to events or widgets for which they were not designed.
 .PP
+Here's an example of how to bind actions to your own \fIxmh\fP buttons,
+and how to redefine the default accelerators so that the Meta key is 
+not required, in case you don't have access to the sample file mentioned
+above.
+.sp
+.nf
+! To create buttons in the middle of the main window and give them meaning:
+
+Xmh*CommandButtonCount:		6
+
+Xmh*commandBox.button1.label:	Inc
+Xmh*commandBox.button1.translations: #override\
+	<Btn1Down>,<Btn1Up>: XmhIncorporateNewMail() unset()
+
+Xmh*commandBox.button2.label:	Compose
+Xmh*commandBox.button2.translations: #override\
+	<Btn1Down>,<Btn1Up>: XmhComposeMessage() unset()
+
+Xmh*commandBox.button3.label:	Next
+Xmh*commandBox.button3.translations: #override\
+	<Btn1Down>,<Btn1Up>: XmhViewNextMessage() unset()
+
+Xmh*commandBox.button4.label:	Delete
+Xmh*commandBox.button4.translations: #override\
+	<Btn1Down>,<Btn1Up>: XmhMarkDelete() unset()
+
+Xmh*commandBox.button5.label:	Commit
+Xmh*commandBox.button5.translations: #override\
+	<Btn1Down>,<Btn1Up>: XmhCommitChanges() unset()
+
+Xmh*commandBox.button6.label:	Check for Mail
+Xmh*commandBox.button6.translations: #override\
+	<Btn1Down>,<Btn1Up>: XmhCheckForNewMail() unset()
+
+! To redefine the accelerator bindings to exclude modifier keys,
+! and add your own keyboard accelerator for Compose Message:
+
+Xmh*tocMenu.accelerators: #override\n\
+	!:<Key>I:	XmhIncorporateNewMail()\n\
+	!:<Key>C: 	XmhCommitChanges()\n\
+	!:<Key>R:	XmhForceRescan()\n\
+	!:<Key>P:	XmhPackFolder()\n\
+	!:<Key>S:	XmhSortFolder()\n
+Xmh*messageMenu.accelerators: #override\n\
+	!:<Key>E:	XmhComposeMessage()\n\
+	!<Key>space:    XmhViewNextMessage()\n\
+	!:<Key>c:	XmhMarkCopy()\n\
+	!:<Key>d:	XmhMarkDelete()\n\
+	!:<Key>f:	XmhForward()\n\
+	!:<Key>m:	XmhMarkMove()\n\
+	!:<Key>n:	XmhViewNextMessage()\n\
+	!:<Key>p:	XmhViewPreviousMessage()\n\
+	!:<Key>r:	XmhReply()\n\
+	!:<Key>u:	XmhUnmark()\n
+.fi
+.PP
 \fIxmh\fR provides action procedures
 which correspond to entries in the command menus; these are given in the
-sections describing menu commmands.
+sections describing menu commmands, not here.
 In addition to the actions corresponding to commands,
 these action routines are defined:
 .TP 10
@@ -1295,7 +1374,7 @@ of selecting a folder.  This action is for menu button widgets only,
 and sets the selected folder.
 .TP 10
 .B XmhLeaveFolderButton()
-This action insures that the menu button behaves properly when the user
+This action ensures that the menu button behaves properly when the user
 moves the pointer out of the menu button window.
 .TP 10
 .B XmhPushSequence(\fR[\fIsequencename, ...\fR]\fB)\fR
@@ -1310,7 +1389,7 @@ which then becomes the selected sequence.
 This action is equivalent to pressing the okay button in the Create Folder popup.
 .TP 10
 .B XmhReloadSeqLists()
-This action rescans the contents of the public mh sequences for the
+This action rescans the contents of the public \fIMH\fP sequences for the
 currently opened folder and updates the sequence menu if necessary.
 .TP 10
 .B XmhShellCommand(\fI parameter \fR[\fI, parameter\fR]\fB)\fR
@@ -1346,6 +1425,14 @@ or \fIforw\fP, and therefore message components may be customized as
 specified for those commands.  \fIcomp\fP is executed only once per
 invocation of \fIxmh\fP and the message template is re-used for every
 successive new composition.
+.PP
+\fIxmh\fP uses \fIMH\fP commands, including \fIinc\fP, \fImsgchk\fP,
+\fIpick\fP, \fIcomp\fP, \fIsend\fP, \fIrefile\fP, \fIrmm\fP, \fIpack\fP,
+\fIsort\fP, and \fIscan\fP.  Some flags for these commands can be specified
+in the \fIMH\fP profile; \fIxmh\fP may override them.  The application
+resource \fBdebug\fP can be set to true to see how \fIxmh\fP uses \fIMH\fP
+commands.
+
 .SH ENVIRONMENT
 .br
 HOME - users's home directory
@@ -1379,20 +1466,32 @@ composition if the same message is also being viewed in another window.
 The easier solution will be to prevent multiple views of a message which
 is being edited, as opposed to reflecting edits in multiple windows.
 .br
+Occasionally after committing changes, the table of contents will appear 
+to be completely blank when there are actually messages present.
+When this happens, refreshing the display, or typing Control-L in the 
+table of contents, will often cause the correct listing to appear.
+If this doesn't work, force a rescan of the folder.
+.br
 - Should recognize and use the ``unseen'' message-sequence.
 .br
 - Should determine by itself if the user hasn't used \fIMH\fR before, and
 offer to create the .mh_profile, instead of hanging on inc.
 .br
-- Still a few commands missing (rename folder, remail message).
+- A few commands are missing (rename folder, resend message).
 .br
 - WM_DELETE_WINDOW protocol doesn't work right when requesting deletion
 of the first toc and view, while trying to keep other \fIxmh\fP windows around.
 .br
-- Still doesn't support annotations when replying to messages.
+- Doesn't support annotations when replying to messages.
+.br
+- Does not allow folders to be shared without write permission.
+.br
+- Doesn't recognize private sequences.
 .br
-- Does not allow folders to be shared without write permission.  Doesn't
-recognize private sequences.
+- \fIMH\fP will report that the \fI.mh_sequences\fP file is poorly formatted
+if any sequence definition in a particular folder contains more
+than \fIBUFSIZ\fP characters.  \fIxmh\fP tries to capture these messages
+and display them when they occur, but it cannot correct the problem.
 .sp
 .SH COPYRIGHT
 Copyright 1988, 1989, Digital Equipment Corporation.