]> diplodocus.org Git - nmh/blobdiff - man/flist.man
Replace getcpy() with mh_xstrdup() where the string isn't NULL.
[nmh] / man / flist.man
index a263a6a498a3d20d00ffeeeea8579204204e767d..a66d8edbdca8818f0439902b1094c9d6c11b55f4 100644 (file)
@@ -1,13 +1,15 @@
+.TH FLIST %manext1% "January 1, 2001" "%nmhversion%"
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
-.TH FLIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 flist, flists \- list the number of messages in given sequence(s)
 .SH SYNOPSIS
 .HP 5
+.na
 .B flist
+.RB [ \-help ]
+.RB [ \-version ]
 .RI [ +folder1
 .RI [ +folder2
 \&...]]
@@ -19,23 +21,22 @@ flist, flists \- list the number of messages in given sequence(s)
 .RB [ \-all " | " \-noall ]
 .RB [ \-showzero " | " \-noshowzero ]
 .RB [ \-recurse " | " \-norecurse ]
-.RB [ \-alpha " | " \-noalpha ]
 .RB [ \-fast " | " \-nofast ]
-.RB [ \-version ]
-.RB [ \-help ]
+.RB [ \-alpha " | " \-noalpha ]
 .PP
 .HP 5
 .B flists
 is equivalent to
 .B flist
 .B \-all
+.ad
 .SH DESCRIPTION
 .B Flist
 is used to search a list of folders and display the number
 of messages in these folders that are in a given sequence or set of
 sequences (for example the
 .RI \*(lq unseen \*(rq
-sequence). This is especially
+sequence).  This is especially
 useful if you use some mechanism such as
 .B slocal
 or
@@ -62,8 +63,8 @@ which to search for.  This option may be used multiple times to specify
 multiple sequences.  If this is not given, then the default is to search
 for all the sequences specified by the
 .RI \*(lq Unseen-Sequence \*(rq
-profile component. For more details about sequences, read the
-.BR mh\-sequence (5)
+profile component.  For more details about sequences, read the
+.IR mh\-sequence (5)
 man page.
 .PP
 Typically,
@@ -93,9 +94,7 @@ will suppress all other output.  If this option is used in conjunction with
 then
 .B flist
 will only print the names of those folders searched that contain messages in
-in at least one of the specified sequences.
-
-.SS "Multiple Folders"
+in at least one of the specified sequences..SS "Multiple Folders"
 If the option
 .B \-all
 is given (and no folders are specified with
@@ -130,7 +129,7 @@ indicates that it is the current folder.
 .PP
 The \*(lqprivate\*(rq flag indicates that the given sequence for
 that folder is private.  See the
-.BR mh\-sequence (5)
+.IR mh\-sequence (5)
 man page for details about private sequences.
 .PP
 If the option
@@ -174,38 +173,46 @@ This order puts a few interesting folders first, such as those with mail
 addressed to you personally, those about a pet project, and those about
 mh-related things.  It places uninteresting folders at the end, and it
 puts everything else in the middle in alphabetical order.
-
 .SH FILES
-.fc ^ ~
-.nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
-.fi
-
+.TP 20
+$HOME/.mh_profile
+The user's profile.
 .SH "PROFILE COMPONENTS"
-.fc ^ ~
-.nf
-.ta 2.4i
-.ta \w'ExtraBigProfileName  'u
-^Path:~^To determine the user's nmh directory
-^mh-sequences:~^File that contains public sequences
-^Unseen-Sequence:~^The name of the unseen message sequence
-^Flist-Order:~^To sort folders by priority
-.fi
-
+.PD 0
+.TP 20
+Path:
+To determine the user's nmh directory.
+.TP
+mh-sequences:
+File that contains public sequences.
+.TP
+Unseen-Sequence:
+The name of the unseen message sequence.
+.TP
+Flist-Order:
+To sort folders by priority.
+.PD
 .SH "SEE ALSO"
-folder(1), rcvstore(1), slocal(1), mh\-sequence(5)
-
+.IR folder (1),
+.IR rcvstore (1),
+.IR slocal (1),
+.IR mh\-sequence (5)
 .SH DEFAULTS
-.nf
-.RB ` -sequence "' defaults to Unseen-Sequence profile entry"
-.RB ` \-showzero '
-.RB ` \-noall '
-.RB ` \-norecurse '
-.RB ` \-noalpha '
-.RB ` \-nofast '
-.fi
-
+.PD 0
+.TP 20
+-sequence
+The Unseen-Sequence profile entry.
+.TP
+\-showzero
+.TP
+\-noall
+.TP
+\-norecurse
+.TP
+\-noalpha
+.TP
+\-nofast
+.PD
 .SH CONTEXT
 If
 .I +folder