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  dis­
       play 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 dif­
       ferent 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  dis­
       play  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 com­
       ponent.   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

       least one of the specified sequences.

   Multiple Folders
       If  the  option `-all' is given (and no folders are speci­
       fied with `+folder'), then flist will search all the fold­
       ers  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 pat­
       terns 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

       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.


Man(1) output converted with man2html