Quick Intro to Exmh

Bugs and comments to Brent Welch, Welch@acm.org

Folder Display

Exmh displays three panes of information. The top pane has a label for each of your MH folders. Each label is highlighted to reflect the state of the folder. There is one current folder, whose table of contents is displayed in the second pane. There is one folder that is the target for operations. There may be several folders that have unread messages in them. Select from the Help... menu to display the key of how folder labels are highlighted. In addition, folders with nested sub-folders have a shadow-box highlight.

Selecting Folders with the Mouse

Left click on a folder label to view the messages in it.

Right click on a folder label to move the current message(s) to the folder.

Shift-Right on a label to link the current message(s) to the folder.

Middle click on a label to view the nested folders beneath it.

Folder Table of Contents

The middle and bottom panes are text windows. Each of these can be scrolled by using the scrollbar or by dragging the display with the middle mouse button.

The middle pane lists the messages in the current folder, which comes from the output of the MH scan command. The display indicates the state of the message: (See under Help... to see how these are marked on your display)

Selecting Messages with the Mouse

Left clicking on an entry causes the message to be displayed in the third, or bottom pane.

Right clicking selects a message but does not display it.

Dragging a selection with the Left button selects a range of messages. You can update a selection with Shift-Left.

Message operations like , , , , and will operate on the whole selected set of messages.

Message Display

The bottom window displays the current message. If you get a MIME message (i.e., multipart or multimedia) the right button brings up a menu that lets you manipulate the parts of MIME messages. Press the right button somewhere over the message part you are interested in.

Exmh supports a large number of keyboard shortcuts so you can keep your hands on the keyboard.

Resizing Sub-windows

The black diamond to the right of the status line is used to change the boundary between the internal sub-windows. To get an idea of how it works, press the first mouse button over the diamond. Drag the horizontal line up to the top of the window and back down to the bottom. Watch the status line to see what sub-window boundary you are changing.

Command buttons

Command buttons are grouped into three sets. The top is for global operations. The middle set is for folder operations. The bottom set is for message operations.

Binding Help

Binding Dialog

Use the binding dialog to change the keybindings for command accelerators. A binding ties an event to a Tcl command.

Event Syntax

Changing a Binding

Defining a New Accelerator

The Define button and the entries at the top are used for new commands. For example, to make <Control-z> close the window, enter
Command: wm iconify .
Key: <Control-z>
and then press the Define button.

Deleting a Binding

Delete bindings by clearing the associated entry and pressing Return.

Your settings are saved in ~/.exmh/exmhbindings

Main Help Index

./usr/share/doc/exmh/html/symlink.html0000644000000000000000000000307711756412601016664 0ustar rootrootExmh symlink attack

Exmh symlink attack

Jan 10, 2001: Exmh made the security news via report to BUGTRAQ about the following:
A problem in the bug reporting system for exmh, an X-based interface for the MH mail, can cause overwriting of arbitrary system files that are writable by the user running exmh. When exmh encounters a problem in its code, it opens a dialog that asks the user what happened and then allows them to send a bug report to the author. If the user chooses to e-mail the bug report, exmh creates the file /tmp/exmhErrorMsg. If the file is a symlink, it will follow the symlink, overwriting the file that it is linked to.

This vulnerability applies to all versions of exmh 2.2 and earlier. However, users of these versions can set the TMPDIR or EXMHTMPDIR environment variables to change the /tmp choice. This feature already exists and you do not need to apply the patch to enable it. Any exmh user can avoid the attack by setting either of these environment variables to a directory they own.

The default of /tmp has been changed with a fix to the env.tcl file that decides which directory to use for temporary files. Instead of using /tmp as the default, the program now uses /tmp/username and ensures that the directory is owned and write-only to the user.

This fix is in exmh-2.3.

Users can apply the patch to their env.tcl, or simply install a new version of that file.

./usr/share/doc/exmh/html/AliasAddr.html0000644000000000000000000000124311756412601017013 0ustar rootroot Aliases and Addresses Help

Aliases and Addresses Help

Exmh supports two different address books, you can use either or both. They are independent of each other. The two address books are:

MH Aliases, as the name implies, are a capability of the MH foundation upon which exmh is built and can be used with other MH tools. The exmh Address Database is supported solely within exmh.

Main Help Index

./usr/share/doc/exmh/html/AddressBk.html0000644000000000000000000001353111756412601017034 0ustar rootroot Address Database Help

Address Database Help

The Address Database is provided to help you automatically track names and email addresses and to perform lookups of partial names and addresses.

Storing data in the Address Database

You can choose to make the address database self-maintaining or you can maintain it "by hand".

For a self-maintaining address database, set "Enable Address Saving" to "on" in the Address Database Preference panel. As you view mail messages the "From" address will be automatically extracted and a corresponding Address Database entry either created or updated.

You may also want to enable automatic deletion of old addresses. Each address in the database is marked with the date of the last message from that address. You can set a "Remove Old Entries" to "on" and set "Days until removal" to the maximum elapsed days from the last message from an address and your address database will be "self cleaning". Note that settings related to "Remove Old Entries" will be ignored if "Enable Address Saving" is not "on".

For a "hand maintained" address database, set "Enable Address Saving" to "off". When you are viewing a message with a sender whose address you wish to keep, press the key defined in the "Key to save an address" field (default is Ctrl-Tab).

Use of LDAP servers

You can also use addresses stored in an LDAP server.

You will need to have openldap installed on your system. Enabling LDAP requires that you add LDAP_Lookup to the "Expand Methods to use" field in the Address Database Preferences window. You will also need to provide the name of the LDAP server and the root for your LDAP search.

Address Expansion: using data from the Address Database

Note: Address expansion is only supported in the exmh Simple Editor (Sedit).

The Address Database can be used to help you address email by using the Sedit "<addrexpand>" key. That key defaults to Control-Tab but may be changed using the Binding.../Simple Edit menu item of the main exmh window.

Address expansion by Address Database lookup is performed by typing a partial name or address in your message (on the "To:", "cc:", "bcc:", or "dcc:" line) and pressing the "<addrexpand>" key. You can expand multiple names, one at a time, by typing a comma followed by another partial name or address and pressing the "<addrexpand>" key again.

The Address Database Browser

You can browse and edit your Address Database using the somewhat mi