FLIST(%manext1%)

NAME
flist - list folders that contain messages in given sequence

SYNOPSIS
flist [+folder1 [+folder2 ...]] [-sequence name] [-all]
[-noall] [-alpha] [-noalpha] [-recurse] [-norecurse]
[-total] [-nototal] [-version] [-help]

DESCRIPTION
This program lists those folders that contain messages in a given sequence. The option `-sequence' is used to specify the name of the sequence to search for. If this is not given, then the default is to search for the sequence specified by the "Unseen-Sequence" profile component. This is especially useful if you use some mechanism such as slocal or procmail (usually in conjunction with rcvstore) to pre-sort your mail into different folders before you view it. Flist will list those top level folders containing the given sequence, and for each folder displayed, it will output the number of messages that are in the given sequence and the total number of messages. If folders are specified on the command line with `+folder', then only those folders are search for the given sequence. An example of the output is:
+inbox          8 in sequence unseen, out of 153
+junklist       2 in sequence unseen, out of  63
+postmaster     1 in sequence unseen, out of   3
Specifying `-all' will produce a line for each folder in the user's nmh directory. If `-recurse' is given, then flist will recursively search subfolders for the given sequence. If `-nototal' is given, only the names of the folders containing the given sequence (or the names of all the folders in the case of `-all') will be displayed, and will suppress the output of the total number of messages in the folder. The sorting order for the listing is alphabetical (with '-alpha'), or in a priority order defined by the Flist-Order profile entry (with '-noalpha'). Each item in the Flist-Order 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:
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 shoves uninteresting folders to the end, and it puts everything else in the middle in alphabetical order. ^$HOME/.mh_profile~^The user profile ^Path:~^To determine the user's nmh directory ^Unseen-Sequence:~^The name of the unseen message sequence ^Flist-Order:~^To sort folders by priority folder(1), procmail(1), rcvstore(1), slocal(1) `-noall' `-noalpha' `-norecurse' `-total'