MH & nmh: MH Profile
Author: Brent B. Welch

# MH Profile

[previous] [next] [table of contents] [index]

exmh uses several entries from your MH profile (usually named ~/.mh_profile), including several entries that are only for exmh.

`Header-Suppress:` and `Header-Display:`
  You control what header fields are displayed in a message with a combination of the `Header-Suppress:` and `Header-Display:` profile entries. Hidden fields are just scrolled off the top of the message display window. Each profile entry is a list of regular expression patterns that are matched against the field. Case is not significant in the patterns.

  exmh takes three steps to decide whether or not to show a header field.

  1. By default, show all header fields.
  2. If a field is in the Header-Suppress list, don't show it.
  3. If a field is in the Header-Display list, show it.
  Note that a pattern in `Header-Display:` has priority over a pattern in `Header-Suppress:`. The default values for these profile entries are:

      Header-Suppress: .*
      Header-Display: subject to from date cc

  If you are a mail junky, you may want to use Header-Suppress to explicitly suppress the boring header fields you already know about. New, interesting fields inserted by random mailers will be displayed for you to check out. In contrast, the default for Header-Suppress hides everything; you explicitly choose fields you want to see by setting Header-Display.

  So, the effect of the default rules is to show five fields: `Subject:`, `To:`, `From:`, `Date:`, and `cc:`.

`Folder-Order:`
  The `Folder-Order:` entry tells exmh how to order your folder labels in the folder display area. Each item in the order can be either:
  - the name of a folder, or
  - a glob pattern to match on the folder names.
  All folder names that match the same pattern are sorted alphabetically. Longer pattern matches have priority over shorter patterns.

  The glob patterns use the syntax of Tcl's string match function. It's similar to the string matching used in many shells:

  `*` matches a sequence of any characters.
  `?` matches any character.

  The default `Folder-Order:` puts your inbox first:

      Folder-Order: inbox *

  My Folder-Order looks like:

      Folder-Order: personal exmh mxedit * mail* sun m3 mach background

  `Folder-Order:` also tells exmh the order in which to visit folders that have unread mail. When you use Next at the end of a folder, exmh automatically changes to the next folder in `Folder-Order:` that has unseen messages, if any. When no more folders have unseen mail, you're changed to the first folder in your `Folder-Order:` -- unless you disable this by turning off the Cycle back to first preference setting under the Scan Listing section.
`Folder-Unseen:`
  The `Folder-Unseen:` entry lets you tell exmh the names of folders to search for unseen messages. Its value is a set of "glob" patterns that are matched against folder names. Note that glob has filename smarts, so you'll have to take into account subfolders in your glob patterns. (The Chapter Key Parts of the UNIX Filesystem explains how MH stores folders and subfolders in the UNIX filesystem.) For example,
  - Use `inbox*` to match all folders whose names begin with inbox, but not subfolders of inbox;
  - use `inbox/*` to match the first level of subfolders under inbox;
  - use `inbox/*/*` to match the second level; and so on.
`Folder-Ignore:`
  The `Folder-Ignore:` entry is a set of patterns for folder names you want to ignore. The default pattern is `.*`, which causes exmh to ignore all directories whose names begin with a dot (`.`). Your glob patterns for `Folder-Ignore:` must take subfolders into account -- in the same way as `Folder-Unseen:`.
`Draft-Folder:`
  The `Draft-Folder:` entry is the name of a folder for messages being composed. If you don't have a `Draft-Folder:` entry, exmh asks if it may create one. The Section Draft Folder has more information.
`ExmhShowProc:`
  The `ExmhShowProc:` entry lets you define a program that pre-filters a message before displaying it. If `ExmhShowProc:` is defined, exmh runs that program with the current message as the standard input; exmh displays the program's standard output. Note that the `Header-Suppress:` and `Header-Display:` mechanisms are used even if you have a special showproc.
`Scan-Proc:`
  The `Scan-Proc:` entry can be used to define an alternative scan program. (For more information, see the Section MH Format Strings.)

  If you change the scan format, be sure that the message number is first on each scan line and that there is at least one space after the message number. exmh depends on this.

`MailDrop:`
  The `MailDrop:` entry is required if you don't have your system mailbox in the "standard" location, which is typically /usr/spool/mail/`username`. If you don't define `MailDrop:` correctly then `Inc` won't do anything because it won't find your new messages in the system mailbox.
`Path:`
  The `Path:` entry is used to find your mail folders. exmh aborts if this entry is missing; it presumes that you haven't set up MH properly. The Section Changing MH Directory Name has more information.

[Table of Contents] [Index] [Previous: Binding User Interface] [Next: X Resources]

(This section was written by Brent Welch.)
Last change $Date: 1999/10/10 05:14:05 $

This file is from the third edition of the book MH & xmh: Email for Users & Programmers, ISBN 1-56592-093-7, by Jerry Peek. Copyright © 1991, 1992, 1995 by O'Reilly & Associates, Inc. This file is freely available; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation. For more information, see the file copying.htm.