FLIST(1) [nmh-1.0.4] (MH.6.8) FLIST(1)
NAME
flist, flists - list the number of messages in given
sequence(s)
SYNOPSIS
flist [+folder1 [+folder2 ...]]
[-sequence name1 [-sequence name2 ...]]
[-all] [-noall] [-showzero] [-noshowzero]
[-recurse] [-norecurse] [-alpha] [-noalpha]
[-fast] [-nofast] [-version] [-help]
flists is equivalent to flist-all
DESCRIPTION
This program 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 unseen
sequence). This is especially useful if you use some
mechanism such as slocal or procmail (typically in
conjunction with rcvstore) to pre-sort your mail into
different folders before you view it.
By default, the command flist will search the current folder
for the given sequence or sequences (usually unseen). If
(possibly multiple) folders are specified on the command
line with `+folder', then all these folders are searched for
the given sequence(s). Flist will display for each folder
searched, the number of messages in each of the specified
sequences, and the total number of messages.
The option `-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 "Unseen-Sequence" profile
component. For more details about sequences, read the
mh-sequence(5) man page.
Typically, 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
`-noshowzero' will cause flist to print only those
folder/sequence combinations such the folder has a non-zero
number of messages in the given specified sequence.
If `-recurse' is given, then for each folder that is search,
flist will also recursively descend into those folders to
search subfolders for the given sequence.
If `-fast' is given, only the names of the folders searched
will be displayed, and flist will suppress all other output.
If this option is used in conjunction with `-noshowzero',
Page 1 (printed 2/1/01)
FLIST(1) [nmh-1.0.4] (MH.6.8) FLIST(1)
then flist will only print the names of those folders
searched that contain messages in in at least one of the
specified sequences.
Multiple Folders
If the option `-all' is given (and no folders are specified
with `+folder'), then flist will search all the folders in
the top level of the users nmh directory. These folders are
all preceded by the read-only folders, which occur as
atr-cur- entries in the user's nmh context.
An example of the output of `flist -all' is:
/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
The + after inbox indicates that it is the current folder.
The private flag indicates that the given sequence for that
folder is private. See the mh-sequence(5) man page for
details about private sequences.
If the option `-all' and `+folder' are both specified, then
flist will search this folder, and all its first level
subfolders for the given sequence. You may specify multiple
folders in this way.
If flist is invoked by a name ending with s (e.g., flists ),
then the switch `-all' is assumed by default.
The sorting order for the listing is alphabetical (with
'-alpha'), or in a priority order defined by the Flist-Order
profile entry (with folder name pattern that uses * to match
zero or more characters. Longer matching patterns have
precedence over shorter matching patterns. For example:
Flist-Order: personal petproject mh* * admin *junk
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.
FILES
$HOME/.mh_profile The user profile
PROFILE COMPONENTS
Path: To determine the user's nmh directory
Page 2 (printed 2/1/01)
FLIST(1) [nmh-1.0.4] (MH.6.8) FLIST(1)
mh-sequences: File that contains public sequences
Unseen-Sequence: The name of the unseen message sequence
Flist-Order: To sort folders by priority
SEE ALSO
folder(1), rcvstore(1), slocal(1), mh-sequence(5)
DEFAULTS
`-sequence' defaults to Unseen-Sequence profile entry
`-showzero'
`-noall'
`-norecurse'
`-noalpha'
`-nofast'
CONTEXT
If `+folder' is given, it will become the current folder.
If multiple folders are given, the last one specified will
become the current folder.
Page 3 (printed 2/1/01)
