5 .TH FLIST %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
7 flist, flists \- list the number of messages in given sequence(s)
19 .RB [ \-all " | " \-noall ]
20 .RB [ \-showzero " | " \-noshowzero ]
21 .RB [ \-recurse " | " \-norecurse ]
22 .RB [ \-alpha " | " \-noalpha ]
23 .RB [ \-fast " | " \-nofast ]
34 is used to search a list of folders and display the number
35 of messages in these folders that are in a given sequence or set of
36 sequences (for example the
37 .RI \*(lq unseen \*(rq
38 sequence). This is especially
39 useful if you use some mechanism such as
43 (typically in conjunction with
45 to pre-sort your mail into different folders before you view it.
47 By default, the command
49 will search the current folder for the given sequence or sequences (usually
50 .RI \*(lq unseen \*(rq).
51 If (possibly multiple) folders are specified on the command line with
53 then all these folders are searched for the given sequence(s).
55 will display for each folder searched, the number of messages in each of the
56 specified sequences, and the total number of messages.
60 is used to specify the name of a sequence in
61 which to search for. This option may be used multiple times to specify
62 multiple sequences. If this is not given, then the default is to search
63 for all the sequences specified by the
64 .RI \*(lq Unseen-Sequence \*(rq
65 profile component. For more details about sequences, read the
71 will produce a line for each sequence, for every
72 folder that is searched, even those which do not contain any messages in
73 the given sequence. Specifying
77 to print only those folder/sequence combinations such the folder has a non-zero
78 number of messages in the given specified sequence.
82 is given, then for each folder that is search,
84 will also recursively descend into those folders to search subfolders
85 for the given sequence.
89 is given, only the names of the folders searched will be displayed, and
91 will suppress all other output. If this option is used in conjunction with
95 will only print the names of those folders searched that contain messages in
96 in at least one of the specified sequences.
98 .SS "Multiple Folders"
101 is given (and no folders are specified with
105 will search all the folders in the top
106 level of the users nmh directory. These folders are all preceded by
107 the read\-only folders, which occur as
108 .RI \*(lq atr\-cur\- \*(rq
109 entries in the user's
113 An example of the output of
120 /work/Mail has 5 in sequence unseen (private); out of 46
121 inbox+ has 10 in sequence unseen ; out of 153
122 junklist has 0 in sequence unseen ; out of 63
123 postmaster has 1 in sequence unseen ; out of 3
127 The \*(lq+\*(rq after
129 indicates that it is the current folder.
131 The \*(lqprivate\*(rq flag indicates that the given sequence for
132 that folder is private. See the
134 man page for details about private sequences.
140 are both specified, then
142 will search this folder, and all its first level subfolders for the
143 given sequence. You may specify multiple folders in this way.
147 is invoked by a name ending with \*(lqs\*(rq
152 is assumed by default.
154 The sorting order for the listing is alphabetical (with
156 or in a priority order defined by the
157 .RI \*(lq Flist-Order \*(rq
161 .RI \*(lq Flist-Order \*(rq
162 is a folder name or a
163 folder name pattern that uses * to match zero or more characters.
164 Longer matching patterns have precedence over shorter matching patterns.
169 Flist-Order: personal petproject mh* * admin *junk
173 This order puts a few interesting folders first, such as those with mail
174 addressed to you personally, those about a pet project, and those about
175 mh-related things. It places uninteresting folders at the end, and it
176 puts everything else in the middle in alphabetical order.
181 .ta \w'/usr/local/nmh/etc/ExtraBigFileName 'u
182 ^$HOME/\&.mh\(ruprofile~^The user profile
184 .SH "PROFILE COMPONENTS"
188 .ta \w'ExtraBigProfileName 'u
189 ^Path:~^To determine the user's nmh directory
190 ^mh-sequences:~^File that contains public sequences
191 ^Unseen-Sequence:~^The name of the unseen message sequence
192 ^Flist-Order:~^To sort folders by priority
195 folder(1), rcvstore(1), slocal(1), mh\-sequence(5)
199 .RB ` -sequence "' defaults to Unseen-Sequence profile entry"
209 is given, it will become the current folder.
210 If multiple folders are given, the last one specified will
211 become the current folder.