FLIST(1)							     [nmh-1.5]								  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]
	    [-fast | -nofast] [-alpha | -noalpha] [-version] [-help]

       flists is equivalent to flist -all

DESCRIPTION

       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 "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  multi-
       ple)  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, 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
       -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 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
       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.

MH.6.8								   11 June 2012 							  FLIST(1)