new.c: Order two return statements to match comment.

[nmh] / man / new.man

diff --git a/man/new.man b/man/new.man
index e95e7de7759bb9d04a874634826cc95deb7beebd..b059d22da40d363a2a1207ff8295178d68df172a 100644 (file)
--- a/man/new.man
+++ b/man/new.man
@@ -1,51 +1,49 @@
-.TH NEW %manext1% "January 17, 2009" "%nmhversion%"
-.\"
+.TH NEW %manext1% 2009-01-17 "%nmhversion%"
+.

 .\" %nmhwarning%
 .\" %nmhwarning%

-.\"
+.

 .SH NAME
 .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
 .SH SYNOPSIS
 .HP 5
 .na
 .B new

+.RB [ \-help ]
+.RB [ \-version ]

 .RI [ sequences ]
 .RB [ \-mode
 .IR mode ]
 .RB [ \-folders
 .IR foldersfile ]
 .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
 .HP 5
 .B fnext
 is equivalent to
 .B new \-mode fnext

-.PP

 .HP 5
 .B fprev
 is equivalent to
 .B new \-mode fprev
 .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
 .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.
 .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
 .PP
 .RS 5
 .nf


@@ -58,11 +56,11 @@ bar    380.  760\-772 824\-828
 The `*' on foo indicates that it is the current folder.  The last line shows
 the total number of messages in the desired sequences.
 .PP
 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
 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 new
 should check, one per line.
 .PP


@@ -72,30 +70,32 @@ and
 .B fprev
 modes,
 .B new
 .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
 .PP
 In
 .B unseen
 mode,
 .B new
 executes

-.B scan sequences
+.B scan
+.I sequences

 for each matching folder.
 .SH FILES
 for each matching folder.
 .SH FILES

-.fc ^ ~
-.nf
-.ta \w'%nmhetcdir%/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
-.fi
+.TP 20
+$HOME/.mh_profile
+The user profile

 .SH "PROFILE COMPONENTS"
 .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"
 .IR scan (1),
 .IR mh\-format (5)
 .SH "SEE ALSO"
 .IR scan (1),
 .IR mh\-format (5)