Provided by: nmh_1.2-3ubuntu2_i386 bug

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 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, 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.