comparison etc/gnusrefcard/gnusref.tex @ 161:28f395d8dc7a r20-3b7

Import from CVS: tag r20-3b7
author cvs
date Mon, 13 Aug 2007 09:42:26 +0200
parents
children
comparison
equal deleted inserted replaced
160:1c55655d6702 161:28f395d8dc7a
1 % -*- mode:LaTeX; eval:(setq LaTeX-version "2"); truncate-lines:t; -*-
2 % include file for the Gnus refcard and booklet
3 \def\version{5.4.56}
4 \def\date{12 June 1997}
5 \def\author{Vladimir Alexiev $<$vladimir@cs.ualberta.ca$>$}
6 \raggedbottom\raggedright
7 \newlength{\logowidth}\setlength{\logowidth}{6.861in}
8 \newlength{\logoheight}\setlength{\logoheight}{7.013in}
9 \newlength{\keycolwidth}
10 \newenvironment{keys}[1]% #1 is the widest key
11 {\nopagebreak%\noindent%
12 \settowidth{\keycolwidth}{#1}%
13 \addtolength{\keycolwidth}{\tabcolsep}%
14 \addtolength{\keycolwidth}{-\columnwidth}%
15 \begin{tabular}{@{}l@{\hspace{\tabcolsep}}p{-\keycolwidth}@{}}}%
16 {\end{tabular}\\}
17 \catcode`\^=12 % allow ^ to be typed literally
18 \catcode`\~=12 % allow ~ to be typed literally
19 \newcommand{\B}[1]{{\bf#1})} % bold l)etter
20
21 \def\Title{
22 \begin{center}
23 {\bf\LARGE Gnus \version\ Reference \Guide\\}
24 %{\normalsize \Guide\ version \refver}
25 \end{center}
26 }
27
28 \newcommand\Logo[1]{\centerline{
29 \makebox[\logoscale\logowidth][l]{\vbox to \logoscale\logoheight
30 {\vfill\special{psfile=gnuslogo.#1}}\vspace{-\baselineskip}}}}
31
32 \def\CopyRight{
33 \begin{center}
34 Copyright \copyright\ 1995 Free Software Foundation, Inc.\\*
35 Copyright \copyright\ 1995-97 \author.\\*
36 Created from the Gnus manual Copyright \copyright\ 1994-97 Lars Magne
37 Ingebrigtsen.\\*
38 and the Emacs Help Bindings feature (C-h b).\\*
39 Gnus logo copyright \copyright\ 1995 Luis Fernandes.\\*
40 \end{center}
41
42 Permission is granted to make and distribute copies of this reference
43 \guide{} provided the copyright notice and this permission are preserved on
44 all copies. Please send corrections, additions and suggestions to the
45 above email address. \Guide{} last edited on \date.
46 }
47
48 \def\Notes{\subsec{Notes}{\samepage
49 Gnus is big. Currently it has some 633 interactive (user-callable)
50 commands. Many of these commands have more than one binding. In order to save
51 space, every function is listed only once in this \guide, under the ``more
52 logical'' binding. Alternative bindings are given in parentheses at the
53 beginning of the description. This \guide{} describes only key-bindings, you
54 {\em should\/} at least browse the manual to discover many great features
55
56 Many Gnus commands use the numeric prefix. Normally you enter a prefix by
57 holding the Meta key and typing a number, but in most Gnus modes you don't
58 need to use Meta since the digits are not self-inserting. The prefixed
59 behavior of commands is given in [brackets]. Often the prefix is used to
60 specify:
61
62 \quad [distance] How many objects to move the point over.
63
64 \quad [scope] How many objects to operate on (including the current one).
65
66 \quad [p/p] The ``Process/Prefix Convention'': If a prefix is given then it
67 determines how many objects to operate on (negative means backwards). Else if
68 transient-mark-mode or zmacs-regions is set and the region is active, operate
69 on the region. Else if there are some objects marked with the process mark \#,
70 operated on them. Else operate only on the current object.
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
81 \quad [GL rating] Give a GroupLens rating (1-5) to the current article before
82 moving to another article.
83
84 %Some functions were not yet documented at the time of creating this
85 %\guide and are clearly indicated as such.
86 }}
87
88 \def\GroupLevels{\subsec{Group Subscribedness Levels}{\samepage
89 The table below assumes that you use the default Gnus levels.
90 Fill your user-specific levels in the blank cells.\\*
91 \begin{tabular}{|c|l|l|}
92 \hline
93 Level & Groups & Status \\
94 \hline
95 1 & mail groups & \\
96 2 & mail groups & \\
97 3 & default subscribed level & subscribed \\
98 4 & & \\
99 5 & default list level & \\
100 \hline
101 6 & default unsubscribed level & unsubscribed \\
102 7 & & \\
103 \hline
104 8 & & zombies \\
105 \hline
106 9 & & killed \\
107 \hline
108 \end{tabular}
109 }}
110
111 \def\Marks{\subsec{Mark Indication Characters}{\samepage
112 If a command directly sets a mark, it is shown in parentheses.\\*
113 \newlength{\markcolwidth}
114 \settowidth{\markcolwidth}{` '}% widest character
115 \addtolength{\markcolwidth}{4\tabcolsep}
116 \addtolength{\markcolwidth}{-\columnwidth}
117 \newlength{\markdblcolwidth}
118 \setlength{\markdblcolwidth}{\columnwidth}
119 \addtolength{\markdblcolwidth}{-2\tabcolsep}
120 \begin{tabular}{|c|p{-\markcolwidth}|}
121 \hline
122 \multicolumn{2}{|p{\markdblcolwidth}|}
123 {{\bf ``Read'' Marks.}
124 All these marks appear in the first column of the summary line, and so
125 are mutually exclusive.}\\
126 \hline
127 ` ' & (M-u, M SPC, M c) Not read.\\
128 ! & (!, M t) Ticked (interesting).\\ %(M !)
129 ? & (?, M ?) Dormant (only followups are interesting).\\
130 E & (E, M e) {\bf Expirable}. Only has effect in mail groups.\\ %(M x)
131 \hline\hline
132 \multicolumn{2}{|p{\markdblcolwidth}|}{The marks below mean that the article
133 is read (killed, uninteresting), and have more or less the same effect.
134 Some commands however explicitly differentiate between them (e.g.{} M
135 M-C-r, adaptive scoring).}\\
136 \hline
137 r & (d, M d, M r) Deleted (marked as {\bf read}).\\
138 C & (M C; M C-c; M H; c, Z c; Z n; Z C) Killed by {\bf catch-up}.\\
139 F & (O s; G s b) SOUPed.\\
140 G & (S C, C) Canceled (only for your own articles).\\
141 O & {\bf Old} (marked read in a previous session).\\
142 K & (k, M k; C-k, M K) {\bf Killed}.\\
143 M & Marked by duplicate elimination.\\
144 Q & Divined through the building of sparse threads.\\
145 R & {\bf Read} (actually viewed).\\
146 X & Killed by a kill file.\\
147 Y & Killed due to low score.\\
148 \hline
149 %\multicolumn{2}{c}{\vspace{0.2ex}}\\
150 \hline
151 \multicolumn{2}{|p{\markdblcolwidth}|}
152 {{\bf Other marks}}\\
153 \hline
154 \# & (\#, M P p) Processable (will be affected by the next operation).\\ %(M \#)
155 * & (*) Persistent (or cached for some other reason).\\
156 A & {\bf Answered} (followed-up or replied).\\
157 S & (O {\bf x}) {\bf Saved}.\\
158 + & Over default score.\\
159 $-$ & Under default score.\\
160 = & Has children (thread underneath it). Add `\%e' to `gnus-summary-line-format'.\\
161 \hline
162 \end{tabular}
163 }}
164
165 \def\General{\sec{(H) General and Help Commands}{\samepage
166 These commands work everywhere.
167 \begin{keys}{C-c C-i}
168 C-c C-i & Go to the Gnus on-line {\bf info}.\\
169 C-c C-b & Send a Gnus {\bf bug} report.\\
170 \end{keys}
171
172 These commands work in Summary mode, and most also work in Group mode.\\*
173 \begin{keys}{H d}
174 H d & (C-c C-d) {\bf Describe} this group. [Prefix: re-read the description
175 from the server.]\\
176 H f & Try to fetch the {\bf FAQ} for this group using ange-ftp.\\
177 H h & Give a very short {\bf help} message.\\
178 H i & (C-c C-i) Go to the Gnus online {\bf info}.\\
179 H v & Display the Gnus {\bf version} number.\\
180 \end{keys}}}
181
182 \def\GroupMode{\sec{Group Mode}
183 \begin{keys}{C-c M-C-x}
184 RET & (=) Select this group [Prefix: how many (read) articles to fetch.
185 Positive: newest articles, negative: oldest ones, C-u: ask number].
186 Also: fold/unfold a topic.\\
187 SPC & Select this group and display the first unread article [Same
188 prefix as above]. Also: fold/unfold a topic.\\
189 M-RET & Select this group quickly (no scoring, expunging, etc).\\
190 M-SPC & Select this group, and don't hide dormant articles.\\
191 M-C-RET & Select this group ephemerally: no processing and no permanent effect.\\
192 ? & Give a very short help message.\\
193 $<$ & Go to the beginning of the Group buffer.\\
194 $>$ & Go to the end of the Group buffer.\\
195 , & Jump to the lowest-level group with unread articles.\\
196 . & Jump to the first group with unread articles.\\
197 ^ & Enter the Server buffer mode.\\
198 a & Post an {\bf article} to a group.\\
199 b & Find {\bf bogus} groups and delete them.\\
200 c & Mark all unticked articles in this group as read ({\bf catch-up}).
201 [p/p]\\
202 g & Check the server for new articles ({\bf get}). [level]\\
203 j & {\bf Jump} to a specified group (may even be killed).\\
204 m & {\bf Mail} a message to someone.\\
205 n & Go to the {\bf next} group with unread articles. [distance]\\
206 p & (DEL) Go to the {\bf previous} group with unread articles.
207 [distance]\\
208 q & {\bf Quit} Gnus. M-x gnus-unload to remove it from memory.\\
209 r & {\bf Re-read} the init file `.gnus'.\\
210 s & {\bf Save} the `.newsrc.eld' file (and `.newsrc' if
211 `gnus-save-newsrc-file').\\
212 t & Toggle {\bf Topic} mode. A topic is a hierarchy of groups.\\
213 z & Suspend Gnus (kill all buffers except the Group buffer).\\
214 B & {\bf Browse} a foreign server (specify method and name).\\
215 C & Mark all articles in this group as read ({\bf Catch-up}). [p/p]\\
216 F & {\bf Find} new groups and process them. [Prefix: ask-server]\\
217 N & Go to the {\bf next} group. [distance]\\
218 P & Go to the {\bf previous} group. [distance]\\
219 Q & {\bf Quit} Gnus without saving any .newsrc files.\\
220 R & {\bf Restart} Gnus.\\
221 V & Display the Gnus {\bf version} number.\\
222 W f & {\bf Flush} the score caches of all groups.\\
223 Z & Clear the dribble buffer.\\
224 C-c C-s & {\bf Sort} the groups according to `gnus-group-sort-function'.\\
225 C-c C-x & Run all expirable articles in this group through the {\bf expiry}
226 process.\\
227 C-c M-C-x & Run all articles in all groups through the {\bf expiry} process.\\
228 C-c M-g & Activate absolutely all groups.\\
229 C-x C-t & {\bf Transpose} two groups.\\
230 M-\& & Execute a command on all process-marked groups.\\
231 M-c & {\bf Clear} this group's data (read and other marks). [p/p]
232 Use M-x gnus-group-clear-data-on-native-groups to clear all data if you change
233 servers and article numbers don't match. Or use
234 M-x gnus-change-server to renumber the articles, but it is slow.\\
235 \end{keys}
236 \begin{keys}{C-c M-C-x}
237 \newlength{\keywidth}\settowidth{\keywidth}{C-c M-C-x}%
238 \makebox[\keywidth][l]%
239 {M-d} & {\bf Describe} {\em all\/} groups. [Prefix: re-read the description
240 from the server]\\
241 M-f & Fetch this group's {\bf FAQ} (using ange-ftp).\\
242 M-g & Check the server for new articles in this group ({\bf get}). [p/p]\\
243 M-n & Go to the {\bf previous} unread group on the same or lower level.
244 [distance]\\
245 M-p & Go to the {\bf next} unread group on the same or lower level.
246 [distance]\\
247 \end{keys}}
248
249 \def\ListGroups{\subsec{(A) List Groups}{\samepage
250 \begin{keys}{A m}
251 A a & (C-c C-a) List all groups whose names match a regexp ({\bf
252 apropos}).\\
253 A d & List all groups whose names or {\bf descriptions} match a regexp.\\
254 A k & List all {\bf killed} groups. [Prefix: all groups but [un]subscribed]\\ % (C-c C-l)
255 A l & List unread groups on a specific {\bf level}. [Prefix: also read groups]\\
256 A m & List groups that {\bf match} a regexp and have unread articles.
257 [level]\\
258 A s & (l) List {\bf subscribed} groups with unread articles. [level]\\
259 A u & (L) List all groups (including {\bf unsubscribed}). [level, default 7]\\
260 A z & List the {\bf zombie} groups.\\
261 A A & List all available {\bf active} groups on all servers (may be slow).\\
262 A M & List groups that {\bf match} a regexp.\\
263 A T & List all active groups arranged in {\bf topics}.\\
264 \end{keys}}}
265
266 \def\CreateGroups{\subsec{(G) Create/Edit Foreign Groups}{\samepage
267 The select methods are indicated in parentheses.\\*
268 \begin{keys}{G DEL}
269 G DEL & {\bf Delete} this group. [Prefix: delete {\bf all} articles too]\\
270 G a & Make the Gnus list {\bf archive} group. (nndir over ange-ftp)\\
271 G c & {\bf Customize} this group's parameters.\\
272 G d & Make a {\bf directory} group (every file a posting with numeric name). (nndir)\\
273 G e & {\bf Edit} this group's select method.\\ % (M-e)
274 G f & Make a group based on a {\bf file}. (nndoc: mbox, babyl, digest,
275 mmdf, news, rnews, clari-briefs, rfc934, rfc822, forward) [Prefix:
276 don't guess the type]\\
277 G h & Make the Gnus {\bf help} (documentation/tutorial) group. (nndoc)\\
278 G k & Make a {\bf kiboze} group (specify name, groups, regexps). (nnkiboze)\\
279 G m & {\bf Make} a new group (specify name, method, address).\\
280 G p & Edit this group/topic's {\bf parameters}.\\
281 G r & {\bf Rename} this group (only for mail groups).\\
282 G v & Add this group to a {\bf virtual} group. [p/p]\\
283 G w & Make a {\bf web}-based group. (nnweb: dejanews, altavista,
284 reference) [Prefix: permanent group]\\
285 G D & Enter a {\bf directory} as a temporary group. (nneething without
286 recording read marks.)\\
287 G E & {\bf Edit} this group's info (select method, articles read, etc).\\
288 G V & Make an empty {\bf virtual} group. (nnvirtual)\\
289 \end{keys}
290 You can also create mail-groups and read your mail with Gnus (very useful
291 if you are subscribed to any mailing lists), using one of the methods
292 nnmbox, nnbabyl, nnml, nnmh, or nnfolder. Read about it in the online info
293 (C-c C-i g Reading Mail RET).
294 }}
295
296 \def\SortGroups{\subsubsec{(G S) Sort Groups}{\samepage
297 To sort by multiple criteria, first apply the less significant ones, last the
298 most significant one.\\*
299 \begin{keys}{G P \bf x}
300 G S a & Sort {\bf Alphabetically} by group name. [Prefix: reverse order]\\
301 G S l & Sort by {\bf level}. [Prefix: reverse order]\\
302 G S m & Sort by {\bf method} name. [Prefix: reverse order]\\
303 G S r & Sort by rank (level and score). [Prefix: reverse order]\\
304 G S u & Sort by number of {\bf unread} articles. [Prefix: reverse order]\\
305 G S v & Sort by group score ({\bf value}). [Prefix: reverse order]\\
306 \end{keys}
307 Here {\bf x} can be any one of a,l,m,r,u,v:\\*
308 \begin{keys}{G P \bf x}
309 G P \bf x & Sort only the groups selected by [p/p].\\
310 T S \bf x & Sort only the current topic.\\
311 \end{keys}
312 }}
313
314 \def\SOUP{\subsubsec{(G s) SOUP Commands}{\samepage
315 SOUP is a protocol for putting many articles/replies in a packet, transferring
316 them in bulk and reading/composing them off-line. Use the following commands to
317 manipulate the packets, and use the nnsoup method to read.\\*
318 \begin{keys}{G s w}
319 G s b & Pack all unread articles ({\bf brew} soup). [p/p]\\
320 G s p & {\bf Pack} all SOUP data files into a SOUP packet.\\
321 G s r & Pack all {\bf replies} into a replies packet.\\
322 G s s & {\bf Send} all replies you put in the replies packet.\\
323 G s w & {\bf Write} all SOUP data files.\\
324 \end{keys}}}
325
326 \def\MarkGroups{\subsec{(M) Mark Groups}{\samepage
327 \begin{keys}{M m}
328 M b & Set the process mark on all groups in the {\bf buffer}.\\
329 M r & Mark all groups matching a {\bf regexp}.\\
330 M m & (\#) {\bf Mark} this group. [scope]\\
331 M u & (M-\#) {\bf Unmark} this group. [scope]\\
332 M w & Mark all groups in the current region.\\
333 M U & {\bf Unmark} all groups in the buffer.\\
334 \end{keys}}}
335
336 \def\Unsubscribe{\subsec{(S) (Un)subscribe, Kill and Yank Groups}{\samepage
337 \begin{keys}{S C-k}
338 S C-k & {\bf Kill} all groups on a certain level.\\
339 S k & (C-k) {\bf Kill} this group/ topic (and all its groups).\\
340 S l & Set the {\bf level} of this group. [p/p]\\
341 S s & (U) Prompt for a group and toggle its {\bf subscription}.\\
342 S t & (u) {\bf Toggle} subscription to this group. [p/p]\\
343 S w & (C-w) Kill all groups in the region.\\
344 S y & (C-y) {\bf Yank} the last killed group/topic.\\
345 S z & Kill all {\bf zombie} groups.\\
346 \end{keys}}}
347
348 \def\GroupTopics{\subsec{(T) Group Topics}{\samepage
349 Topics are hierarchical arrangements of groups with the purpose of easier
350 reading and management.
351 \begin{keys}{T TAB}
352 T TAB & Indent this topic to become a sub-topic of the previous one.
353 [Prefix: un-dent]\\
354 T DEL & {\bf Delete} an empty topic.\\
355 T \# & Mark all groups in this topic with the process mark.\\
356 T M-\# & Unmark all groups in this topic with the process mark.\\
357 T c & {\bf Copy} this group to another topic. [p/p]\\
358 T h & Toggle the {\bf hiding} of empty topics.\\
359 T m & {\bf Move} this group to another topic. [p/p]\\
360 T n & Create a {\bf new} topic.\\
361 T r & {\bf Rename} a topic.\\
362 T C & {\bf Copy} all groups that match a regexp to a topic.\\
363 T D & {\bf Delete} this group from this topic. [p/p]\\
364 T M & {\bf Move} all groups that match a regexp to a topic.\\
365 \end{keys}}}
366
367 \def\SummaryMode{\sec{Summary Mode}{\samepage
368 \begin{keys}{M-C-d}
369 SPC & Select an article, scroll it one page, move to the next one.\\
370 %(A SPC, A n)
371 DEL & (b) Scroll this article one page back. [distance]\\ %(A DEL, A p)
372 RET & Scroll this article one line forward. [distance]\\
373 = & Expand the Summary window. [Prefix: shrink it to display the
374 Article window]\\
375 $<$ & (A $<$) Scroll to the beginning of this article.\\ %(A b)
376 $>$ & (A $>$) Scroll to the end of this article.\\ %(A e)
377 \& & Execute a command on all articles matching a regexp.
378 [Prefix: move backwards.]\\
379 k & Give a GroupLens {\bf rating} (1-5) to this thread.\\
380 r & Give a GroupLens {\bf rating} (1-5) to this article.\\
381 Y g & Re{\bf generate} the summary buffer.\\
382 Y c & Pull all {\bf cached} articles into the summary.\\
383 C-t & Toggle {\bf truncation} of summary lines.\\
384 C-d & Un-{\bf digestify} this article into a separate group.\\ %(A D)
385 M-C-d & Un-{\bf digestify} all selected articles into one group. [p/p]\\
386 M-\& & Execute a command on all articles having the process mark.\\
387 M-k & Edit this group's {\bf kill} file.\\
388 M-r & Search through previous articles for a regexp.\\
389 M-s & {\bf Search} through subsequent articles for a regexp.\\
390 M-K & Edit the general {\bf kill} file.\\
391 \end{keys}}}
392
393 \def\SortSummary{\subsec{(C-c C-s) Sort the Summary}{\samepage
394 In thread mode, these commands sort only the thread roots.\\*
395 \begin{keys}{C-c C-s C-a}
396 C-c C-s C-a & Sort the summary by {\bf author}.\\
397 C-c C-s C-d & Sort the summary by {\bf date}.\\
398 C-c C-s C-i & Sort the summary by article score.\\
399 C-c C-s C-l & Sort the summary by number of {\bf lines}.\\
400 C-c C-s C-n & Sort the summary by article {\bf number}.\\
401 C-c C-s C-s & Sort the summary by {\bf subject}.\\
402 \end{keys}}}
403
404 \def\Article{\subsec{(A) Article Commands}{\samepage
405 \begin{keys}{A m}
406 A g & (g) (Re){\bf get} this article. [Prefix: don't do any processing]\\
407 A r & (^) Go to the parent of this article ({\bf References} header).
408 [Prefix: how many ancestors back; negative: only the $n$-th ancestor]\\ %(A ^)
409 M-^ & Go to the article with a given Message-ID.\\
410 A s & (s) Perform an i{\bf search} in the article buffer.\\
411 A P & {\bf Print} the article as postscript.\\
412 A R & Fetch all ancestors ({\bf References}) of this article.\\
413 \end{keys}}}
414
415 \def\MailGroup{\subsec{(B) Mail-Group Commands}{\samepage
416 These commands (except `B c') are only valid in a mail group.\\*
417 \begin{keys}{B M-C-e}
418 B DEL & {\bf Delete} the mail article from disk. [p/p]\\
419 B c & {\bf Copy} this article from any group to a mail group. [p/p]\\
420 B e & {\bf Expire} all expirable articles in this group. [p/p]\\
421 B i & {\bf Import} any file into this mail group (give From and Subject).\\
422 B m & {\bf Move} the article from one mail group to another. [p/p]\\
423 B p & Check if a courtesy copy of a message was also {\bf posted}.\\
424 B q & {\bf Query} where would the article go if respooled.\\
425 B r & {\bf Respool} this mail article. [p/p]\\
426 B w & (e) Edit this mail article.\\
427 B M-C-e & {\bf Expunge} (from disk) all expirable articles in this group. [p/p]\\
428 B C & {\bf Crosspost} this article to another group.\\
429 \end{keys}}}
430
431 \def\GotoArticle{\subsec{(G) Go To Article}{\samepage
432 These commands select the target article. They do not understand the prefix.\\*
433 \begin{keys}{G C-n}
434 G b & (,) Go to the {\bf best} article (the one with highest score). [GL rating]\\
435 G f & (.) Go to the {\bf first} unread article.\\
436 G g & Ask for an article number and then {\bf go to} to that summary
437 line.\\
438 G j & (j) Ask for an article number and then {\bf jump} to that article.\\
439 G l & (l) Go to the {\bf last} article read.\\
440 G o & Pop an article off the summary history and go to it.\\
441 G n & (n) Go to the {\bf next} unread article. [GL rating]\\
442 G p & (p) Go to the {\bf previous} unread article.\\
443 G N & (N) Go to {\bf the} next article.\\
444 G P & (P) Go to the {\bf previous} article.\\
445 G C-n & (M-C-n) Go to the {\bf next} article with the same subject.\\
446 G C-p & (M-C-p) Go to the {\bf previous} article with the same subject.\\
447 G M-n & (M-n) Go to the {\bf next} summary line of an unread article.
448 [distance]\\
449 G M-p & (M-p) Go to the {\bf previous} summary line of an unread article.
450 [distance]\\
451 \end{keys}}}
452
453 \def\MarkArticles{\subsec{(M) Mark Articles}{\samepage
454 \begin{keys}{M M-C-r}
455 d & (M d, M r) Mark this article as {\bf read} ({\bf delete} it)
456 and move to the next one. [scope]\\
457 D & Mark this article as read and move to the previous one. [scope]\\
458 u & (!, M t) {\bf Tick} this article (mark it as interesting)
459 and move to the next one. [scope]\\ %(M !)
460 U & Tick this article and move to the previous one. [scope]\\
461 M-u & (M SPC, M c) {\bf Clear} all marks from this article
462 and move to the next one. [scope]\\
463 M-U & Clear all marks from this article and move to the previous one.
464 [scope]\\
465 M ? & (?) Mark this article as dormant (only followups are
466 interesting). [scope]\\
467 * & Make this article persistent. [p/p]\\
468 M-* & Make this article non-persistent (and delete it). [p/p]\\
469 M b & Set a {\bf bookmark} in this article.\\
470 M e & (E) Mark this article as {\bf expirable}. [scope]\\ %(M x)
471 M k & (k) {\bf Kill} all articles with the same subject then select the
472 next one.\\
473 M B & Remove the {\bf bookmark} from this article.\\
474 M C & {\bf Catch-up} (mark read) the articles that are not ticked.\\
475 M D & Show all {\bf dormant} articles (normally they are hidden unless they
476 have any followups).\\
477 M H & Catch-up (mark read) this group to point ({\bf here}).\\
478 M K & (C-k) {\bf Kill} all articles with the same subject as this one.\\
479 C-w & Mark all articles between point and mark as read.\\
480 M S & (C-c M-C-s) {\bf Show} all expunged articles.\\
481 M C-c & {\bf Catch-up} all articles in this group.\\
482 M M-r & (x) Expunge all {\bf read} articles from this group.\\
483 M M-D & Hide all {\bf dormant} articles.\\
484 M M-C-r & Expunge all articles having a given mark.\\
485 \end{keys}}}
486
487 \def\MarkScore{\subsubsec{(M V) Mark Based on Score (Value)}{\samepage
488 \begin{keys}{M s m}
489 M V c & {\bf Clear} all marks from all high-scored articles. [score]\\
490 M V k & {\bf Kill} all low-scored articles. [score]\\
491 M V m & Mark all high-scored articles with a given {\bf mark}. [score]\\
492 M V u & Mark all high-scored articles as interesting (tick them). [score]\\
493 \end{keys}}}
494
495 \def\ProcessMark{\subsubsec{(M P) The Process Mark}{\samepage
496 These commands set and remove the process mark \#. You only need to use
497 it if the set of articles you want to operate on is non-contiguous. Else
498 use a numeric prefix.\\*
499 \begin{keys}{M P R}
500 M P a & Mark {\bf all} articles (in series order).\\
501 M P b & Mark all articles in the order they appear in the {\bf buffer}.\\
502 M P i & {\bf Invert} all process marks.\\
503 M P k & Push all marks on a stack then {\bf kill} them.\\
504 M P p & (\#) Mark this article.\\ %(M \#)
505 M P r & Mark all articles in the {\bf region}.\\
506 M P s & Mark all articles in the current {\bf series}.\\
507 M P t & Mark all articles in this (sub){\bf thread}.\\
508 M P u & (M-\#) {\bf Unmark} this article.\\ %(M M-\#)
509 M P v & Mark all high-scored articles ({\bf value}). [score]\\
510 M P w & Push all marks on a stack.\\
511 M P y & {\bf Yank} and restore a mark set from the stack after `M P y',
512 `M P w' or an operation that cleared the marks.\\
513 M P R & Mark all articles matching a {\bf regexp}.\\
514 M P S & Mark all {\bf series} that already contain a marked article.\\
515 M P T & Unmark all articles in this (sub){\bf thread}.\\
516 M P U & {\bf Unmark} all articles.\\
517 \end{keys}}}
518
519 \def\OutputArticles{\subsec{(O) Output Articles}{\samepage
520 \begin{keys}{O m}
521 O b & Save the article {\bf body} in a plain file. [p/p]\\
522 O f & Save this article in a plain {\bf file}. [p/p]\\
523 O h & Save this article in {\bf mh} folder format. [p/p]\\
524 O m & Save this article in {\bf mail} format. [p/p]\\
525 O o & (o, C-o) Save this article using the default article saver. [p/p]\\
526 O p & ($\mid$) Pipe this article to a shell command. [p/p]\\
527 O r & Save this article in {\bf rmail} format. [p/p]\\
528 O s & Add this article to a {\bf SOUP} packet. [p/p]\\
529 O v & Save this article in {\bf vm} format. [p/p]\\
530 O F & Save this article as plain {\bf file} and overwrite any existing file. [p/p]\\
531 \end{keys}}}
532
533 \def\Send{\subsec{(S) Post, Followup, Reply, Forward, Cancel}{\samepage
534 These commands put you in a separate Message buffer. After editing the
535 article, send it by pressing C-c C-c. If you are in a foreign group and want
536 to post the article using the foreign server, give a prefix to C-c C-c.
537 Set `gnus-post-method' to `nngateway' if your server cannot post [temporarily]
538 and you wan to post through a mail-to-news gateway.\\*
539 \begin{keys}{S O m}
540 S b & {\bf Both} post a followup to this article, and send a reply.\\
541 S c & (C) {\bf Cancel} this article (only works if it is your own).\\
542 S f & (f) Post a {\bf followup} to this article.\\
543 S m & (m) Send a {\bf mail} to someone.\\
544 S n & Followup in a {\bf newsgroup} to a message you got through mail.\\
545 S o m & (C-c C-f) Forward this article by {\bf mail} to a person.
546 [Prefix: include full headers]\\
547 S o p & Forward this article as a {\bf post} to a newsgroup.\\
548 S p & (a) {\bf Post} an article to this group.\\
549 S r & (r) Mail a {\bf reply} to the author of this article.\\
550 S s & {\bf Supersede} this article with a new one (only for own articles).\\
551 S u & {\bf Uuencode} a file, split it into series and post it.\\
552 S w & Mail a {\bf wide} reply to the author and the recipients of this
553 article.\\
554 S B & {\bf Both} post a followup, send a reply, and include the
555 original. [p/p]\\
556 S D b & Resend a {\bf bounced} mail after fixing the recipient address.
557 [Prefix: display the headers of the message this one is a reply to]\\
558 S D r & {\bf Resend} this message to another of your addresses.\\
559 S F & (F) Post a {\bf followup} and include the original. [p/p]\\
560 S N & Followup in a {\bf newsgroup} to a mail message and include the
561 original [p/p].\\
562 S O m & Digest these series and forward by {\bf mail}. [p/p]\\
563 S O p & Digest these series and forward as a {\bf post} to a newsgroup.
564 [p/p]\\
565 S R & (R) Mail a {\bf reply} and include the original. [p/p]\\
566 S W & Mail a {\bf wide} reply and include the original. [p/p]\\
567 S M-c & Send a {\bf complaint} about excessive {\bf crossposting}. [p/p]\\
568 \end{keys}
569 If you want to cancel or supersede an article you just posted (before it
570 has appeared on the server), go to the *sent \ldots* buffer, change
571 `Message-ID' to `Cancel' or `Supersedes' and send it again with C-c C-c.
572 }}
573
574 \def\Thread{\subsec{(T) Thread Commands}{\samepage
575 \begin{keys}{T M-\#}
576 T ^ & Make this article child of the previous or precess-marked one.\\
577 T \# & Mark this (sub)thread with the process mark.\\
578 T M-\# & Remove the process mark from this (sub)thread.\\
579 T d & Move {\bf down} this thread. [distance]\\
580 T h & {\bf Hide} this (sub)thread.\\
581 T i & {\bf Increase} the score of this thread.\\
582 T k & (M-C-k) {\bf Kill} the current (sub)thread. [Prefix:
583 negative--tick, positive--unmark]\\
584 T l & (M-C-l) {\bf Lower} the score of this thread.\\
585 T n & (M-C-f) Go to the {\bf next} thread. [distance]\\
586 T o & Go to the {\bf top} of this thread.\\
587 T p & (M-C-b) Go to the {\bf previous} thread. [distance]\\
588 T s & {\bf Show} the thread hidden under this article.\\
589 T t & Re-{\bf thread} this thread.\\
590 T u & Move {\bf up} this thread. [distance]\\
591 T H & {\bf Hide} all threads.\\
592 T S & {\bf Show} all hidden threads.\\
593 T T & (M-C-t) {\bf Toggle} threading.\\
594 \end{keys}}}
595
596 \def\Score{\subsec{(V) Score (Value) Commands}{\samepage
597 Read about Adaptive Scoring in the online info.\\*
598 \begin{keys}{\bf A p m l}
599 V a & {\bf Add} a new score entry, specifying all elements.\\
600 V c & Select a new score file as {\bf current}.\\
601 V e & {\bf Edit} the current score file.\\
602 V f & Edit a score {\bf file} and make it the current one.\\
603 V m & {\bf Mark} all articles below a given score as read [score].\\
604 V s & {\bf Set} the score of this article.\\
605 V t & {\bf Trace} all score rules applied to this article.\\
606 V x & {\bf Expunge} all low-scored articles. [score]\\
607 V F & {\bf Flush} the score cache to put it in sync with files.\\
608 V C & {\bf Customize} the current score file using a user-friendly
609 interface.\\
610 V S & {\bf Show} the score of this article.\\
611 I C-i & {\bf Increase} the score of this article.\\
612 L C-l & {\bf Lower} the score of this article.\\
613 \bf A p m l& Make a scoring entry based on this article.\\
614 \end{keys}
615
616 The four letters stand for:\\*
617 \quad \B{A}ction: I)ncrease, L)ower;\\*
618 \quad \B{p}art: a)uthor (from), b)ody, d)ate, f)ollowups, h)ead (all headers),
619 message-i)d, l)ines, s)ubject, t)hread (references), x)refs (cross-posting);\\*
620 \quad \B{m}atch type:\\*
621 \qquad string: e)xact, f)uzzy, r)egexp, s)ubstring\\*
622 \qquad date: a)t, b)efore, n)this,\\*
623 \qquad number: $<$, =, $>$;\\*
624 \quad \B{l}ifetime: t)emporary, p)ermanent, i)mmediate.
625
626 If you type the second/third letter in uppercase, the remaining letters are
627 assumed to be s)ubstring and t)emporary.
628
629 \quad Extra keys for manual editing of a score file:\\*
630 \begin{keys}{C-c C-c}
631 C-c C-c & Finish editing the score file.\\
632 C-c C-d & Insert the current {\bf date} as number of days.\\
633 C-c C-p & {\bf Pretty-print} the [adaptive] score file.\\
634 \end{keys}}}
635
636 \def\Wash{\subsec{(W) Wash the Article Buffer}{\samepage
637 \begin{keys}{W C-c}
638 W b & Make Message-IDs, URLs, citations and signature to mouse-clickable
639 {\bf buttons}.\\
640 W c & Remove extra {\bf CR}s (^M).\\
641 W e & Fontify {\bf emphasis}, e.g.{} *this* and \_that\_.\\
642 W f & Display any X-{\bf Face} headers.\\
643 W l & (w) Remove page breaks ({\bf^L}).\\
644 W m & Toggle {\bf MIME} processing before displaying.\\
645 W o & Treat {\bf overstrike} (a^Ha) or underline (a^H\_).\\
646 W q & Treat {\bf quoted}-printable (=0D etc).\\
647 W r & (C-c C-r) Caesar-{\bf rotate} (rot13 decode).\\
648 W t & (t) {\bf Toggle} the displaying of all headers.\\
649 W v & (v) Toggle permanent {\bf verbose} displaying of all headers.\\
650 W w & Do word {\bf wrap}. [Prefix: width to use for filling]\\
651 W B & Make headers to mouse-clickable {\bf buttons}.\\
652 W E a & Expunge {\bf all} unwanted blank lines.\\
653 W E l & Expunge {\bf leading} blank lines.\\
654 W E m & Expunge {\bf multiple} blanks lines and replace them with a single
655 blank.\\
656 W E s & Expunge leading {\bf spaces} from every line.\\
657 W E t & Expunge {\bf trailing} blank lines.\\
658 W T e & Display the date as time {\bf elapsed} since sent.\\
659 W T l & Display the date in the {\bf local} timezone.\\
660 W T o & Display the {\bf original} date.\\
661 W T s & Display the date using `gnus-article-time-format'.\\
662 W T u & (W T z) Display the date as {\bf UTC} (aka GMT, Zulu).\\
663 \end{keys}}}
664
665 \def\Hide{\subsubsec{(W W) Hide Parts of the Article}{\samepage
666 Without prefix, these commands toggle hiding; a positive prefix hides and a
667 negative prefix unhides.\\*
668 \begin{keys}{W W C}
669 W W a & Hide {\bf all} unwanted parts.\\
670 W W c & Hide {\bf cited} text.\\
671 W W h & Hide the {\bf headers}.\\
672 W W s & Hide the {\bf signature}.\\
673 W W p & Hide {\bf PGP} signatures.\\
674 W W C & Hide {\bf cited} text if the article is not a root of a thread.\\
675 W W P & Hide {\bf PEM} gruft.\\
676 \end{keys}}}
677
678 \def\Highlight{\subsubsec{(W H) Highlight Parts of the Article}{\samepage
679 \begin{keys}{W H A}
680 W H a & Highlight {\bf all} parts.\\
681 W H c & Highlight {\bf cited} text.\\
682 W H h & Highlight the {\bf headers}.\\
683 W H s & Highlight the {\bf signature}.\\
684 \end{keys}}}
685
686 \def\Extract{\subsec{(X) Extract Series (Uudecode etc)}{\samepage
687 Gnus recognizes if the current article is part of a series (multipart
688 posting whose parts are identified by numbers in the subject, e.g.{}
689 1/10\dots10/10). You can mark and process more than one series at a time. If
690 the posting contains any archives, they are expanded and gathered in a new
691 group.\\*
692 \begin{keys}{X p}
693 X b & Un-{\bf binhex} these series. [p/p]\\
694 X o & Simply {\bf output} these series (no decoding). [p/p]\\
695 X p & Unpack these {\bf postscript} series. [p/p]\\
696 X s & Un-{\bf shar} these series. [p/p]\\
697 X u & {\bf Uudecode} these series. [p/p]\\
698 \end{keys}
699
700 Each one of these commands has four variants:\\*
701 \begin{keys}{X v \bf Z}
702 X \bf z & Decode these series. [p/p]\\
703 X \bf Z & Decode and save these series. [p/p]\\
704 X v \bf z & Decode and view these series. [p/p]\\
705 X v \bf Z & Decode, save and view these series. [p/p]\\
706 \end{keys}
707 where {\bf z} or {\bf Z} identifies the decoding method (b,o,p,s,u).
708
709 An alternative binding for the most-often used of these commands is\\*
710 \begin{keys}{C-c C-v C-v}
711 C-c C-v C-v & (X v u) Uudecode and view these series. [p/p]\\
712 \end{keys}
713 Use `M-x gnus-binary-mode' to do decoding automatically (then use `g' to see
714 the original text of the article).
715 }}
716
717 \def\Exit{\subsec{(Z) Exit the Current Group}{\samepage
718 \begin{keys}{Z G}
719 Z c & (c) Mark all unticked articles as read ({\bf catch-up}) and exit.\\
720 Z n & Mark all articles as read and go to the {\bf next} group.\\
721 Z s & {\bf Save} this group's info in the dribble file. [Prefix: also save .newsrc]\\
722 Z C & Mark all articles as read ({\bf catch-up}) and exit.\\
723 Z E & (Q) {\bf Exit} without updating the group information.\\
724 Z G & (M-g) Check for new articles in this group ({\bf get}).\\
725 Z N & Exit and go to the {\bf next} group.\\
726 Z P & Exit and go to the {\bf previous} group.\\
727 Z R & Exit this group, then ({\bf reenter}) it.
728 [Prefix: select all articles, read and unread.]\\
729 Z Z & (q, Z Q) Exit this group.\\
730 \end{keys}}}
731
732 \def\Limit{\subsec{(/) Limiting the Summary}{\samepage
733 \begin{keys}{/ D}
734 / a & Limit to a given {\bf author}.\\
735 / c & Hide dormant articles that have no {\bf children} (follow-ups).\\
736 / d & Hide all {\bf dormant} articles.\\
737 / m & Limit to articles not having a given {\bf mark}.\\
738 / n & Limit to the current article.\\
739 / s & (/ /) Limit to a given {\bf subject}.\\
740 / t & Limit by {\bf time} (older than a given number of days). [Prefix: newer]\\
741 / u & (x) Limit to {\bf unread} articles. [Prefix: also remove ! and ? articles]\\
742 / v & Limit to high-scored articles ({\bf value}). [score]\\
743 / w & Pop and restore the previous limit from a stack. [Prefix: pop all limits]\\
744 / C & {\bf Catch-up} all unread articles outside the limit. [Prefix: also ! and ? articles]\\
745 / D & Show all {\bf dormant} articles.\\
746 / E & (M S) {\bf Show} all {\bf expunged} articles.\\
747 \end{keys}}}
748
749 \def\PickAndRead{\subsec{Pick-and-Read Mode}{\samepage
750 Use `M-x gnus-pick-mode' to first choose the articles you like and
751 only read them after.\\*
752 \begin{keys}{SPC}
753 SPC & Scroll the summary a page, if at the end start reading.\\
754 RET & Start reading. [Prefix: catch-up all non-picked articles]\\
755 . & Pick this article. [Prefix: pick the article with that number]\\
756 r & Pick all articles in the {\bf region}.\\
757 R & Unpick all articles in the {\bf region}.\\
758 t & Pick this {\bf thread}.\\
759 u & {\bf Unpick} this article.\\
760 T & Unpick this {\bf thread}.\\
761 U & {\bf Unpick} all articles.\\
762 e & Pick articles that match a regexp.\\
763 b & Pick all articles in the {\bf buffer}.\\
764 B & Unpick all articles in the {\bf buffer}.\\
765 \end{keys}}}
766
767 \def\ArticleMode{\sec{Article Mode}{\samepage
768 Most keys in Summary mode also work in Article mode (of course, the normal
769 navigation keys operate on the Article buffer). Additional keys:\\*
770 \begin{keys}{C-c C-m}
771 RET & (middle mouse button) Activate the button at point to follow
772 an URL or Message-ID, hide citation/signature, etc.\\
773 TAB & Move point to the next button.\\
774 M-TAB & Move point to the previous button.\\
775 ? & Give a brief help message.\\
776 h & (s) Go to the {\bf header} line of the article in the {\bf
777 summary} buffer.\\
778 C-c ^ & (r) Get the article with Message-ID near point ({\bf refer}).\\
779 C-c C-m & {\bf Mail} reply to the address near point. [Prefix: cite the
780 article]\\
781 \end{keys}}}
782
783 \def\ServerMode{\sec{Server Mode}{\samepage
784 To enter this mode, press `^' while in Group mode.\\*
785 \begin{keys}{SPC}
786 SPC & (RET) Browse this server.\\
787 a & {\bf Add} a new server.\\
788 c & {\bf Copy} this server.\\
789 e & {\bf Edit} a server.\\
790 g & Ask the server to re-{\bf generate} all its data structures.\\
791 k & {\bf Kill} this server. [scope]\\
792 l & {\bf List} all servers.\\
793 q & Return to the group buffer ({\bf quit}).\\
794 s & Ask the server to {\bf scan} for new messages.\\
795 y & {\bf Yank} the previously killed server.\\
796 C & {\bf Close} the connection to this server.\\
797 O & (Re-){\bf Open} a connection to this server.\\
798 D & Mark this server as unavailable ({\bf deny} it).\\
799 R & {\bf Reset} all unavailability (denial) marks.\\
800 M-c & {\bf Close} the connections to all servers.\\
801 M-o & (Re-){\bf Open} connections to all servers.\\
802 \end{keys}}}
803
804 \def\BrowseServer{\sec{Browse Server Mode}{\samepage
805 To enter this mode, press `B' in Group mode.\\*
806 \begin{keys}{RET}
807 RET & Enter the current group.\\
808 SPC & Enter the current group and display the first article.\\
809 ? & Give a very short help message.\\
810 n & Go to the {\bf next} group. [distance]\\
811 p & Go to the {\bf previous} group. [distance]\\
812 q & (l) {\bf Quit} browse mode.\\
813 u & {\bf [Un]Subscribe} to the current group. [scope]\\
814 \end{keys}}}