File: Threading.html

package info (click to toggle)
mh-e 8.0.3-1
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 8,976 kB
  • ctags: 4,351
  • sloc: lisp: 18,183; makefile: 459; sh: 97
file content (155 lines) | stat: -rw-r--r-- 8,788 bytes parent folder | download | duplicates (2)
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
<html lang="en">
<head>
<title>Threading - 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="Searching.html#Searching" title="Searching">
<link rel="next" href="Limits.html#Limits" title="Limits">
<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="Threading"></a>
Next:&nbsp;<a rel="next" accesskey="n" href="Limits.html#Limits">Limits</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Searching.html#Searching">Searching</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>
<hr>
</div>

<h2 class="chapter">16 Viewing Message Threads</h2>

<p><a name="index-threading-1786"></a>
MH-E groups messages by <dfn>threads</dfn> which are messages that are part
of the same discussion and usually all have the same `<samp><span class="samp">Subject:</span></samp>'
header field. Other ways to organize messages in a folder include
limiting (see <a href="Limits.html#Limits">Limits</a>) or using full-text indexed searches
(see <a href="Searching.html#Searching">Searching</a>).

   <p><a name="index-root_002c-in-threads-1787"></a><a name="index-siblings_002c-in-threads-1788"></a><a name="index-ancestor_002c-in-threads-1789"></a>
A thread begins with a single message called a <dfn>root</dfn>. All replies
to the same message are <dfn>siblings</dfn> of each other. Any message that
has replies to it is an <dfn>ancestor</dfn> of those replies.

   <p>There are several commands that you can use to navigate and operate on
threads.

     
<a name="index-T-_003f-1790"></a>
<a name="index-mh_002dprefix_002dhelp-1791"></a>
<dl><dt><kbd>T ?</kbd><dd>Display cheat sheet for the commands of the current prefix in
minibuffer (<code>mh-prefix-help</code>). 
<!--  -->
<a name="index-T-o-1792"></a><a name="index-mh_002dthread_002drefile-1793"></a><br><dt><kbd>T o</kbd><dd>Refile (output) thread into folder (<code>mh-thread-refile</code>). 
<!--  -->
<a name="index-T-d-1794"></a><a name="index-mh_002dthread_002ddelete-1795"></a><br><dt><kbd>T d</kbd><dd>Delete thread (<code>mh-thread-delete</code>). 
<!--  -->
<a name="index-T-t-1796"></a><a name="index-mh_002dtoggle_002dthreads-1797"></a><br><dt><kbd>T t</kbd><dd>Toggle threaded view of folder (<code>mh-toggle-threads</code>). 
<!--  -->
<a name="index-T-n-1798"></a><a name="index-mh_002dthread_002dnext_002dsibling-1799"></a><br><dt><kbd>T n</kbd><dd>Display next sibling (<code>mh-thread-next-sibling</code>). 
<!--  -->
<a name="index-T-p-1800"></a><a name="index-mh_002dthread_002dprevious_002dsibling-1801"></a><br><dt><kbd>T p</kbd><dd>Display previous sibling (<code>mh-thread-previous-sibling</code>). 
<!--  -->
<a name="index-T-u-1802"></a><a name="index-mh_002dthread_002dancestor-1803"></a><br><dt><kbd>T u</kbd><dd>Display ancestor of current message (<code>mh-thread-ancestor</code>). 
</dl>

   <p><a name="index-g_t_0040samp_007bmh_002dthread_007d-customization-group-1804"></a><a name="index-customization-group_002c-_0040samp_007bmh_002dthread_007d-1805"></a>
The `<samp><span class="samp">mh-thread</span></samp>' customization group contains one option.

     <dl>
<dt><code>mh-show-threads-flag</code><a name="index-mh_002dshow_002dthreads_002dflag-1806"></a><dd>On means new folders start in threaded mode (default: `<samp><span class="samp">off</span></samp>'). 
</dl>

   <p><a name="index-mh_002dtoggle_002dthreads-1807"></a><a name="index-T-t-1808"></a><a name="index-mh_002dlarge_002dfolder-1809"></a><a name="index-mh_002dshow_002dthreads_002dflag-1810"></a>
Threading large number of messages can be time consuming so the option
<code>mh-show-threads-flag</code> is turned off by default. If you turn on
this option, then threading will be done only if the number of
messages being threaded is less than <code>mh-large-folder</code>. In any
event, threading can be turned on (and off) with the command <kbd>T t</kbd>
(<code>mh-toggle-threads</code>).

   <p><a name="index-mh_002dthread_002dancestor-1811"></a><a name="index-mh_002dthread_002dnext_002dsibling-1812"></a><a name="index-mh_002dthread_002dprevious_002dsibling-1813"></a><a name="index-T-n-1814"></a><a name="index-T-p-1815"></a><a name="index-T-u-1816"></a>
There are a few commands to help you navigate threads. If you do not
care for the way a particular thread has turned, you can move up the
chain of messages with the command <kbd>T u</kbd>
(<code>mh-thread-ancestor</code>. At any point you can use <kbd>T n</kbd>
(<code>mh-thread-next-sibling</code> or <kbd>T p</kbd>
(<code>mh-thread-previous-sibling</code>) to jump to the next or previous
sibling, skipping the sub-threads. The command <kbd>T u</kbd> can also take
a prefix argument to jump to the message that started everything.

   <p><a name="index-mh_002ddelete_002dsubject_002dor_002dthread-1817"></a><a name="index-mh_002dthread_002ddelete-1818"></a><a name="index-mh_002dthread_002drefile-1819"></a><a name="index-k-1820"></a><a name="index-T-d-1821"></a><a name="index-T-o-1822"></a>
There are threaded equivalents for the commands that delete and refile
messages. For example, <kbd>T o</kbd> (<code>mh-thread-refile</code>) refiles the
current message and all its children. Similarly, the command <kbd>T d</kbd>
(<code>mh-thread-delete</code>) deletes the current message and all its
children. These commands do not refile or delete sibling messages. 
See <a href="Navigating.html#Navigating">Navigating</a>, for a description of the similar command <kbd>k</kbd>
(<code>mh-delete-subject-or-thread</code>).

   <p><a name="index-mh_002dlarge_002dfolder-1823"></a>
If you find that threading is too slow, it may be that you have
<code>mh-large-folder</code> set too high. Also, threading is one of the few
features of MH-E that really benefits from compiling. If you haven't
compiled MH-E, I encourage you to do so<a rel="footnote" href="#fn-1" name="fnd-1"><sup>1</sup></a>.

   <div class="footnote">
<hr>
<h4>Footnotes</h4><p class="footnote"><small>[<a name="fn-1" href="#fnd-1">1</a>]</small> If you're not sure if
MH-E has been byte-compiled, you could try running `<samp><span class="samp">locate
mh-thread.elc</span></samp>' or otherwise find MH-E on your system and ensure that
<samp><span class="file">mh-thread.elc</span></samp> exists. If you have multiple versions and you
find that one is compiled but the other is not, then go into your
`<samp><span class="samp">*scratch*</span></samp>' buffer in Emacs, enter <kbd>load-path C-j</kbd>, and
ensure that the byte-compiled version appears first in the
<code>load-path</code>. If you find that MH-E is not compiled and you
installed MH-E yourself, please refer to the installation directions
in the file <samp><span class="file">README</span></samp> in the distribution.</p>

   <p><hr></div>

   </body></html>