The application class name is Xmh.
Application-specific resources are listed below by name.
Application-specific resource class names always begin with an upper case
character, but unless noted, are otherwise identical to the instance names
given below.
Any of these options may also be specified on the command line by
using the X Toolkit Intrinsics resource specification mechanism.
Thus, to run
xmh showing all message headers,
% xmh -xrm '*HideBoringHeaders:off'
If TocGeometry, ViewGeometry, CompGeometry, or
PickGeometry are not
specified, then the value of Geometry 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
display width is used. If unspecified, the height of a pick window
defaults to half the height of the display.
The following resources are defined:
banner
A short string that is the default label of the folder, Table of Contents,
and view. The default shows the program name, vendor, and release.
blockEventsOnBusy
Whether to disallow user input and show a busy cursor while xmh is
busy processing a command. If false, the user can `mouse ahead' and
type ahead; if true, user input is discarded when processing lengthy
mh commands. The default is true.
busyCursor
The name of the symbol used to represent the position of the pointer,
displayed if blockEventsOnBusy is true, when xmh is
processing a time-consuming command.
The default is "watch".
busyPointerColor
The foreground color of the busy cursor. Default is XtDefaultForeground.
checkFrequency
How often to check for new mail, make checkpoints, and rescan the Table
of Contents, in minutes. If checkNewMail is true, xmh checks
to see if you have new mail each interval. If makeCheckpoints is
true, checkpoints are made every fifth interval. Also every fifth
interval, the Table of Contents is checked for inconsistencies with the
file system, and rescanned if out of date. To prevent all of these checks
from occurring, set CheckFrequency to 0. The default is 1.
This resource is retained for backward compatibility with user resource
files; see also checkpointInterval, mailInterval,
and rescanInterval.
checkNewMail
If true, xmh 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 incorporated
into a top level folder.
Default is true.
The interval can be adjusted with mailInterval.
checkpointInterval (class Interval)
Specifies in minutes how often to make checkpoints of volatile state,
if makeCheckpoints is true.
The default is 5 times the value of checkFrequency.
checkpointNameFormat
Specifies how checkpointed files are to be named. The value of this
resource will be used to compose a file name by inserting the message
number as a string in place of the required single occurrence of `%d'. If
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. xmh does
not assist the user in recovering checkpoints, nor does it provide for
removal of the checkpoint files.
commandButtonCount
The number of command buttons to create in a button box in between the toc
and the view areas of the main window. xmh will create these buttons
with the names button1, button2 and so on, in a box with the name
commandBox. The default is 0.
xmh users can specify labels and actions for the buttons in a private
resource file; see the section ACTIONS AND INTERFACE CUSTOMIZATION.
compGeometry
Initial geometry for windows containing compositions.
cursor
The name of the symbol used to represent the pointer. Default is ``left_ptr''.
debug
Whether or not to print information to stderr as xmh runs.
Default is false.
draftsFolder
The folder used for message drafts. Default is ``drafts''.
geometry
Default geometry to use. Default is none.
hideBoringHeaders
If ``on'', then xmh will attempt to skip uninteresting header lines
within messages by scrolling them off the top of the view.
Default is ``on''.
initialFolder
Which folder to display on startup. May also be set with the command-line
option -initial. Default is ``inbox''.
initialIncFile
The absolute path name of your incoming mail drop file.
In some installations, for example those using the Post Office Protocol,
no file is appropriate.
In this case, initialIncFile should not be specified,
or may be specified as the empty string,
and inc will be invoked without a -file argument.
By default, this resource has no value.
This resource is ignored if xmh finds an .xmhcheck file; see
the section on multiple mail drops.
mailInterval (class Interval)
Specifies the interval in minutes at which the mail should be checked, if
mailWaitingFlag or checkNewMail is true.
The default is the value of checkFrequency.
mailPath
The full path prefix for locating your mail folders. May also be set
with the command line option, -path. The default is the
Path component in the MH profile, or ``$HOME/Mail'' if none.
mailWaitingFlag
If true, xmh will attempt to set an indication in its icon when
new mail is waiting to be retrieved. If mailWaitingFlag is true, then
checkNewMail is assumed to be true as well. The -flag command
line option is a quick way to turn on this resource.
makeCheckpoints
If true, xmh will attempt to save checkpoints of volatile edits.
The default is false. The frequency of checkpointing is controlled by the
resource checkpointInterval. For the location of checkpointing, see
checkpointNameFormat.
mhPath
What directory in which to find the MH commands. If a command isn't
found in the user's path, then the path specified here is used.
Default is ``/usr/local/mh6''.
newMailBitmap (class NewMailBitmap)
The bitmap to show in the folder button when a folder has new mail.
The default is ``black6''.
newMailIconBitmap (class NewMailBitmap)
The bitmap suggested to the window manager for the icon when any folder
has new mail. The default is ``flagup''.
noMailBitmap (class NoMailBitmap)
The bitmap to show in the folder button when a folder has no new mail.
The default is ``box6''.
noMailIconBitmap (class NoMailBitmap)
The bitmap suggested to the window manager for the icon when no folders
have new mail. The default is ``flagdown''.
pickGeometry
Initial geometry for pick windows.
pointerColor
The foreground color of the pointer. Default is XtDefaultForeground.
prefixWmAndIconName
Whether to prefix the window and icon name with "xmh: ". Default is true.
printCommand
An sh command to execute to print a message. Note that stdout and
stderr must be specifically redirected. If a message or range of messages is
selected for printing, the full file paths of each message file are
appended to the specified print command. The default is ``enscript >/dev/null
2>/dev/null''.
replyInsertFilter
An sh command to be executed when the Insert 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 sh(1).
The default filter is cat; i.e. it inserts the entire message
into the composition. Interesting filters are:
sed 's/^/> /' or
awk -e '{print " " $0}' or
<mh directory>/lib/mhl -form mhl.body.
rescanInterval (class Interval)
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 xmh sees inconsistencies with the file system in these
folders.
The default is 5 times the value of checkFrequency.
reverseReadOrder
When true, the next message will be the message prior to the current message
in the table of contents, and the previous message will be the message
after the current message in the table of contents. The default is false.
sendBreakWidth
When a message is sent from xmh, lines longer than this value will be
split into multiple lines, each of which is no longer than SendWidth.
This value may be overridden for a single message by inserting an additional
line in the message header of the form SendBreakWidth: value. This
line will be removed from the header before the message is sent.
The default is 2000 (to allow for sending mail containing source patches).
sendWidth
When a message is sent from xmh, lines longer than SendBreakWidth
characters will be split into multiple lines, each of which is no longer than
this value.
This value may be overridden for a single message by inserting an additional
line in the message header of the form SendWidth: value. This
line will be removed from the header before the message is sent.
The default is 72.
showOnInc
Whether to automatically show the current message after incorporating new
mail. Default is true.
skipCopied
Whether to skip over messages marked for copying when using ``View Next
Message'' and ``View Previous Message''. Default is true.
skipDeleted
Whether to skip over messages marked for deletion when using ``View Next
Message'' and ``View Previous Message''. Default is true.
skipMoved
Whether to skip over messages marked for moving to other folders when
using ``View Next Message'' and ``View Previous Message''. Default is true.
stickyMenu
If true, when popup command menus are used, the most recently selected
entry will be under the cursor when the menu pops up. Default is false.
See the file clients/xmh/Xmh.sample for an example of how to
specify resources for popup command menus.
tempDir
Directory for xmh to store temporary files. For privacy, a user
might want to change this to a private directory. Default is ``/tmp''.
tocGeometry
Initial geometry for main xmh toc and view windows.
tocPercentage
The percentage of the main window that is used to display the Table of
Contents. Default is 33.
tocWidth
How many characters to generate for each message in a folder's table of
contents. Default is 100. Use less if the geometry of the main xmh
window results in the listing being clipped at the right hand boundary, or
if you plan to use mhl a lot,
because it will be faster, and the extra characters may not be useful.
viewGeometry
Initial geometry for windows showing a view of a message.