1FLIST(1) General Commands Manual FLIST(1)
2
3
4
6 flist, flists - list the number of nmh messages in given sequences
7
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
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 se‐
18 quences (for example the “unseen” sequence). This is especially useful
19 if you use some mechanism such as slocal or procmail (typically in con‐
20 junction 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 mh-sequence(5).
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 mh-sequence(5) for details about private sequences.
70
71 If the option -all and +folder are both specified, then flist will
72 search this folder, and all its first level subfolders for the given
73 sequence. You may specify multiple folders in this way.
74
75 If flist is invoked by a name ending with “s” (e.g. flists), then the
76 switch -all is assumed by default.
77
78 The sorting order for the listing is alphabetical (with -alpha), or in
79 a priority order defined by the “Flist-Order” profile entry (with
80 -noalpha). Each item in the “Flist-Order” is a folder name or a folder
81 name pattern that uses * to match zero or more characters. Longer
82 matching patterns have precedence over shorter matching patterns. For
83 example:
84
85 Flist-Order: personal petproject mh* * admin *junk
86
87 This order puts a few interesting folders first, such as those with
88 mail addressed to you personally, those about a pet project, and those
89 about mh-related things. It places uninteresting folders at the end,
90 and it puts everything else in the middle in alphabetical order.
91
93 $HOME/.mh_profile The user's profile.
94
96 Path: To determine the user's nmh directory.
97 mh-sequences: File that contains public sequences.
98 Unseen-Sequence: The name of the unseen message sequence.
99 Flist-Order: To sort folders by priority.
100
102 folder(1), rcvstore(1), slocal(1), mh-sequence(5)
103
105 -sequence The Unseen-Sequence profile entry.
106 -showzero
107 -noall
108 -norecurse
109 -noalpha
110 -nofast
111
113 If +folder is given, it will become the current folder. If multiple
114 folders are given, the last one specified will become the current
115 folder.
116
117
118
119nmh-1.8 1999-04-30 FLIST(1)