Quassia Gnus v0.11.
[elisp/gnus.git-] / texi / gnusref.tex
1 % include file for the Gnus refcard and booklet
2 \def\progver{5.0}\def\refver{5.0} % program and refcard versions
3 \def\date{16 September 1995}
4 \def\author{Vladimir Alexiev $<$vladimir@cs.ualberta.ca$>$}
5 \raggedbottom\raggedright
6 \newlength{\logowidth}\setlength{\logowidth}{6.861in}
7 \newlength{\logoheight}\setlength{\logoheight}{7.013in}
8 \newlength{\keycolwidth}
9 \newenvironment{keys}[1]% #1 is the widest key
10   {\nopagebreak%\noindent%
11    \settowidth{\keycolwidth}{#1}%
12    \addtolength{\keycolwidth}{\tabcolsep}%
13    \addtolength{\keycolwidth}{-\columnwidth}%
14    \begin{tabular}{@{}l@{\hspace{\tabcolsep}}p{-\keycolwidth}@{}}}%
15   {\end{tabular}\\}
16 \catcode`\^=12 % allow ^ to be typed literally
17 \newcommand{\B}[1]{{\bf#1})}    % bold l)etter
18
19 \def\Title{
20 \begin{center}
21 {\bf\LARGE Gnus \progver\ Reference \Guide\\}
22 %{\normalsize \Guide\ version \refver}
23 \end{center}
24 }
25
26 \newcommand\Logo[1]{\centerline{
27 \makebox[\logoscale\logowidth][l]{\vbox to \logoscale\logoheight
28 {\vfill\special{psfile=gnuslogo.#1}}\vspace{-\baselineskip}}}}
29
30 \def\CopyRight{
31 \begin{center}
32 Copyright \copyright\ 1995 Free Software Foundation, Inc.\\*
33 Copyright \copyright\ 1995 \author.\\*
34 Created from the Gnus manual Copyright \copyright\ 1994 Lars Magne
35 Ingebrigtsen.\\*
36 and the Emacs Help Bindings feature (C-h b).\\*
37 Gnus logo copyright \copyright\ 1995 Luis Fernandes.\\*
38 \end{center}
39
40 Permission is granted to make and distribute copies of this reference
41 \guide{} provided the copyright notice and this permission are preserved on
42 all copies.  Please send corrections, additions and suggestions to the
43 above email address. \Guide{} last edited on \date.
44 }
45
46 \def\Notes{
47 \subsec{Notes}
48 {\samepage
49 Gnus is complex. Currently it has some 346 interactive (user-callable)
50 functions. Of these 279 are in the two major modes (Group and
51 Summary/Article). Many of these functions have more than one binding, some
52 have 3 or even 4 bindings. The total number of keybindings is 389. So in
53 order to save 40\% space, every function is listed only once on this
54 \guide, under the ``more logical'' binding. Alternative bindings are given
55 in parentheses in the beginning of the description.
56
57 Many Gnus commands are affected by the numeric prefix. Normally you enter a
58 prefix by holding the Meta key and typing a number, but in most Gnus modes
59 you don't need to use Meta since the digits are not self-inserting. The
60 prefixed behavior of commands is given in [brackets]. Often the prefix is
61 used to specify:
62
63 \quad [distance] How many objects to move the point over.
64
65 \quad [scope] How many objects to operate on (including the current one).
66
67 \quad [p/p] The ``Process/Prefix Convention'': If a prefix is given then it
68 determines how many objects to operate on. Else if there are some objects
69 marked with the process mark \#, these are operated on. Else only the
70 current object is affected.
71
72 \quad [level] A group subscribedness level. Only groups with a lower or
73 equal level will be affected by the operation. If no prefix is given,
74 `gnus-group-default-list-level' is used.  If
75 `gnus-group-use-permanent-levels', then a prefix to the `g' and `l'
76 commands will also set the default level.
77
78 \quad [score] An article score. If no prefix is given,
79 `gnus-summary-default-score' is used.
80 %Some functions were not yet documented at the time of creating this
81 %\guide and are clearly indicated as such.
82 \\*[\baselineskip]
83 \begin{keys}{C-c C-i}
84 C-c C-i & Go to the Gnus online {\bf info}.\\
85 C-c C-b & Send a Gnus {\bf bug} report.\\
86 \end{keys}
87 }}
88
89 \def\GroupLevels{
90 \subsec{Group Subscribedness Levels}
91 The table below assumes that you use the default Gnus levels.
92 Fill your user-specific levels in the blank cells.\\[1\baselineskip]
93
94 \begin{tabular}{|c|l|l|}
95 \hline
96 Level & Groups & Status \\
97 \hline
98 1 & mail groups   &              \\
99 2 & mail groups   &              \\
100 3 &               & subscribed   \\
101 4 &               &              \\
102 5 & default list level &         \\
103 \hline
104 6 &               & unsubscribed \\
105 7 &               &              \\
106 \hline
107 8 &               & zombies      \\
108 \hline
109 9 &               & killed       \\
110 \hline
111 \end{tabular}
112 }
113
114 \def\Marks{
115 \subsec{Mark Indication Characters}
116 {\samepage If a command directly sets a mark, it is shown in parentheses.\\*
117 \newlength{\markcolwidth}
118 \settowidth{\markcolwidth}{` '}% widest character
119 \addtolength{\markcolwidth}{4\tabcolsep}
120 \addtolength{\markcolwidth}{-\columnwidth}
121 \newlength{\markdblcolwidth}
122 \setlength{\markdblcolwidth}{\columnwidth}
123 \addtolength{\markdblcolwidth}{-2\tabcolsep}
124 \begin{tabular}{|c|p{-\markcolwidth}|}
125 \hline
126 \multicolumn{2}{|p{\markdblcolwidth}|}{{\bf ``Read'' Marks.}
127   All these marks appear in the first column of the summary line, and so
128   are mutually exclusive.}\\ 
129 \hline
130 ` ' & (M-u, M SPC, M c) Not read.\\
131 !   & (!, M !, M t) Ticked (interesting).\\
132 ?   & (?, M ?) Dormant (only followups are interesting).\\
133 C   & (C, S c) {\bf Canceled} (only for your own articles).\\
134 E   & (E, M e, M x) {\bf Expirable}. Only has effect in mail groups.\\
135 \hline\hline
136 \multicolumn{2}{|p{\markdblcolwidth}|}{The marks below mean that the article
137   is read (killed, uninteresting), and have more or less the same effect.
138   Some commands however explicitly differentiate between them (e.g.\ M
139   M-C-r, adaptive scoring).}\\
140 \hline
141 r   & (d, M d, M r) Deleted (marked as {\bf read}).\\
142 C   & (M C; M C-c; M H; c, Z c; Z n; Z C) Killed by {\bf catch-up}.\\
143 O   & {\bf Old} (marked read in a previous session).\\
144 K   & (k, M k; C-k, M K) {\bf Killed}.\\
145 R   & {\bf Read} (viewed in actuality).\\
146 X   & Killed by a kill file.\\
147 Y   & Killed due to low score.\\
148 \hline\multicolumn{2}{c}{\vspace{1ex}}\\\hline
149 \multicolumn{2}{|p{\markdblcolwidth}|}{{\bf Other marks}}\\
150 \hline
151 \#  & (\#, M \#, M P p) Processable (will be affected by the next operation).\\
152 A   & {\bf Answered} (followed-up or replied).\\
153 +   & Over default score.\\
154 $-$ & Under default score.\\
155 =   & Has children (thread underneath it). Add `\%e' to
156       `gnus-summary-line-format'.\\
157 \hline
158 \end{tabular}
159 }}
160
161 \def\GroupMode{
162 \sec{Group Mode}
163 \begin{keys}{C-c M-C-x}
164 RET     & (=) Select this group. [Prefix: how many (read) articles to fetch.
165 Positive: newest articles, negative: oldest ones.]\\
166 SPC     & Select this group and display the first unread article. [Same
167 prefix as above.]\\ 
168 ?       & Give a very short help message.\\
169 $<$     & Go to the beginning of the Group buffer.\\
170 $>$     & Go to the end of the Group buffer.\\
171 ,       & Jump to the lowest-level group with unread articles.\\
172 .       & Jump to the first group with unread articles.\\
173 ^       & Enter the Server buffer mode.\\
174 a       & Post an {\bf article} to a group.\\
175 b       & Find {\bf bogus} groups and delete them.\\
176 c       & Mark all unticked articles in this group as read ({\bf catch-up}).
177 [p/p]\\ 
178 g       & Check the server for new articles ({\bf get}). [level]\\
179 j       & {\bf Jump} to a group.\\
180 m       & {\bf Mail} a message to someone.\\
181 n       & Go to the {\bf next} group with unread articles. [distance]\\
182 p       & (DEL) Go to the {\bf previous} group with unread articles.
183 [distance]\\ 
184 q       & {\bf Quit} Gnus.\\
185 r       & Read the init file ({\bf reset}).\\
186 s       & {\bf Save} the `.newsrc.eld' file (and `.newsrc' if
187 `gnus-save-newsrc-file').\\ 
188 z       & Suspend (kill all buffers of) Gnus.\\
189 B       & {\bf Browse} a foreign server.\\
190 C       & Mark all articles in this group as read ({\bf Catch-up}). [p/p]\\
191 F       & {\bf Find} new groups and process them.\\
192 N       & Go to the {\bf next} group. [distance]\\
193 P       & Go to the {\bf previous} group. [distance]\\
194 Q       & {\bf Quit} Gnus without saving any startup (.newsrc) files.\\
195 R       & {\bf Restart} Gnus.\\
196 V       & Display the Gnus {\bf version} number.\\
197 Z       & Clear the dribble buffer.\\
198 C-c C-d & Show the {\bf description} of this group. [Prefix: re-read it
199 from the server.]\\ 
200 C-c C-s & {\bf Sort} the groups by name, number of unread articles, or level
201 (depending on `gnus-group-sort-function').\\
202 C-c C-x & Run all expirable articles in this group through the {\bf expiry} 
203 process.\\
204 C-c M-C-x & Run all articles in all groups through the {\bf expiry} process.\\
205 C-x C-t & {\bf Transpose} two groups.\\
206 M-d     & {\bf Describe} ALL groups. [Prefix: re-read the description from the
207 server.]\\
208 M-f     & Fetch this group's {\bf FAQ} (using ange-ftp).\\
209 M-g     & Check the server for new articles in this group ({\bf get}). [p/p]\\
210 M-n     & Go to the {\bf previous} unread group on the same or lower level.
211 [distance]\\ 
212 M-p     & Go to the {\bf next} unread group on the same or lower level.
213 [distance]\\ 
214 \end{keys}
215 }
216
217 \def\GroupCommands{
218 \subsec{List Groups}
219 {\samepage
220 \begin{keys}{A m}
221 A a     & (C-c C-a) List all groups whose names match a regexp ({\bf
222 apropos}).\\ 
223 A d     & List all groups whose names or {\bf descriptions} match a regexp.\\ 
224 A k     & (C-c C-l) List all {\bf killed} groups.\\
225 A m     & List groups that {\bf match} a regexp and have unread articles.
226 [level]\\ 
227 A s     & (l) List {\bf subscribed} groups with unread articles. [level]\\
228 A u     & (L) List all groups (including {\bf unsubscribed}). [If no prefix
229 is given, level 7 is the default]\\ 
230 A z     & List the {\bf zombie} groups.\\
231 A M     & List groups that {\bf match} a regexp.\\
232 \end{keys}
233 }
234
235 \subsec{Create/Edit Foreign Groups}
236 {\samepage
237 The select methods are indicated in parentheses.\\*
238 \begin{keys}{G m}
239 G a     & Make the Gnus list {\bf archive} group. (nndir over ange-ftp)\\
240 G d     & Make a {\bf directory} group (every file must be a posting and files
241 must have numeric names). (nndir)\\
242 G e     & (M-e) {\bf Edit} this group's select method.\\
243 G f     & Make a group based on a {\bf file}. (nndoc)\\
244 G h     & Make the Gnus {\bf help} (documentation) group. (nndoc)\\
245 G k     & Make a {\bf kiboze} group. (nnkiboze)\\
246 G m     & {\bf Make} a new group.\\
247 G p     & Edit this group's {\bf parameters}.\\
248 G v     & Add this group to a {\bf virtual} group. [p/p]\\
249 G D     & Enter a {\bf directory} as a (temporary) group. (nneething without
250 recording articles read.)\\
251 G E     & {\bf Edit} this group's info (select method, articles read, etc).\\
252 G V     & Make a new empty {\bf virtual} group. (nnvirtual)\\
253 \end{keys}
254 You can also create mail-groups and read your mail with Gnus (very useful
255 if you are subscribed to any mailing lists), using one of the methods
256 nnmbox, nnbabyl, nnml, nnmh, or nnfolder. Read about it in the online info
257 (C-c C-i g Reading Mail RET).
258 }
259
260 %\subsubsec{Soup Commands}
261 %\begin{keys}{G s w}
262 %G s b   & gnus-group-brew-soup: not documented.\\
263 %G s p   & gnus-soup-pack-packet: not documented.\\
264 %G s r   & nnsoup-pack-replies: not documented.\\
265 %G s s   & gnus-soup-send-replies: not documented.\\
266 %G s w   & gnus-soup-save-areas: not documented.\\
267 %\end{keys}
268
269 \subsec{Mark Groups}
270 \begin{keys}{M m}
271 M m     & (\#) Set the process {\bf mark} on this group. [scope]\\
272 M u     & (M-\#) Remove the process mark from this group ({\bf unmark}).
273 [scope]\\ 
274 M w     & Mark all groups in the current region.\\
275 \end{keys}
276
277 \subsec{Unsubscribe, Kill and Yank Groups}
278 \begin{keys}{S w}
279 S k     & (C-k) {\bf Kill} this group.\\
280 S l     & Set the {\bf level} of this group. [p/p]\\
281 S s     & (U) Prompt for a group and toggle its {\bf subscription}.\\
282 S t     & (u) {\bf Toggle} subscription to this group. [p/p]\\
283 S w     & (C-w) Kill all groups in the region.\\
284 S y     & (C-y) {\bf Yank} the last killed group.\\
285 S z     & Kill all {\bf zombie} groups.\\
286 \end{keys}
287 }
288
289 \def\SummaryMode{
290 \sec{Summary Mode}  %{Summary and Article Modes}
291 \begin{keys}{SPC}
292 SPC     & (A SPC, A n) Select an article, scroll it one page, move to the
293 next one.\\ 
294 DEL     & (A DEL, A p, b) Scroll this article one page back. [distance]\\
295 RET     & Scroll this article one line forward. [distance]\\
296 =       & Expand the Summary window. [Prefix: shrink it to display the
297 Article window]\\
298 $<$     & (A $<$, A b) Scroll to the beginning of this article.\\
299 $>$     & (A $>$, A e) Scroll to the end of this article.\\
300 \&      & Execute a command on all articles matching a regexp.
301 [Prefix: move backwards.]\\
302 j       & (G g) Ask for an article number and then {\bf jump} to that summary
303 line.\\ 
304 C-t     & Toggle {\bf truncation} of summary lines.\\
305 M-\&    & Execute a command on all articles having the process mark.\\
306 M-k     & Edit this group's {\bf kill} file.\\
307 M-n     & (G M-n) Go to the {\bf next} summary line of an unread article.
308 [distance]\\ 
309 M-p     & (G M-p) Go to the {\bf previous} summary line of an unread article. 
310 [distance]\\ 
311 M-r     & Search through all previous articles for a regexp.\\
312 M-s     & {\bf Search} through all subsequent articles for a regexp.\\
313 M-K     & Edit the general {\bf kill} file.\\
314 \end{keys}
315 }
316
317 \def\SortSummary{
318 \subsec{Sort the Summary Buffer}
319 \begin{keys}{C-c C-s C-a}
320 C-c C-s C-a & Sort the summary by {\bf author}.\\
321 C-c C-s C-d & Sort the summary by {\bf date}.\\
322 C-c C-s C-i & Sort the summary by article score.\\
323 C-c C-s C-n & Sort the summary by article {\bf number}.\\
324 C-c C-s C-s & Sort the summary by {\bf subject}.\\
325 \end{keys}
326 }
327
328 \def\Asubmap{
329 \subsec{Article Buffer Commands}
330 \begin{keys}{A m}
331 A g     & (g) (Re)fetch this article ({\bf get}). [Prefix: just show the
332 article.]\\ 
333 A r     & (^, A ^) Go to the parent of this article (the {\bf References}
334 header).\\ 
335 M-^     & Fetch the article with a given Message-ID.\\
336 A s     & (s) Perform an i{\bf search} in the article buffer.\\
337 A D     & (C-d) Un{\bf digestify} this article into a separate group.\\
338 \end{keys}
339 }
340
341 \def\Bsubmap{
342 \subsec{Mail-Group Commands}
343 {\samepage
344 These commands (except `B c') are only valid in a mail group.\\*
345 \begin{keys}{B M-C-e}
346 B DEL   & {\bf Delete} the mail article from disk (!). [p/p]\\
347 B c     & {\bf Copy} this article from any group to a mail group. [p/p]\\
348 B e     & {\bf Expire} all expirable articles in this group. [p/p]\\
349 B i     & {\bf Import} a random file into this group.\\
350 B m     & {\bf Move} the article from one mail group to another. [p/p]\\
351 B q     & {\bf Query} where will the article go during fancy splitting\\
352 B r     & {\bf Respool} this mail article. [p/p]\\
353 B w     & (e) Edit this article.\\
354 B M-C-e & {\bf Expunge} (delete from disk) all expirable articles in this group
355 (!). [p/p]\\ 
356 \end{keys}
357 }}
358
359 \def\Gsubmap{
360 \subsec{Select Articles}
361 {\samepage
362 These commands select the target article. They do not understand the prefix.\\*
363 \begin{keys}{G C-n}
364 G b     & (,) Go to the {\bf best} article (the one with highest score).\\
365 G f     & (.) Go to the {\bf first} unread article.\\
366 G l     & (l) Go to the {\bf last} article read.\\
367 G n     & (n) Go to the {\bf next} unread article.\\
368 p       & Go to the {\bf previous} unread article.\\
369 G p     & {\bf Pop} an article off the summary history and go to it.\\
370 G N     & (N) Go to {\bf the} next article.\\
371 G P     & (P) Go to the {\bf previous} article.\\
372 G C-n   & (M-C-n) Go to the {\bf next} article with the same subject.\\
373 G C-p   & (M-C-p) Go to the {\bf previous} article with the same subject.\\
374 \end{keys}
375 }}
376
377 \def\Hsubmap{
378 \subsec{Help Commands}
379 \begin{keys}{H d}
380 H d     & (C-c C-d) {\bf Describe} this group. [Prefix: re-read the description
381 from the server.]\\
382 H f     & Try to fetch the {\bf FAQ} for this group using ange-ftp.\\
383 H h     & Give a very short {\bf help} message.\\
384 H i     & (C-c C-i) Go to the Gnus online {\bf info}.\\
385 H v     & Display the Gnus {\bf version} number.\\
386 \end{keys}
387 }
388
389 \def\Msubmap{
390 \subsec{Mark Articles}
391 \begin{keys}{M M-C-r}
392 d       & (M d, M r) Mark this article as read and move to the next one.
393 [scope]\\ 
394 D       & Mark this article as read and move to the previous one. [scope]\\
395 u       & (!, M !, M t) Tick this article (mark it as interesting) and move
396 to the next one. [scope]\\
397 U       & Tick this article and move to the previous one. [scope]\\ 
398 M-u     & (M SPC, M c) Clear all marks from this article and move to the next
399 one. [scope]\\ 
400 M-U     & Clear all marks from this article and move to the previous one.
401 [scope]\\ 
402 M ?     & (?) Mark this article as dormant (only followups are
403 interesting). [scope]\\ 
404 M b     & Set a {\bf bookmark} in this article.\\
405 M e     & (E, M x) Mark this article as {\bf expirable}. [scope]\\
406 M k     & (k) {\bf Kill} all articles with the same subject then select the
407 next one.\\ 
408 M B     & Remove the {\bf bookmark} from this article.\\
409 M C     & {\bf Catch-up} the articles that are not ticked.\\
410 M D     & Show all {\bf dormant} articles (normally they are hidden unless they
411 have any followups).\\
412 M H     & Catch-up (mark read) this group to point ({\bf here}).\\
413 M K     & (C-k) {\bf Kill} all articles with the same subject as this one.\\
414 C-w     & Mark all articles between point and mark as read.\\
415 M S     & (C-c M-C-s) {\bf Show} all expunged articles.\\
416 M C-c   & {\bf Catch-up} all articles in this group.\\
417 M M-r   & (x) Expunge all {\bf read} articles from this group.\\
418 M M-D   & Hide all {\bf dormant} articles.\\
419 M M-C-r & Expunge all articles having a given mark.\\
420 \end{keys}
421
422 \subsubsec{Mark Based on Score}
423 \begin{keys}{M s m}
424 M V c   & {\bf Clear} all marks from all high-scored articles. [score]\\
425 M V k   & {\bf Kill} all low-scored articles. [score]\\
426 M V m   & Mark all high-scored articles with a given {\bf mark}. [score]\\
427 M V u   & Mark all high-scored articles as interesting (tick them). [score]\\
428 \end{keys}
429
430 \subsubsec{The Process Mark}
431 {\samepage 
432 These commands set and remove the process mark \#. You only need to use
433 it if the set of articles you want to operate on is non-contiguous. Else
434 use a numeric prefix.\\*
435 \begin{keys}{M P R}
436 M P a   & Mark {\bf all} articles (in series order).\\
437 M P p   & (\#, M \#) Mark this article.\\
438 M P r   & Mark all articles in the {\bf region}.\\
439 M P s   & Mark all articles in the current {\bf series}.\\
440 M P t   & Mark all articles in this (sub){\bf thread}.\\
441 M P u   & (M-\#, M M-\#) {\bf Unmark} this article.\\
442 M P R   & Mark all articles matching a {\bf regexp}.\\
443 M P S   & Mark all {\bf series} that already contain a marked article.\\
444 M P U   & {\bf Unmark} all articles.\\
445 \end{keys}
446 }}
447
448 \def\Osubmap{
449 \subsec{Output Articles}
450 \begin{keys}{O m}
451 O f     & Save this article in plain {\bf file} format. [p/p]\\
452 O h     & Save this article in {\bf mh} folder format. [p/p]\\
453 O m     & Save this article in {\bf mail} format. [p/p]\\
454 O o     & (o, C-o) Save this article using the default article saver. [p/p]\\
455 O p     & ($\mid$) Pipe this article to a shell command. [p/p]\\
456 O r     & Save this article in {\bf rmail} format. [p/p]\\
457 O v     & Save this article in {\bf vm} format. [p/p]\\
458 \end{keys}
459 }
460
461 \def\Ssubmap{
462 \subsec{Post, Followup, Reply, Forward, Cancel}
463 {\samepage
464 These commands put you in a separate post or mail buffer. After
465 editing the article, send it by pressing C-c C-c.  If you are in a
466 foreign group and want to post the article using the foreign server, give
467 a prefix to C-c C-c.\\* 
468 \begin{keys}{S O m}
469 S b     & {\bf Both} post a followup to this article, and send a reply.\\
470 S c     & (C) {\bf Cancel} this article (only works if it is your own).\\
471 S f     & (f) Post a {\bf followup} to this article.\\
472 S m     & (m) Send {\bf a} mail to some other person.\\
473 S o m   & (C-c C-f) Forward this article by {\bf mail} to a person.\\
474 S o p   & Forward this article as a {\bf post} to a newsgroup.\\
475 S p     & (a) {\bf Post} an article to this group.\\
476 S r     & (r) Mail a {\bf reply} to the author of this article.\\
477 S s     & {\bf Supersede} this article with a new one (only for own
478 articles).\\ 
479 S u     & {\bf Uuencode} a file and post it as a series.\\
480 S B     & {\bf Both} post a followup, send a reply, and include the
481 original. [p/p]\\ 
482 S F     & (F) Post a {\bf followup} and include the original. [p/p]\\
483 S O m   & Digest these series and forward by {\bf mail}. [p/p]\\
484 S O p   & Digest these series and forward as a {\bf post} to a newsgroup.
485 [p/p]\\ 
486 S R     & (R) Mail a {\bf reply} and include the original. [p/p]\\
487 \end{keys}
488 If you want to cancel or supersede an article you just posted (before it
489 has appeared on the server), go to the *post-news* buffer, change
490 `Message-ID' to `Cancel' or `Supersedes' and send it again with C-c C-c.
491 }}
492
493 \def\Tsubmap{
494 \subsec{Thread Commands}
495 \begin{keys}{T \#}
496 T \#    & Mark this thread with the process mark.\\
497 T d     & Move to the next article in this thread ({\bf down}). [distance]\\
498 T h     & {\bf Hide} this (sub)thread.\\
499 T i     & {\bf Increase} the score of this thread.\\
500 T k     & (M-C-k) {\bf Kill} the current (sub)thread. [Negative prefix:
501 tick it, positive prefix: unmark it.]\\
502 T l     & (M-C-l) {\bf Lower} the score of this thread.\\
503 T n     & (M-C-f) Go to the {\bf next} thread. [distance]\\
504 T p     & (M-C-b) Go to the {\bf previous} thread. [distance]\\
505 T s     & {\bf Show} the thread hidden under this article.\\
506 T u     & Move to the previous article in this thread ({\bf up}). [distance]\\
507 T H     & {\bf Hide} all threads.\\
508 T S     & {\bf Show} all hidden threads.\\
509 T T     & (M-C-t) {\bf Toggle} threading.\\
510 \end{keys}
511 }
512
513 \def\Vsubmap{
514 \subsec{Score (Value) Commands}
515 {\samepage
516 Read about Adaptive Scoring in the online info.\\*
517 \begin{keys}{\bf A p m l}
518 V a     & {\bf Add} a new score entry, specifying all elements.\\
519 V c     & Specify a new score file as {\bf current}.\\
520 V e     & {\bf Edit} the current score alist.\\
521 V f     & Edit a score {\bf file} and make it the current one.\\
522 V m     & {\bf Mark} all articles below a given score as read.\\
523 V s     & Set the {\bf score} of this article.\\
524 V t     & Display all score rules applied to this article ({\bf track}).\\
525 V x     & {\bf Expunge} all low-scored articles. [score]\\
526 V C     & {\bf Customize} the current score file through a user-friendly
527 interface.\\ 
528 V S     & Display the {\bf score} of this article.\\
529 \bf A p m l& Make a scoring entry based on this article.\\
530 \end{keys}
531
532 The four letters stand for:\\*
533 \quad \B{A}ction: I)ncrease, L)ower;\\*
534 \quad \B{p}art: a)utor (from), s)ubject, x)refs (cross-posting), d)ate, l)ines,
535 message-i)d, t)references (parent), f)ollowup, b)ody, h)ead (all headers);\\*
536 \quad \B{m}atch type:\\*
537 \qquad string: s)ubstring, e)xact, r)egexp, f)uzzy,\\*
538 \qquad date: b)efore, a)t, n)this,\\*
539 \qquad number: $<$, =, $>$;\\*
540 \quad \B{l}ifetime: t)emporary, p)ermanent, i)mmediate.
541
542 If you type the second letter in uppercase, the remaining two are assumed
543 to be s)ubstring and t)emporary. 
544 If you type the third letter in uppercase, the last one is assumed to be 
545 t)emporary.
546
547 \quad Extra keys for manual editing of a score file:\\*
548 \begin{keys}{C-c C-c}
549 C-c C-c & Finish editing the score file.\\
550 C-c C-d & Insert the current {\bf date} as number of days.\\
551 \end{keys}
552 }}
553
554 \def\Wsubmap{
555 \subsec{Wash the Article Buffer}
556 \begin{keys}{W C-c}
557 W b     & Make Message-IDs and URLs in the article to mouse-clickable {\bf
558   buttons}.\\  
559 W c     & Remove extra {\bf CRs} (^M) from the article.\\
560 W f     & Look for and display any X-{\bf Face} headers.\\
561 W l     & (w) Remove page breaks ({\bf^L}) from the article.\\
562 W m     & Toggle {\bf MIME} processing.\\
563 W o     & Treat {\bf overstrike} or underline (^H\_) in the article.\\
564 W q     & Treat {\bf quoted}-printable in the article.\\
565 W r     & (C-c C-r) Do a Caesar {\bf rotate} (rot13) on the article.\\
566 W t     & (t) {\bf Toggle} the displaying of all headers.\\
567 v       & Toggle permanent {\bf verbose} displaying of all headers.\\
568 W w     & Do word {\bf wrap} in the article.\\
569 W T e   & Convert the article timestamp to time {\bf elapsed} since sent.\\
570 W T l   & Convert the article timestamp to the {\bf local} timezone.\\
571 W T u   & (W T z) Convert the article timestamp to {\bf UTC} ({\bf Zulu},
572 GMT).\\ 
573 \end{keys}
574
575 \subsubsec{Hide/Highlight Parts of the Article}
576 \begin{keys}{W W C-c}
577 W W a   & Hide {\bf all} unwanted parts. Calls W W h, W W s, W W C-c.\\
578 W W c   & Hide article {\bf citation}.\\
579 W W h   & Hide article {\bf headers}.\\
580 W W s   & Hide article {\bf signature}.\\
581 W W C-c & Hide article {\bf citation} using a more intelligent algorithm.\\
582 %\end{keys}
583 %
584 %\subsubsec{Highlight Parts of the Article}
585 %\begin{keys}{W H A}
586 W H a   & Highlight {\bf all} parts. Calls W b, W H c, W H h, W H s.\\
587 W H c   & Highlight article {\bf citation}.\\
588 W H h   & Highlight article {\bf headers}.\\
589 W H s   & Highlight article {\bf signature}.\\
590 \end{keys}
591 }
592
593 \def\Xsubmap{
594 \subsec{Extract Series (Uudecode etc)}
595 {\samepage
596 Gnus recognizes if the current article is part of a series (multipart
597 posting whose parts are identified by numbers in their subjects, e.g.{}
598 1/10\dots10/10) and processes the series accordingly. You can mark and
599 process more than one series at a time. If the posting contains any
600 archives, they are expanded and gathered in a new group.\\*
601 \begin{keys}{X p}
602 X b     & Un-{\bf binhex} these series. [p/p]\\
603 X o     & Simply {\bf output} these series (no decoding). [p/p]\\ 
604 X p     & Unpack these {\bf postscript} series. [p/p]\\
605 X s     & Un-{\bf shar} these series. [p/p]\\
606 X u     & {\bf Uudecode} these series. [p/p]\\
607 \end{keys}
608
609 Each one of these commands has four variants:\\*
610 \begin{keys}{X v \bf Z}
611 X   \bf z & Decode these series. [p/p]\\
612 X   \bf Z & Decode and save these series. [p/p]\\
613 X v \bf z & Decode and view these series. [p/p]\\
614 X v \bf Z & Decode, save and view these series. [p/p]\\
615 \end{keys}
616 where {\bf z} or {\bf Z} identifies the decoding method (b, o, p, s, u).
617
618 An alternative binding for the most-often used of these commands is\\*
619 \begin{keys}{C-c C-v C-v}
620 C-c C-v C-v & (X v u) Uudecode and view these series. [p/p]\\
621 \end{keys}
622 }}
623
624 \def\Zsubmap{
625 \subsec{Exit the Current Group}
626 \begin{keys}{Z G}
627 Z c     & (c) Mark all unticked articles as read ({\bf catch-up}) and exit.\\
628 Z n     & Mark all articles as read and go to the {\bf next} group.\\
629 Z C     & Mark all articles as read ({\bf catch-up}) and exit.\\
630 Z E     & (Q) {\bf Exit} without updating the group information.\\
631 Z G     & (M-g) Check for new articles in this group ({\bf get}).\\
632 Z N     & Exit and go to {\bf the} next group.\\
633 Z P     & Exit and go to the {\bf previous} group.\\
634 Z R     & Exit this group, and then enter it again ({\bf reenter}).
635 [Prefix: select all articles, read and unread.]\\
636 Z Z     & (q, Z Q) Exit this group.\\
637 \end{keys}
638 }
639
640 \def\ArticleMode{
641 \sec{Article Mode}
642 {\samepage
643 % All keys for Summary mode also work in Article mode.
644 The normal navigation keys work in Article mode.
645 Some additional keys are:\\*
646 \begin{keys}{C-c C-m}
647 RET     & (middle mouse button) Activate the button at point to follow
648 an URL or Message-ID.\\
649 TAB     & Move the point to the next button.\\
650 h       & (s) Go to the {\bf header} line of the article in the {\bf
651 summary} buffer.\\ 
652 C-c ^   & Get the article with the Message-ID near point.\\
653 C-c C-m & {\bf Mail} reply to the address near point (prefix: include the
654 original).\\ 
655 \end{keys}
656 }}
657
658 \def\ServerMode{
659 \sec{Server Mode}
660 {\samepage
661 To enter this mode, press `^' while in Group mode.\\*
662 \begin{keys}{SPC}
663 SPC     & (RET) Browse this server.\\
664 a       & {\bf Add} a new server.\\
665 c       & {\bf Copy} this server.\\
666 e       & {\bf Edit} a server.\\
667 k       & {\bf Kill} this server. [scope]\\
668 l       & {\bf List} all servers.\\
669 q       & Return to the group buffer ({\bf quit}).\\
670 y       & {\bf Yank} the previously killed server.\\
671 \end{keys}
672 }}
673
674 \def\BrowseServer{
675 \sec{Browse Server Mode}
676 {\samepage
677 To enter this mode, press `B' while in Group mode.\\*
678 \begin{keys}{RET}
679 RET     & Enter the current group.\\
680 SPC     & Enter the current group and display the first article.\\
681 ?       & Give a very short help message.\\
682 n       & Go to the {\bf next} group. [distance]\\
683 p       & Go to the {\bf previous} group. [distance]\\
684 q       & (l) {\bf Quit} browse mode.\\
685 u       & Subscribe to the current group. [scope]\\
686 \end{keys}
687 }}