NEW(%manext1%)

NAME
new - report on nmh folders with new messages
fnext - set current nmh folder to next folder with new messages
fprev - set current nmh folder to previous folder with new messages
unseen - scan any new messages in all nmh folders

SYNOPSIS

new [-help] [-version] [sequences] [-mode mode] [-folders foldersfile]

fnext is equivalent to new -mode fnext

fprev is equivalent to new -mode fprev

unseen is equivalent to new -mode unseen

DESCRIPTION
new, in its default mode, produces a one-line-per-folder listing of all folders which contain messages in the specified sequences, or in the sequence(s) listed in the profile entry “Unseen-Sequence”. Each line consists of the folder name, the total number of messages in the specified sequences, and a list of messages derived from the .mh_sequence file. For example:

    foo     11.* 40-50
    bar    380.  760-772 824-828
     total    391.

The `*' on foo indicates that it is the current folder. The last line shows the total number of messages in the desired sequences.

new crawls the folder hierarchy recursively to find all folders, and prints them in lexicographic order. Override this behavior by providing a foldersfile containing the pre-sorted list of folders which new should check, one per line.

In fnext and fprev modes, new changes to the next or previous matching folder, respectively.

In unseen mode, new executes scan sequences for each matching folder.

FILES

$HOME/.mh_profile
    The user profile

PROFILE COMPONENTS
Path:
    To determine the user's nmh directory.
Current-Folder:
    To find the default current folder.
Unseen-Sequence:
    The name of the unseen message sequence.

SEE ALSO
scan(1), mh-format(5)