]> diplodocus.org Git - nmh/blobdiff - man/new.man
lock_file.c: close(2) file descriptor on failure, avoiding leak.
[nmh] / man / new.man
index f9b4c22d091db79d905a8d863eda8811d5b28068..b059d22da40d363a2a1207ff8295178d68df172a 100644 (file)
@@ -1,15 +1,15 @@
-.TH NEW %manext1% "January 17, 2009" "%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
@@ -21,31 +21,29 @@ unseen \- scan new messages in all folders with new messages
 .IR mode ]
 .RB [ \-folders
 .IR foldersfile ]
-.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
@@ -60,9 +58,9 @@ the total number of messages in the desired sequences.
 .PP
 .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
@@ -72,18 +70,19 @@ and
 .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
 .TP 20
-$HOME/\&.mh\(ruprofile
+$HOME/.mh_profile
 The user profile
 .SH "PROFILE COMPONENTS"
 .PD 0