-.TH NEW %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
-.\"
+.TH NEW %manext1% 2009-01-17 "%nmhversion%"
+.
.\" %nmhwarning%
-.\"
+.
.SH NAME
-new \- report on folders with new messages
-.PP
-fnext \- set current folder to next folder with new messages
-.PP
-fprev \- set current folder to previous folder with new messages
-.PP
-unseen \- scan new messages in all folders with new messages
-
+new \- report on nmh folders with new messages
+.br
+fnext \- set current nmh folder to next folder with new messages
+.br
+fprev \- set current nmh folder to previous folder with new messages
+.br
+unseen \- scan any new messages in all nmh folders
.SH SYNOPSIS
.HP 5
.na
.B new
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ sequences ]
.RB [ \-mode
.IR mode ]
.RB [ \-folders
.IR foldersfile ]
-.RB [ \-version ]
-.RB [ \-help ]
-.PP
.HP 5
.B fnext
is equivalent to
.B new \-mode fnext
-.PP
.HP 5
.B fprev
is equivalent to
.B new \-mode fprev
-.PP
.HP 5
.B unseen
is equivalent to
.B new \-mode unseen
.ad
-
.SH DESCRIPTION
-.B New
-in its default mode produces a one\-line\-per\-folder listing of all
-folders containing messages in the listed
-.IR sequences
-or in the sequences listed in the profile entry
+.BR new ,
+in its default mode, produces a one-line-per-folder listing of all
+folders which contain messages in the specified
+.IR sequences ,
+or in the sequence(s) listed in the profile entry
.RI \*(lq Unseen-Sequence \*(rq.
-Each line contains the folder, the number of messages in the desired
-sequences, and the message lists from the .mh_sequences file. For example:
+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:
.PP
.RS 5
.nf
The `*' on foo indicates that it is the current folder. The last line shows
the total number of messages in the desired sequences.
.PP
-.B New
+.B new
crawls the folder hierarchy recursively to find all folders, and prints them
-in lexicographic order. Override this behavior by providing
-.IR foldersfile
-containing the pre-sorted list of folders
+in lexicographic order. Override this behavior by providing a
+.I foldersfile
+containing the pre-sorted list of folders which
.B new
should check, one per line.
.PP
.B fprev
modes,
.B new
-instead changes to the next or previous matching folder, respectively.
+changes to the next or previous matching folder, respectively.
.PP
In
.B unseen
mode,
.B new
executes
-.B scan sequences
+.B scan
+.I sequences
for each matching folder.
-
.SH FILES
-.fc ^ ~
-.nf
-.ta \w'%etcdir%/ExtraBigFileName 'u
-^$HOME/\&.mh\(ruprofile~^The user profile
-.fi
-
+.TP 20
+$HOME/.mh_profile
+The user profile
.SH "PROFILE COMPONENTS"
-.fc ^ ~
-.nf
-.ta 2.4i
-.ta \w'ExtraBigProfileName 'u
-^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
-.fi
-
+.PD 0
+.TP 20
+Path:
+To determine the user's nmh directory.
+.TP 20
+Current\-Folder:
+To find the default current folder.
+.TP 20
+Unseen-Sequence:
+The name of the unseen message sequence.
+.PD
.SH "SEE ALSO"
-scan(1), mh\-format(5)
-
-.SH HISTORY
-Based on Luke Mewburn's new (http://www.mewburn.net/luke/src/new).
+.IR scan (1),
+.IR mh\-format (5)