1FLIST(1) [nmh-1.3] FLIST(1)
2
3
4
6 flist, flists - list the number of messages in given sequence(s)
7
9 flist [+folder1 [+folder2 ...]] [-sequence name1 [-sequence name2
10 ...]] [-all | -noall] [-showzero | -noshowzero] [-recurse |
11 -norecurse] [-fast | -nofast] [-alpha | -noalpha] [-version]
12 [-help]
13
14 flists is equivalent to flist -all
15
17 Flist is used to search a list of folders and display the number of
18 messages in these folders that are in a given sequence or set of
19 sequences (for example the “unseen” sequence). This is especially use‐
20 ful if you use some mechanism such as slocal or procmail (typically in
21 conjunction with rcvstore) to pre-sort your mail into different folders
22 before you view it.
23
24 By default, the command flist will search the current folder for the
25 given sequence or sequences (usually “unseen”). If (possibly multiple)
26 folders are specified on the command line with +folder, then all these
27 folders are searched for the given sequence(s). Flist will display for
28 each folder searched, the number of messages in each of the specified
29 sequences, and the total number of messages.
30
31 The option -sequence is used to specify the name of a sequence in which
32 to search for. This option may be used multiple times to specify mul‐
33 tiple sequences. If this is not given, then the default is to search
34 for all the sequences specified by the “Unseen-Sequence” profile compo‐
35 nent. For more details about sequences, read the mh-sequence(5) man
36 page.
37
38 Typically, flist will produce a line for each sequence, for every
39 folder that is searched, even those which do not contain any messages
40 in the given sequence. Specifying -noshowzero will cause flist to
41 print only those folder/sequence combinations such the folder has a
42 non-zero number of messages in the given specified sequence.
43
44 If -recurse is given, then for each folder that is search, flist will
45 also recursively descend into those folders to search subfolders for
46 the given sequence.
47
48 If -fast is given, only the names of the folders searched will be dis‐
49 played, and flist will suppress all other output. If this option is
50 used in conjunction with -noshowzero, then flist will only print the
51 names of those folders searched that contain messages in in at least
52 one of the specified sequences.
53
54
55 Multiple Folders
56 If the option -all is given (and no folders are specified with
57 +folder), then flist will search all the folders in the top level of
58 the users nmh directory. These folders are all preceded by the
59 read-only folders, which occur as “atr-cur-” entries in the user's nmh
60 context.
61
62 An example of the output of flist -all is:
63
64 /work/Mail has 5 in sequence unseen (private); out of 46
65 inbox+ has 10 in sequence unseen ; out of 153
66 junklist has 0 in sequence unseen ; out of 63
67 postmaster has 1 in sequence unseen ; out of 3
68
69 The “+” after inbox indicates that it is the current folder.
70
71 The “private” flag indicates that the given sequence for that folder is
72 private. See the mh-sequence(5) man page for details about private
73 sequences.
74
75 If the option -all and +folder are both specified, then flist will
76 search this folder, and all its first level subfolders for the given
77 sequence. You may specify multiple folders in this way.
78
79 If flist is invoked by a name ending with “s” (e.g. flists), then the
80 switch -all is assumed by default.
81
82 The sorting order for the listing is alphabetical (with -alpha), or in
83 a priority order defined by the “Flist-Order” profile entry (with
84 -noalpha). Each item in the “Flist-Order” is a folder name or a folder
85 name pattern that uses * to match zero or more characters. Longer
86 matching patterns have precedence over shorter matching patterns. For
87 example:
88
89 Flist-Order: personal petproject mh* * admin *junk
90
91 This order puts a few interesting folders first, such as those with
92 mail addressed to you personally, those about a pet project, and those
93 about mh-related things. It places uninteresting folders at the end,
94 and it puts everything else in the middle in alphabetical order.
95
96
98 $HOME/.mh_profile The user profile
99
100
102 Path: To determine the user's nmh directory
103 mh-sequences: File that contains public sequences
104 Unseen-Sequence: The name of the unseen message sequence
105 Flist-Order: To sort folders by priority
106
107
109 folder(1), rcvstore(1), slocal(1), mh-sequence(5)
110
111
113 `-sequence' defaults to Unseen-Sequence profile entry
114 `-showzero'
115 `-noall'
116 `-norecurse'
117 `-noalpha'
118 `-nofast'
119
120
122 If +folder is given, it will become the current folder. If multiple
123 folders are given, the last one specified will become the current
124 folder.
125
126
127
128MH.6.8 1 June 2008 FLIST(1)