head 1.4; access; symbols; locks; strict; comment @# @; 1.4 date 2006.05.29.14.31.25; author jpeek; state Exp; branches; next 1.3; 1.3 date 2006.05.28.04.27.15; author jpeek; state Exp; branches; next 1.2; 1.2 date 2006.05.26.23.59.01; author jpeek; state Exp; branches; next 1.1; 1.1 date 2006.05.26.22.12.09; author jpeek; state Exp; branches; next ; desc @mh-e_66.html page from mh-e section of "MH & nmh: Email for Users & Programmers" @ 1.4 log @Removed 'html/' from end of http://mh-e.sourceforge.net/manual/html/ URLs @ text @ BOOK MOVED: mh-e - Customizing Scan Line Formats

BOOK MOVED: mh-e - Customizing Scan Line Formats

This section of MH & nmh: Email for Users & Programmers is now the MH-E Manual. It's moved to http://mh-e.sourceforge.net/manual/.

If you aren't taken to the new site in 15 seconds, please click on the link above.

You may also want to visit:


Last change $Date: 2006/05/28 04:27:15 $
Suggestions are welcome: Bill Wohler <wohler@@newt.com>
@ 1.3 log @removed 'Tour-Through-MH_002dE.html' from end of http://mh-e.sourceforge.net/manual/html/ @ text @d4 1 a4 1 content="15;URL=http://mh-e.sourceforge.net/manual/html/"> d15 2 a16 2 href="http://mh-e.sourceforge.net/manual/html/"> http://mh-e.sourceforge.net/manual/html/. d39 1 a39 1 Last change $Date: 2006/05/26 23:59:01 $ @ 1.2 log @Replaced with page pointing people to new MH-E Manual @ text @d4 1 a4 1 content="15;URL=http://mh-e.sourceforge.net/manual/html/Tour-Through-MH_002dE.html"> d15 2 a16 2 href="http://mh-e.sourceforge.net/manual/html/Tour-Through-MH_002dE.html"> http://mh-e.sourceforge.net/manual/html/Tour-Through-MH_002dE.html. d39 1 a39 1 Last change $Date: 2006/05/26 22:12:05 $ @ 1.1 log @Original version from Feb 19 2001 @ text @d3 2 d7 39 a45 163 mh-e - Customizing Scan Line Formats Go to the first, previous, next, last section, table of contents.


Scan line formatting

The name of the program that generates a listing of one line per message is held in mh-scan-prog (default: `"scan"'). Unless this variable contains an absolute pathname, it is assumed to be in the mh-progs directory. You may link another program to scan (see mh-profile(5)) to produce a different type of listing.

If you change the format of the scan lines you'll need to tell mh-e how to parse the new format. As you see, quite a lot of variables are involved to do that. The first variable has to do with pruning out garbage.

mh-valid-scan-line
This regular expression describes a valid scan line. This is used to eliminate error messages that are occasionally produced by inc or scan (default: `"^ *[0-9]"').

Next, two variables control how the message numbers are parsed.

mh-msg-number-regexp
This regular expression is used to extract the message number from a scan line. Note that the message number must be placed in quoted parentheses, (\\(...\\)), as in the default of `"^ *\\([0-9]+\\)"'.
mh-msg-search-regexp
Given a message number (which is inserted in `%d'), this regular expression will match the scan line that it represents (default: `"^[^0-9]*%d[^0-9]"').

Finally, there are a slew of variables that control how mh-e marks up the scan lines.

mh-cmd-note
Number of characters to skip over before inserting notation (default: 4). Note how it relates to the following regular expressions.
mh-deleted-msg-regexp
This regular expression describes deleted messages (default: `"^....D"'). See also mh-note-deleted.
mh-refiled-msg-regexp
This regular expression describes refiled messages (default: `"^....\\^"'). See also mh-note-refiled.
mh-cur-scan-msg-regexp
This regular expression matches the current message (default: `"^....\\+"'). See also mh-note-cur.
mh-good-msg-regexp
This regular expression describes which messages should be shown when mh-e goes to the next or previous message. Normally, deleted or refiled messages are skipped over (default: `"^....[^D^]"').
mh-note-deleted
Messages that have been deleted to are marked by this string (default: `"D"'). See also mh-deleted-msg-regexp.
mh-note-refiled
Messages that have been refiled are marked by this string (default: `"^"'). See also mh-refiled-msg-regexp.
mh-note-copied
Messages that have been copied are marked by this string (default: `"C"').
mh-note-cur
The current message (in MH, not in mh-e) is marked by this string (default: `"+"'). See also mh-cur-scan-msg-regexp.
mh-note-repl
Messages that have been replied to are marked by this string (default: `"-"').
mh-note-forw
Messages that have been forwarded are marked by this string (default: `"F"').
mh-note-dist
Messages that have been redistributed are marked by this string (default: `"R"').
mh-note-printed
Messages that have been printed are marked by this string (default: `"P"').
mh-note-seq
Messages in a sequence are marked by this string (default: `"%"').


Go to the first, previous, next, last section, table of contents. @