1FLIST(1)                    General Commands Manual                   FLIST(1)
2
3
4

NAME

6       flist, flists - list the number of nmh messages in given sequences
7

SYNOPSIS

9       flist [-help] [-version] [+folder1 [+folder2 ...]]  [-sequence name1
10            [-sequence name2 ...]]  [-all | -noall] [-showzero | -noshowzero]
11            [-recurse | -norecurse] [-fast | -nofast] [-alpha | -noalpha]
12
13       flists is equivalent to flist -all
14

DESCRIPTION

16       flist  is  used  to  search a list of folders and display the number of
17       messages in these folders that are  in  a  given  sequence  or  set  of
18       sequences (for example the “unseen” sequence).  This is especially use‐
19       ful if you use some mechanism such as slocal or procmail (typically  in
20       conjunction with rcvstore) to pre-sort your mail into different folders
21       before you view it.
22
23       By default, the command flist will search the current  folder  for  the
24       given sequence or sequences (usually “unseen”).  If (possibly multiple)
25       folders are specified on the command line with +folder, then all  these
26       folders are searched for the given sequence(s).  flist will display for
27       each folder searched, the number of messages in each of  the  specified
28       sequences, and the total number of messages.
29
30       The  -sequence  switch  specifies the sequence to which messages should
31       belong.  This switch may be given multiple times  to  specify  multiple
32       sequences.   If  it is not given, then the default is to search for all
33       the sequences specified by  the  “Unseen-Sequence”  profile  component.
34       For more details about sequences, read the mh-sequence(5) man page.
35
36       Typically,  flist  will  produce  a  line  for each sequence, for every
37       folder that is searched, even those which do not contain  any  messages
38       in  the  given  sequence.   Specifying  -noshowzero will cause flist to
39       print only those folder/sequence combinations where the  folder  has  a
40       non-zero number of messages in the given sequence.
41
42       If -recurse is given, then for each folder that is searched, flist will
43       also recursively descend into those folders to  search  subfolders  for
44       the given sequence.
45
46       If  -fast is given, only the names of the folders searched will be dis‐
47       played, and flist will suppress all other output.  If  this  option  is
48       used  in  conjunction  with -noshowzero, then flist will only print the
49       names of those folders searched that contain messages in  in  at  least
50       one of the specified sequences.
51
52   Multiple Folders
53       If  the  -all  switch  is  given  (and  no  folders  are specified with
54       +folder), then flist will search all the folders in the  top  level  of
55       the  users  nmh directory.  These folders are all preceded by the read-
56       only folders, which occur as “atr-cur-” entries in the user's nmh  con‐
57       text.
58
59       An example of the output of flist -all is:
60
61            /work/Mail  has  5 in sequence unseen (private); out of  46
62            inbox+      has 10 in sequence unseen          ; out of 153
63            junklist    has  0 in sequence unseen          ; out of  63
64            postmaster  has  1 in sequence unseen          ; out of   3
65
66       The “+” after inbox indicates that it is the current folder.
67
68       The “private” flag indicates that the given sequence for that folder is
69       private.  See the mh-sequence(5) man page  for  details  about  private
70       sequences.
71
72       If  the  option  -all  and  +folder are both specified, then flist will
73       search this folder, and all its first level subfolders  for  the  given
74       sequence.  You may specify multiple folders in this way.
75
76       If  flist is invoked by a name ending with “s” (e.g.  flists), then the
77       switch -all is assumed by default.
78
79       The sorting order for the listing is alphabetical (with -alpha), or  in
80       a  priority  order  defined  by  the  “Flist-Order” profile entry (with
81       -noalpha).  Each item in the “Flist-Order” is a folder name or a folder
82       name  pattern  that  uses  *  to match zero or more characters.  Longer
83       matching patterns have precedence over shorter matching patterns.   For
84       example:
85
86            Flist-Order: personal petproject mh* * admin *junk
87
88       This  order  puts  a  few interesting folders first, such as those with
89       mail addressed to you personally, those about a pet project, and  those
90       about  mh-related  things.  It places uninteresting folders at the end,
91       and it puts everything else in the middle in alphabetical order.
92

FILES

94       $HOME/.mh_profile   The user's profile.
95

PROFILE COMPONENTS

97       Path:               To determine the user's nmh directory.
98       mh-sequences:       File that contains public sequences.
99       Unseen-Sequence:    The name of the unseen message sequence.
100       Flist-Order:        To sort folders by priority.
101

SEE ALSO

103       folder(1), rcvstore(1), slocal(1), mh-sequence(5)
104

DEFAULTS

106       -sequence           The Unseen-Sequence profile entry.
107       -showzero
108       -noall
109       -norecurse
110       -noalpha
111       -nofast
112

CONTEXT

114       If +folder is given, it will become the current  folder.   If  multiple
115       folders  are  given,  the  last  one  specified will become the current
116       folder.
117
118
119
120nmh-1.7.1                         1999-04-30                          FLIST(1)
Impressum