+++ /dev/null
-.\"
-.\" %nmhwarning%
-.\"
-.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
-.RI [ +folder1
-.RI [ +folder2
-\&...]]
-.RB [ \-sequence
-.I name1
-.RB [ \-sequence
-.I name2
-\&...]]
-.RB [ \-all " | " \-noall ]
-.RB [ \-showzero " | " \-noshowzero ]
-.RB [ \-recurse " | " \-norecurse ]
-.RB [ \-fast " | " \-nofast ]
-.RB [ \-alpha " | " \-noalpha ]
-.RB [ \-version ]
-.RB [ \-help ]
-.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
-useful if you use some mechanism such as
-.B slocal
-or
-.B procmail
-(typically in conjunction with
-.BR rcvstore )
-to pre-sort your mail into different folders before you view it.
-.PP
-By default, the command
-.B flist
-will search the current folder for the given sequence or sequences (usually
-.RI \*(lq unseen \*(rq).
-If (possibly multiple) folders are specified on the command line with
-.IR +folder ,
-then all these folders are searched for the given sequence(s).
-.B Flist
-will display for each folder searched, the number of messages in each of the
-specified sequences, and the total number of messages.
-.PP
-The option
-.B \-sequence
-is used to specify the name of a sequence in
-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)
-man page.
-.PP
-Typically,
-.B flist
-will produce a line for each sequence, for every
-folder that is searched, even those which do not contain any messages in
-the given sequence. Specifying
-.B \-noshowzero
-will cause
-.B flist
-to print only those folder/sequence combinations such the folder has a non-zero
-number of messages in the given specified sequence.
-.PP
-If
-.B \-recurse
-is given, then for each folder that is search,
-.B flist
-will also recursively descend into those folders to search subfolders
-for the given sequence.
-.PP
-If
-.B \-fast
-is given, only the names of the folders searched will be displayed, and
-.B flist
-will suppress all other output. If this option is used in conjunction with
-.BR \-noshowzero ,
-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"
-If the option
-.B \-all
-is given (and no folders are specified with
-.IR +folder ),
-then
-.B flist
-will search all the folders in the top
-level of the users mmh directory. These folders are all preceded by
-the read\-only folders, which occur as
-.RI \*(lq atr\-cur\- \*(rq
-entries in the user's
-.B mmh
-context.
-.PP
-An example of the output of
-.B flist
-.B \-all
-is:
-.PP
-.RS 5
-.nf
-/work/Mail has 5 in sequence unseen (private); out of 46
-inbox+ has 10 in sequence unseen ; out of 153
-junklist has 0 in sequence unseen ; out of 63
-postmaster has 1 in sequence unseen ; out of 3
-.fi
-.RE
-.PP
-The \*(lq+\*(rq after
-.I inbox
-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)
-man page for details about private sequences.
-.PP
-If the option
-.B \-all
-and
-.I +folder
-are both specified, then
-.B flist
-will search this folder, and all its first level subfolders for the
-given sequence. You may specify multiple folders in this way.
-.PP
-If
-.B flist
-is invoked by a name ending with \*(lqs\*(rq
-(e.g.
-.BR flists ),
-then the switch
-.B \-all
-is assumed by default.
-.PP
-The sorting order for the listing is alphabetical (with
-.BR \-alpha ),
-or in a priority order defined by the
-.RI \*(lq Flist-Order \*(rq
-profile entry (with
-.BR \-noalpha ).
-Each item in the
-.RI \*(lq Flist-Order \*(rq
-is a folder name or a
-folder name pattern that uses * to match zero or more characters.
-Longer matching patterns have precedence over shorter matching patterns.
-For example:
-.PP
-.RS 5
-.nf
-Flist-Order: personal petproject mh* * admin *junk
-.fi
-.RE
-.PP
-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'%etcdir%/ExtraBigFileName 'u
-^$HOME/.mmh/profile~^The user profile
-.fi
-
-.SH "PROFILE COMPONENTS"
-.fc ^ ~
-.nf
-.ta 2.4i
-.ta \w'ExtraBigProfileName 'u
-^Path:~^To determine the user's mail storage
-^Mh-Sequences:~^File that contains public sequences
-^Unseen-Sequence:~^The name of the unseen message sequence
-^Flist-Order:~^To sort folders by priority
-.fi
-
-.SH "SEE ALSO"
-folder(1), rcvstore(1), slocal(1), 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
-
-.SH CONTEXT
-If
-.I +folder
-is given, it will become the current folder.
-If multiple folders are given, the last one specified will
-become the current folder.
projects / mmh / blobdiff