flist man page on BSDOS

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDOS 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] [-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

[nmh-1.0.4]		      MH.6.8				1

FLIST(1)						 FLIST(1)

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

[nmh-1.0.4]		      MH.6.8				2

FLIST(1)						 FLIST(1)

       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.0.4]		      MH.6.8				3

[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server BSDOS

List of man pages available for BSDOS

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