1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
|
<html lang="en">
<head>
<title>Sequences - The MH-E Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="The MH-E Manual">
<meta name="generator" content="makeinfo 4.8">
<link title="Top" rel="start" href="index.html#Top">
<link rel="prev" href="Limits.html#Limits" title="Limits">
<link rel="next" href="Junk.html#Junk" title="Junk">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This is version 8.0.3 of `The MH-E
Manual', last updated 2006-11-12.
Copyright (C) 1995, 2001, 2002, 2003, 2005, 2006 Free
Software Foundation, Inc.
The MH-E manual is free documentation; you can redistribute it
and/or modify it under the terms of either:
a. the GNU Free Documentation License, Version 1.2 or any later
version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover Texts, and no Back-Cover
Texts.
b. the GNU General Public License as published by the Free
Software Foundation; either version 2, or (at your option)
any later version.
The MH-E manual is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License or GNU Free Documentation License for more
details.
The GNU General Public License and the GNU Free Documentation
License appear as appendices to this document. You may also
request copies by writing to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<p>
<a name="Sequences"></a>
Next: <a rel="next" accesskey="n" href="Junk.html#Junk">Junk</a>,
Previous: <a rel="previous" accesskey="p" href="Limits.html#Limits">Limits</a>,
Up: <a rel="up" accesskey="u" href="index.html#Top">Top</a>
<hr>
</div>
<h2 class="chapter">18 Using Sequences</h2>
<p><a name="index-g_t_0040samp_007bSequence_007d-menu-1867"></a><a name="index-menu_002c-_0040samp_007bSequence_007d-1868"></a><a name="index-sequences-1869"></a>
For the whole scoop on MH sequences, refer to
`<samp><span class="samp">mh-sequence</span></samp>'(5)<a rel="footnote" href="#fn-1" name="fnd-1"><sup>1</sup></a>. As you've read, several of the MH-E commands can operate on a
sequence, which is a shorthand for a range or group of messages. For
example, you might want to forward several messages to a friend or
colleague. Here's how to manipulate sequences. These commands are also
available in the `<samp><span class="samp">Sequence</span></samp>' menu.
<a name="index-g_t_0040samp_007bSequence-_003e-Toggle-Tick-Mark_007d-menu-item-1870"></a>
<a name="index-menu-item_002c-_0040samp_007bSequence-_003e-Toggle-Tick-Mark_007d-1871"></a>
<a name="index-g_t_0027-1872"></a>
<a name="index-mh_002dtoggle_002dtick-1873"></a>
<dl><dt><kbd>'</kbd><dd>Toggle tick mark of range (<code>mh-toggle-tick</code>).
<!-- -->
<a name="index-S-_003f-1874"></a><a name="index-mh_002dprefix_002dhelp-1875"></a><br><dt><kbd>S ?</kbd><dd>Display cheat sheet for the commands of the current prefix in
minibuffer (<code>mh-prefix-help</code>).
<!-- -->
<a name="index-g_t_0040samp_007bSequence-_003e-Narrow-to-Tick-Sequence_007d-menu-item-1876"></a><a name="index-menu-item_002c-_0040samp_007bSequence-_003e-Narrow-to-Tick-Sequence_007d-1877"></a><a name="index-S-_0027-1878"></a><a name="index-mh_002dnarrow_002dto_002dtick-1879"></a><br><dt><kbd>S '</kbd><dd>Limit to ticked messages (<code>mh-narrow-to-tick</code>).
<!-- -->
<a name="index-g_t_0040samp_007bSequence-_003e-Delete-Message-from-Sequence_002e_002e_002e_007d-menu-item-1880"></a><a name="index-menu-item_002c-_0040samp_007bSequence-_003e-Delete-Message-from-Sequence_002e_002e_002e_007d-1881"></a><a name="index-S-d-1882"></a><a name="index-mh_002ddelete_002dmsg_002dfrom_002dseq-1883"></a><br><dt><kbd>S d</kbd><dd>Delete range from sequence (<code>mh-delete-msg-from-seq</code>).
<!-- -->
<a name="index-g_t_0040samp_007bSequence-_003e-Delete-Sequence_002e_002e_002e_007d-menu-item-1884"></a><a name="index-menu-item_002c-_0040samp_007bSequence-_003e-Delete-Sequence_002e_002e_002e_007d-1885"></a><a name="index-S-k-1886"></a><a name="index-mh_002ddelete_002dseq-1887"></a><br><dt><kbd>S k</kbd><dd>Delete sequence (<code>mh-delete-seq</code>).
<!-- -->
<a name="index-g_t_0040samp_007bSequence-_003e-List-Sequences-in-Folder_002e_002e_002e_007d-menu-item-1888"></a><a name="index-menu-item_002c-_0040samp_007bSequence-_003e-List-Sequences-in-Folder_002e_002e_002e_007d-1889"></a><a name="index-S-l-1890"></a><a name="index-mh_002dlist_002dsequences-1891"></a><br><dt><kbd>S l</kbd><dd>List all sequences in folder (<code>mh-list-sequences</code>).
<!-- -->
<a name="index-g_t_0040samp_007bSequence-_003e-Narrow-to-Sequence_002e_002e_002e_007d-menu-item-1892"></a><a name="index-menu-item_002c-_0040samp_007bSequence-_003e-Narrow-to-Sequence_002e_002e_002e_007d-1893"></a><a name="index-S-n-1894"></a><a name="index-mh_002dnarrow_002dto_002dseq-1895"></a><br><dt><kbd>S n</kbd><dd>Restrict display to messages in sequence (<code>mh-narrow-to-seq</code>).
<!-- -->
<a name="index-g_t_0040samp_007bSequence-_003e-Add-Message-to-Sequence_002e_002e_002e_007d-menu-item-1896"></a><a name="index-menu-item_002c-_0040samp_007bSequence-_003e-Add-Message-to-Sequence_002e_002e_002e_007d-1897"></a><a name="index-S-p-1898"></a><a name="index-mh_002dput_002dmsg_002din_002dseq-1899"></a><br><dt><kbd>S p</kbd><dd>Add range to sequence (<code>mh-put-msg-in-seq</code>).
<!-- -->
<a name="index-g_t_0040samp_007bSequence-_003e-List-Sequences-for-Message_007d-menu-item-1900"></a><a name="index-menu-item_002c-_0040samp_007bSequence-_003e-List-Sequences-for-Message_007d-1901"></a><a name="index-S-s-1902"></a><a name="index-mh_002dmsg_002dis_002din_002dseq-1903"></a><br><dt><kbd>S s</kbd><dd>Display the sequences in which the current message appears
(<code>mh-msg-is-in-seq</code>).
<!-- -->
<a name="index-g_t_0040samp_007bSequence-_003e-Widen-from-Sequence_007d-menu-item-1904"></a><a name="index-menu-item_002c-_0040samp_007bSequence-_003e-Widen-from-Sequence_007d-1905"></a><a name="index-S-w-1906"></a><a name="index-mh_002dwiden-1907"></a><br><dt><kbd>S w</kbd><dd>Remove last restriction (<code>mh-widen</code>).
<!-- -->
<a name="index-mh_002dupdate_002dsequences-1908"></a><br><dt><kbd>M-x mh-update-sequences</kbd><dd>Flush MH-E's state out to MH.
</dl>
<p><a name="index-g_t_0040samp_007bmh_002dsequences_007d-customization-group-1909"></a><a name="index-customization-group_002c-_0040samp_007bmh_002dsequences_007d-1910"></a>
The `<samp><span class="samp">mh-sequences</span></samp>' customization group contains the options
associated with sequences.
<dl>
<dt><code>mh-refile-preserves-sequences-flag</code><a name="index-mh_002drefile_002dpreserves_002dsequences_002dflag-1911"></a><dd>On means that sequences are preserved when messages are refiled
(default: `<samp><span class="samp">on</span></samp>').
<!-- -->
<br><dt><code>mh-tick-seq</code><a name="index-mh_002dtick_002dseq-1912"></a><dd>The name of the MH sequence for ticked messages (default: `<samp><span class="samp">'tick</span></samp>').
<!-- -->
<br><dt><code>mh-update-sequences-after-mh-show-flag</code><a name="index-mh_002dupdate_002dsequences_002dafter_002dmh_002dshow_002dflag-1913"></a><dd>On means flush MH sequences to disk after message is shown (default:
`<samp><span class="samp">on</span></samp>').
</dl>
<p>The following hook is available.
<dl>
<dt><code>mh-unseen-updated-hook</code><a name="index-mh_002dunseen_002dupdated_002dhook-1914"></a><dd>Hook run after the unseen sequence has been updated (default: <code>nil</code>).
</dl>
<p><a name="index-g_t_0040command_007bpick_007d-1915"></a><a name="index-MH-commands_002c-_0040command_007bpick_007d-1916"></a><a name="index-mh_002dput_002dmsg_002din_002dseq-1917"></a><a name="index-S-p-1918"></a>
To place a message in a sequence, use <kbd>S p</kbd>
(<code>mh-put-msg-in-seq</code>). Give <kbd>S p</kbd> a range and you can add all
the messages in a sequence to another sequence (for example, <kbd>C-u
S p SourceSequence <RET> DestSequence <RET></kbd>, see <a href="Ranges.html#Ranges">Ranges</a>).
<p><a name="index-g_t_0040samp_007btick_007d-sequence-1919"></a><a name="index-sequence_002c-_0040samp_007btick_007d-1920"></a><a name="index-ticking-messages-1921"></a><a name="index-mh_002dindex_002dticked_002dmessages-1922"></a><a name="index-mh_002dtoggle_002dtick-1923"></a><a name="index-g_t_0027-1924"></a><a name="index-F-_0027-1925"></a><a name="index-S-p-1926"></a>
One specific use of the <kbd>S p</kbd> command is <kbd>'</kbd>
(<code>mh-toggle-tick</code>) which adds messages to the `<samp><span class="samp">tick</span></samp>'
sequence. This sequence can be viewed later with the <kbd>F '</kbd>
(<code>mh-index-ticked-messages</code>) command (see <a href="Folders.html#Folders">Folders</a>).
<p><a name="index-mh_002dtick_002dseq-1927"></a>
You can customize the option <code>mh-tick-seq</code> if you already use the
`<samp><span class="samp">tick</span></samp>' sequence for your own use. You can also disable all of the
ticking functions by choosing the `<samp><span class="samp">Disable Ticking</span></samp>' item but
there isn't much advantage to that.
<p><a name="index-MH_002dFolder-mode-1928"></a><a name="index-modes_002c-MH_002dFolder-1929"></a><a name="index-mh_002dnarrow_002dto_002dseq-1930"></a><a name="index-mh_002dnarrow_002dto_002dtick-1931"></a><a name="index-mh_002dwiden-1932"></a><a name="index-S-_0027-1933"></a><a name="index-S-n-1934"></a><a name="index-S-w-1935"></a>
Once you've placed some messages in a sequence, you may wish to narrow
the field of view to just those messages in the sequence you've
created. To do this, use <kbd>S n</kbd> (<code>mh-narrow-to-seq</code>). You are
prompted for the name of the sequence. What this does is show only
those messages that are in the selected sequence in the MH-Folder
buffer. In addition, it limits further MH-E searches to just those
messages. To narrow the view to the messages in the `<samp><span class="samp">tick</span></samp>'
sequence, use <kbd>S '</kbd> (<code>mh-narrow-to-tick</code>). When you want to
widen the view to all your messages again, use <kbd>S w</kbd>
(<code>mh-widen</code>).
<p><a name="index-buffers_002c-_0040samp_007b_002aMH_002dE-Sequences_002a_007d-1936"></a><a name="index-g_t_0040samp_007b_002aMH_002dE-Sequences_002a_007d-1937"></a><a name="index-mh_002dlist_002dsequences-1938"></a><a name="index-mh_002dmsg_002dis_002din_002dseq-1939"></a><a name="index-S-l-1940"></a><a name="index-S-s-1941"></a>
You can see which sequences in which a message appears with the
command <kbd>S s</kbd> (<code>mh-msg-is-in-seq</code>). Use a prefix argument to
display the sequences in which another message appears (as in <kbd>C-u
42 S s <RET></kbd>). Or, you can list all sequences in a selected
folder (default is current folder) with <kbd>S l</kbd>
(<code>mh-list-sequences</code>). The list appears in a buffer named
`<samp><span class="samp">*MH-E Sequences*</span></samp>' (see <a href="Miscellaneous.html#Miscellaneous">Miscellaneous</a>).
<p><a name="index-MH-profile-component_002c-_0040samp_007bPrevious_002dSequence_003a_007d-1942"></a><a name="index-g_t_0040samp_007bcur_007d-sequence-1943"></a><a name="index-g_t_0040samp_007bPrevious_002dSequence_003a_007d-MH-profile-component-1944"></a><a name="index-sequence_002c-_0040samp_007bcur_007d-1945"></a><a name="index-sequence_002c-_0040samp_007bPrevious_002dSequence_007d-1946"></a><a name="index-mh_002drefile_002dpreserves_002dsequences_002dflag-1947"></a>
If a message is in any sequence (except
`<samp><span class="samp">Previous-Sequence:</span></samp>'<a rel="footnote" href="#fn-2" name="fnd-2"><sup>2</sup></a> and
`<samp><span class="samp">cur</span></samp>') when it is refiled, then it will still be in those
sequences in the destination folder. If this behavior is not desired,
then turn off the option <code>mh-refile-preserves-sequences-flag</code>.
<p><a name="index-mh_002ddelete_002dmsg_002dfrom_002dseq-1948"></a><a name="index-mh_002ddelete_002dseq-1949"></a><a name="index-d-1950"></a><a name="index-S-d-1951"></a><a name="index-S-k-1952"></a>
If you want to remove a message (or range, see <a href="Ranges.html#Ranges">Ranges</a>) from a
sequence, use <kbd>S d</kbd> (<code>mh-delete-msg-from-seq</code>). If you want
to delete an entire sequence, use <kbd>S k</kbd> (<code>mh-delete-seq</code>). In
the latter case you are prompted for the sequence to delete. Note that
this deletes only the sequence, not the messages in the sequence. If
you want to delete the messages, use <kbd>C-u d</kbd> (see <a href="Reading-Mail.html#Reading-Mail">Reading Mail</a>).
<p><a name="index-g_t_0040samp_007bUnseen_002dSequence_003a_007d-MH-profile-component-1953"></a><a name="index-g_t_0040samp_007bcur_007d-sequence-1954"></a><a name="index-g_t_0040samp_007btick_007d-sequence-1955"></a><a name="index-MH-profile-component_002c-_0040samp_007bUnseen_002dSequence_003a_007d-1956"></a><a name="index-sequence_002c-_0040samp_007bUnseen_002dSequence_007d-1957"></a><a name="index-sequence_002c-_0040samp_007bcur_007d-1958"></a><a name="index-sequence_002c-_0040samp_007btick_007d-1959"></a><a name="index-mh_002dupdate_002dsequences-1960"></a><a name="index-M_002dx-mh_002dupdate_002dsequences-1961"></a><a name="index-q-1962"></a><a name="index-x-1963"></a><a name="index-mh_002dtick_002dseq-1964"></a><a name="index-mh_002dupdate_002dsequences_002dafter_002dmh_002dshow_002dflag-1965"></a>
Three sequences are maintained internally by MH-E and pushed out to MH
when a message is shown. They include the sequence specified by your
`<samp><span class="samp">Unseen-Sequence:</span></samp>' profile component, `<samp><span class="samp">cur</span></samp>', and the
sequence listed by the option <code>mh-tick-seq</code> which is `<samp><span class="samp">tick</span></samp>'
by default. If you do not like this behavior, turn off the option
<code>mh-update-sequences-after-mh-show-flag</code>. You can then update the
state manually with the <kbd>x</kbd>, <kbd>q</kbd>, or <kbd>M-x
mh-update-sequences</kbd> commands.
<p><a name="index-mh_002dseen_002dlist-1966"></a><a name="index-mh_002dunseen_002dupdated_002dhook-1967"></a>
The hook <code>mh-unseen-updated-hook</code> is run after the unseen
sequence has been updated. The variable <code>mh-seen-list</code> can be
used by this hook to obtain the list of messages which were removed
from the unseen sequence.
<p><a name="index-g_t_0040command_007bmark_007d-1968"></a><a name="index-MH-commands_002c-_0040command_007bmark_007d-1969"></a><a name="index-S-n-1970"></a><a name="index-S-w-1971"></a>
With the exceptions of <kbd>S n</kbd> and <kbd>S w</kbd>, the underlying MH
command dealing with sequences is <samp><span class="command">mark</span></samp><a rel="footnote" href="#fn-3" name="fnd-3"><sup>3</sup></a>.
<div class="footnote">
<hr>
<h4>Footnotes</h4><p class="footnote"><small>[<a name="fn-1" href="#fnd-1">1</a>]</small> See the section
<a href="http://rand-mh.sourceforge.net/book/mh/morseq.html">More About Sequences</a> in the MH
book.</p>
<p class="footnote"><small>[<a name="fn-2" href="#fnd-2">2</a>]</small> See `<samp><span class="samp">mh-profile</span></samp>'(5)).</p>
<p class="footnote"><small>[<a name="fn-3" href="#fnd-3">3</a>]</small> See the
section <a href="http://rand-mh.sourceforge.net/book/mh/mmbwm.html">Make Message Bookmarks with mark</a> in the MH book.</p>
<p><hr></div>
</body></html>
|
