flist man page on Cygwin

Man page or keyword search:  
man Server   22533 pages
apropos Keyword Search (all sections)
Output format
Cygwin logo
[printable version]

FLIST(1)							      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  use‐
       ful  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 mul‐
       tiple sequences.	 If this is not given, then the default is  to	search
       for all the sequences specified by the “Unseen-Sequence” profile compo‐
       nent. 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 dis‐
       played, 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..SS "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 direc‐
       tory.  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.

nmh-1.5-2			January 1, 2001			      FLIST(1)
[top]

List of man pages available for Cygwin

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net