d89493c6cc34bc18c037353f57a2fe0b5617d796
[gnus] / texi / gnus.texi
1 \input texinfo
2
3 @setfilename gnus
4 @settitle Gnus Manual
5 @syncodeindex fn cp
6 @syncodeindex vr cp
7 @syncodeindex pg cp
8
9 @documentencoding ISO-8859-1
10
11 @copying
12 Copyright @copyright{} 1995-2011 Free Software Foundation, Inc.
13
14 @quotation
15 Permission is granted to copy, distribute and/or modify this document
16 under the terms of the GNU Free Documentation License, Version 1.3 or
17 any later version published by the Free Software Foundation; with no
18 Invariant Sections, with the Front-Cover texts being ``A GNU Manual'',
19 and with the Back-Cover Texts as in (a) below.  A copy of the license
20 is included in the section entitled ``GNU Free Documentation License''.
21
22 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
23 modify this GNU manual.  Buying copies from the FSF supports it in
24 developing GNU and promoting software freedom.''
25 @end quotation
26 @end copying
27
28 @iftex
29 @iflatex
30 \documentclass[twoside,a4paper,openright,11pt]{book}
31 \usepackage[latin1]{inputenc}
32 \usepackage{pagestyle}
33 \usepackage{epsfig}
34 \usepackage{pixidx}
35 \input{gnusconfig.tex}
36
37 \ifx\pdfoutput\undefined
38 \else
39 \usepackage[pdftex,bookmarks,colorlinks=true]{hyperref}
40 \usepackage{thumbpdf}
41 \pdfcompresslevel=9
42 \fi
43
44 \makeindex
45 \begin{document}
46
47 % Adjust ../Makefile.in if you change the following line:
48 \newcommand{\gnusversionname}{No Gnus v0.11}
49 \newcommand{\gnuschaptername}{}
50 \newcommand{\gnussectionname}{}
51
52 \newcommand{\gnusbackslash}{/}
53
54 \newcommand{\gnusref}[1]{``#1'' on page \pageref{#1}}
55 \ifx\pdfoutput\undefined
56 \newcommand{\gnusuref}[1]{\gnustt{#1}}
57 \else
58 \newcommand{\gnusuref}[1]{\href{#1}{\gnustt{#1}}}
59 \fi
60 \newcommand{\gnusxref}[1]{See ``#1'' on page \pageref{#1}}
61 \newcommand{\gnuspxref}[1]{see ``#1'' on page \pageref{#1}}
62
63 \newcommand{\gnuskindex}[1]{\index{#1}}
64 \newcommand{\gnusindex}[1]{\index{#1}}
65
66 \newcommand{\gnustt}[1]{{\gnusselectttfont{}#1}}
67 \newcommand{\gnuscode}[1]{\gnustt{#1}}
68 \newcommand{\gnusasis}[1]{\gnustt{#1}}
69 \newcommand{\gnusurl}[1]{\gnustt{#1}}
70 \newcommand{\gnuscommand}[1]{\gnustt{#1}}
71 \newcommand{\gnusenv}[1]{\gnustt{#1}}
72 \newcommand{\gnussamp}[1]{``{\fontencoding{OT1}\gnusselectttfont{}#1}''}
73 \newcommand{\gnuslisp}[1]{\gnustt{#1}}
74 \newcommand{\gnuskbd}[1]{`\gnustt{#1}'}
75 \newcommand{\gnuskey}[1]{`\gnustt{#1}'}
76 \newcommand{\gnusfile}[1]{`\gnustt{#1}'}
77 \newcommand{\gnusdfn}[1]{\textit{#1}}
78 \newcommand{\gnusi}[1]{\textit{#1}}
79 \newcommand{\gnusr}[1]{\textrm{#1}}
80 \newcommand{\gnusstrong}[1]{\textbf{#1}}
81 \newcommand{\gnusemph}[1]{\textit{#1}}
82 \newcommand{\gnusvar}[1]{{\fontsize{10pt}{10}\selectfont\textsl{\textsf{#1}}}}
83 \newcommand{\gnussc}[1]{\textsc{#1}}
84 \newcommand{\gnustitle}[1]{{\huge\textbf{#1}}}
85 \newcommand{\gnusversion}[1]{{\small\textit{#1}}}
86 \newcommand{\gnusauthor}[1]{{\large\textbf{#1}}}
87 \newcommand{\gnusresult}[1]{\gnustt{=> #1}}
88 \newcommand{\gnusacronym}[1]{\textsc{#1}}
89 \newcommand{\gnusemail}[1]{\textit{#1}}
90
91 \newcommand{\gnusbullet}{{${\bullet}$}}
92 \newcommand{\gnusdollar}{\$}
93 \newcommand{\gnusampersand}{\&}
94 \newcommand{\gnuspercent}{\%}
95 \newcommand{\gnushash}{\#}
96 \newcommand{\gnushat}{\symbol{"5E}}
97 \newcommand{\gnusunderline}{\symbol{"5F}}
98 \newcommand{\gnusnot}{$\neg$}
99 \newcommand{\gnustilde}{\symbol{"7E}}
100 \newcommand{\gnusless}{{$<$}}
101 \newcommand{\gnusgreater}{{$>$}}
102 \newcommand{\gnusbraceleft}{{$>$}}
103 \newcommand{\gnusbraceright}{{$>$}}
104
105 \newcommand{\gnushead}{\raisebox{-1cm}{\epsfig{figure=ps/gnus-head,height=1cm}}}
106 \newcommand{\gnusinteresting}{
107 \marginpar[\mbox{}\hfill\gnushead]{\gnushead}
108 }
109
110 \newcommand{\gnuscleardoublepage}{\ifodd\count0\mbox{}\clearpage\thispagestyle{empty}\mbox{}\clearpage\else\clearpage\fi}
111
112 \newcommand{\gnuspagechapter}[1]{
113 {\mbox{}}
114 }
115
116 \newdimen{\gnusdimen}
117 \gnusdimen 0pt
118
119 \newcommand{\gnuschapter}[2]{
120 \gnuscleardoublepage
121 \ifdim \gnusdimen = 0pt\setcounter{page}{1}\pagestyle{gnus}\pagenumbering{arabic} \gnusdimen 1pt\fi
122 \chapter{#2}
123 \renewcommand{\gnussectionname}{}
124 \renewcommand{\gnuschaptername}{#2}
125 \thispagestyle{empty}
126 \hspace*{-2cm}
127 \begin{picture}(500,500)(0,0)
128 \put(480,350){\makebox(0,0)[tr]{#1}}
129 \put(40,300){\makebox(500,50)[bl]{{\Huge\bf{#2}}}}
130 \end{picture}
131 \clearpage
132 }
133
134 \newcommand{\gnusfigure}[3]{
135 \begin{figure}
136 \mbox{}\ifodd\count0\hspace*{-0.8cm}\else\hspace*{-3cm}\fi\begin{picture}(440,#2)
137 #3
138 \end{picture}
139 \caption{#1}
140 \end{figure}
141 }
142
143 \newcommand{\gnusicon}[1]{
144 \marginpar[\mbox{}\hfill\raisebox{-1.5cm}{\epsfig{figure=ps/#1-up,height=1.5cm}}]{\raisebox{-1cm}{\epsfig{figure=ps/#1-up,height=1cm}}}
145 }
146
147 \newcommand{\gnuspicon}[1]{
148 \margindex{\epsfig{figure=#1,width=2cm}}
149 }
150
151 \newcommand{\gnusxface}[2]{
152 \margindex{\epsfig{figure=#1,width=1cm}\epsfig{figure=#2,width=1cm}}
153 }
154
155 \newcommand{\gnussmiley}[2]{
156 \margindex{\makebox[2cm]{\hfill\epsfig{figure=#1,width=0.5cm}\hfill\epsfig{figure=#2,width=0.5cm}\hfill}}
157 }
158
159 \newcommand{\gnusitemx}[1]{\mbox{}\vspace*{-\itemsep}\vspace*{-\parsep}\item#1}
160
161 \newcommand{\gnussection}[1]{
162 \renewcommand{\gnussectionname}{#1}
163 \section{#1}
164 }
165
166 \newenvironment{codelist}%
167 {\begin{list}{}{
168 }
169 }{\end{list}}
170
171 \newenvironment{asislist}%
172 {\begin{list}{}{
173 }
174 }{\end{list}}
175
176 \newenvironment{kbdlist}%
177 {\begin{list}{}{
178 \labelwidth=0cm
179 }
180 }{\end{list}}
181
182 \newenvironment{dfnlist}%
183 {\begin{list}{}{
184 }
185 }{\end{list}}
186
187 \newenvironment{stronglist}%
188 {\begin{list}{}{
189 }
190 }{\end{list}}
191
192 \newenvironment{samplist}%
193 {\begin{list}{}{
194 }
195 }{\end{list}}
196
197 \newenvironment{varlist}%
198 {\begin{list}{}{
199 }
200 }{\end{list}}
201
202 \newenvironment{emphlist}%
203 {\begin{list}{}{
204 }
205 }{\end{list}}
206
207 \newlength\gnusheadtextwidth
208 \setlength{\gnusheadtextwidth}{\headtextwidth}
209 \addtolength{\gnusheadtextwidth}{1cm}
210
211 \newpagestyle{gnuspreamble}%
212 {
213 {
214 \ifodd\count0
215 {
216 \hspace*{-0.23cm}\underline{\makebox[\gnusheadtextwidth]{\mbox{}}\textbf{\hfill\roman{page}}}
217 }
218 \else
219 {
220 \hspace*{-3.25cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\roman{page}\hfill\mbox{}}}
221 }
222 }
223 \fi
224 }
225 }
226 {
227 \ifodd\count0
228 \mbox{} \hfill
229 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo,height=1cm}}
230 \else
231 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo,height=1cm}}
232 \hfill \mbox{}
233 \fi
234 }
235
236 \newpagestyle{gnusindex}%
237 {
238 {
239 \ifodd\count0
240 {
241 \hspace*{-0.23cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\gnuschaptername\hfill\arabic{page}}}}
242 }
243 \else
244 {
245 \hspace*{-3.25cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\arabic{page}\hfill\gnuschaptername}}}
246 }
247 \fi
248 }
249 }
250 {
251 \ifodd\count0
252 \mbox{} \hfill
253 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo,height=1cm}}
254 \else
255 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo,height=1cm}}
256 \hfill \mbox{}
257 \fi
258 }
259
260 \newpagestyle{gnus}%
261 {
262 {
263 \ifodd\count0
264 {
265 \makebox[12cm]{\hspace*{3.1cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\arabic{chapter}.\arabic{section}} \textbf{\gnussectionname\hfill\arabic{page}}}}}
266 }
267 \else
268 {
269 \makebox[12cm]{\hspace*{-2.95cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\arabic{page}\hfill\gnuschaptername}}}}
270 }
271 \fi
272 }
273 }
274 {
275 \ifodd\count0
276 \mbox{} \hfill
277 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo,height=1cm}}
278 \else
279 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo,height=1cm}}
280 \hfill \mbox{}
281 \fi
282 }
283
284 \pagenumbering{roman}
285 \pagestyle{gnuspreamble}
286
287 @end iflatex
288 @end iftex
289
290 @iftex
291 @iflatex
292
293 \begin{titlepage}
294 {
295
296 %\addtolength{\oddsidemargin}{-5cm}
297 %\addtolength{\evensidemargin}{-5cm}
298 \parindent=0cm
299 \addtolength{\textheight}{2cm}
300
301 \gnustitle{\gnustitlename}\hfill\gnusversion{\gnusversionname}\\
302 \rule{15cm}{1mm}\\
303 \vfill
304 \hspace*{0cm}\epsfig{figure=ps/gnus-big-logo,height=15cm}
305 \vfill
306 \rule{15cm}{1mm}\\
307 \gnusauthor{by Lars Magne Ingebrigtsen}
308 \newpage
309 }
310
311 \mbox{}
312 \vfill
313
314 \thispagestyle{empty}
315
316 @c @insertcopying
317 \newpage
318 \end{titlepage}
319 @end iflatex
320 @end iftex
321
322 @dircategory Emacs
323 @direntry
324 * Gnus: (gnus).                 The newsreader Gnus.
325 @end direntry
326 @iftex
327 @finalout
328 @end iftex
329
330
331 @titlepage
332 @title Gnus Manual
333
334 @author by Lars Magne Ingebrigtsen
335 @page
336 @vskip 0pt plus 1filll
337 @insertcopying
338 @end titlepage
339
340 @summarycontents
341 @contents
342
343 @node Top
344 @top The Gnus Newsreader
345
346 @ifinfo
347
348 You can read news (and mail) from within Emacs by using Gnus.  The news
349 can be gotten by any nefarious means you can think of---@acronym{NNTP}, local
350 spool or your mbox file.  All at the same time, if you want to push your
351 luck.
352
353 @c Adjust ../Makefile.in if you change the following line:
354 This manual corresponds to No Gnus v0.11.
355
356 @ifnottex
357 @insertcopying
358 @end ifnottex
359
360 @end ifinfo
361
362 @iftex
363
364 @iflatex
365 \tableofcontents
366 \gnuscleardoublepage
367 @end iflatex
368
369 Gnus is the advanced, self-documenting, customizable, extensible
370 unreal-time newsreader for GNU Emacs.
371
372 Oops.  That sounds oddly familiar, so let's start over again to avoid
373 being accused of plagiarism:
374
375 Gnus is a message-reading laboratory.  It will let you look at just
376 about anything as if it were a newsgroup.  You can read mail with it,
377 you can browse directories with it, you can @code{ftp} with it---you
378 can even read news with it!
379
380 Gnus tries to empower people who read news the same way Emacs empowers
381 people who edit text.  Gnus sets no limits to what the user should be
382 allowed to do.  Users are encouraged to extend Gnus to make it behave
383 like they want it to behave.  A program should not control people;
384 people should be empowered to do what they want by using (or abusing)
385 the program.
386
387 @c Adjust ../Makefile.in if you change the following line:
388 This manual corresponds to No Gnus v0.11.
389
390 @heading Other related manuals
391 @itemize
392 @item Message manual: Composing messages
393 @item Emacs-MIME:     Composing messages; @acronym{MIME}-specific parts.
394 @item Sieve:          Managing Sieve scripts in Emacs.
395 @item PGG:            @acronym{PGP/MIME} with Gnus.
396 @item SASL:           @acronym{SASL} authentication in Emacs.
397 @end itemize
398
399 @end iftex
400
401 @menu
402 * Starting Up::              Finding news can be a pain.
403 * Group Buffer::             Selecting, subscribing and killing groups.
404 * Summary Buffer::           Reading, saving and posting articles.
405 * Article Buffer::           Displaying and handling articles.
406 * Composing Messages::       Information on sending mail and news.
407 * Select Methods::           Gnus reads all messages from various select methods.
408 * Scoring::                  Assigning values to articles.
409 * Searching::                Mail and News search engines.
410 * Various::                  General purpose settings.
411 * The End::                  Farewell and goodbye.
412 * Appendices::               Terminology, Emacs intro, @acronym{FAQ}, History, Internals.
413 * GNU Free Documentation License:: The license for this documentation.
414 * Index::                    Variable, function and concept index.
415 * Key Index::                Key Index.
416
417 Other related manuals
418
419 * Message:(message).         Composing messages.
420 * Emacs-MIME:(emacs-mime).   Composing messages; @acronym{MIME}-specific parts.
421 * Sieve:(sieve).             Managing Sieve scripts in Emacs.
422 * PGG:(pgg).                 @acronym{PGP/MIME} with Gnus.
423 * SASL:(sasl).               @acronym{SASL} authentication in Emacs.
424
425 @detailmenu
426  --- The Detailed Node Listing ---
427
428 Starting Gnus
429
430 * Finding the News::            Choosing a method for getting news.
431 * The Server is Down::          How can I read my mail then?
432 * Slave Gnusae::                You can have more than one Gnus active at a time.
433 * Fetching a Group::            Starting Gnus just to read a group.
434 * New Groups::                  What is Gnus supposed to do with new groups?
435 * Changing Servers::            You may want to move from one server to another.
436 * Startup Files::               Those pesky startup files---@file{.newsrc}.
437 * Auto Save::                   Recovering from a crash.
438 * The Active File::             Reading the active file over a slow line Takes Time.
439 * Startup Variables::           Other variables you might change.
440
441 New Groups
442
443 * Checking New Groups::         Determining what groups are new.
444 * Subscription Methods::        What Gnus should do with new groups.
445 * Filtering New Groups::        Making Gnus ignore certain new groups.
446
447 Group Buffer
448
449 * Group Buffer Format::         Information listed and how you can change it.
450 * Group Maneuvering::           Commands for moving in the group buffer.
451 * Selecting a Group::           Actually reading news.
452 * Subscription Commands::       Unsubscribing, killing, subscribing.
453 * Group Data::                  Changing the info for a group.
454 * Group Levels::                Levels? What are those, then?
455 * Group Score::                 A mechanism for finding out what groups you like.
456 * Marking Groups::              You can mark groups for later processing.
457 * Foreign Groups::              Creating and editing groups.
458 * Group Parameters::            Each group may have different parameters set.
459 * Listing Groups::              Gnus can list various subsets of the groups.
460 * Sorting Groups::              Re-arrange the group order.
461 * Group Maintenance::           Maintaining a tidy @file{.newsrc} file.
462 * Browse Foreign Server::       You can browse a server.  See what it has to offer.
463 * Exiting Gnus::                Stop reading news and get some work done.
464 * Group Topics::                A folding group mode divided into topics.
465 * Non-ASCII Group Names::       Accessing groups of non-English names.
466 * Misc Group Stuff::            Other stuff that you can to do.
467
468 Group Buffer Format
469
470 * Group Line Specification::    Deciding how the group buffer is to look.
471 * Group Mode Line Specification::  The group buffer mode line.
472 * Group Highlighting::          Having nice colors in the group buffer.
473
474 Group Topics
475
476 * Topic Commands::              Interactive E-Z commands.
477 * Topic Variables::             How to customize the topics the Lisp Way.
478 * Topic Sorting::               Sorting each topic individually.
479 * Topic Topology::              A map of the world.
480 * Topic Parameters::            Parameters that apply to all groups in a topic.
481
482 Misc Group Stuff
483
484 * Scanning New Messages::       Asking Gnus to see whether new messages have arrived.
485 * Group Information::           Information and help on groups and Gnus.
486 * Group Timestamp::             Making Gnus keep track of when you last read a group.
487 * File Commands::               Reading and writing the Gnus files.
488 * Sieve Commands::              Managing Sieve scripts.
489
490 Summary Buffer
491
492 * Summary Buffer Format::       Deciding how the summary buffer is to look.
493 * Summary Maneuvering::         Moving around the summary buffer.
494 * Choosing Articles::           Reading articles.
495 * Paging the Article::          Scrolling the current article.
496 * Reply Followup and Post::     Posting articles.
497 * Delayed Articles::            Send articles at a later time.
498 * Marking Articles::            Marking articles as read, expirable, etc.
499 * Limiting::                    You can limit the summary buffer.
500 * Threading::                   How threads are made.
501 * Sorting the Summary Buffer::  How articles and threads are sorted.
502 * Asynchronous Fetching::       Gnus might be able to pre-fetch articles.
503 * Article Caching::             You may store articles in a cache.
504 * Persistent Articles::         Making articles expiry-resistant.
505 * Sticky Articles::             Article buffers that are not reused.
506 * Article Backlog::             Having already read articles hang around.
507 * Saving Articles::             Ways of customizing article saving.
508 * Decoding Articles::           Gnus can treat series of (uu)encoded articles.
509 * Article Treatment::           The article buffer can be mangled at will.
510 * MIME Commands::               Doing MIMEy things with the articles.
511 * Charsets::                    Character set issues.
512 * Article Commands::            Doing various things with the article buffer.
513 * Summary Sorting::             Sorting the summary buffer in various ways.
514 * Finding the Parent::          No child support? Get the parent.
515 * Alternative Approaches::      Reading using non-default summaries.
516 * Tree Display::                A more visual display of threads.
517 * Mail Group Commands::         Some commands can only be used in mail groups.
518 * Various Summary Stuff::       What didn't fit anywhere else.
519 * Exiting the Summary Buffer::  Returning to the Group buffer,
520                                 or reselecting the current group.
521 * Crosspost Handling::          How crossposted articles are dealt with.
522 * Duplicate Suppression::       An alternative when crosspost handling fails.
523 * Security::                    Decrypt and Verify.
524 * Mailing List::                Mailing list minor mode.
525
526 Summary Buffer Format
527
528 * Summary Buffer Lines::        You can specify how summary lines should look.
529 * To From Newsgroups::          How to not display your own name.
530 * Summary Buffer Mode Line::    You can say how the mode line should look.
531 * Summary Highlighting::        Making the summary buffer all pretty and nice.
532
533 Choosing Articles
534
535 * Choosing Commands::           Commands for choosing articles.
536 * Choosing Variables::          Variables that influence these commands.
537
538 Reply, Followup and Post
539
540 * Summary Mail Commands::       Sending mail.
541 * Summary Post Commands::       Sending news.
542 * Summary Message Commands::    Other Message-related commands.
543 * Canceling and Superseding::
544
545 Marking Articles
546
547 * Unread Articles::             Marks for unread articles.
548 * Read Articles::               Marks for read articles.
549 * Other Marks::                 Marks that do not affect readedness.
550 * Setting Marks::               How to set and remove marks.
551 * Generic Marking Commands::    How to customize the marking.
552 * Setting Process Marks::       How to mark articles for later processing.
553
554 Threading
555
556 * Customizing Threading::       Variables you can change to affect the threading.
557 * Thread Commands::             Thread based commands in the summary buffer.
558
559 Customizing Threading
560
561 * Loose Threads::               How Gnus gathers loose threads into bigger threads.
562 * Filling In Threads::          Making the threads displayed look fuller.
563 * More Threading::              Even more variables for fiddling with threads.
564 * Low-Level Threading::         You thought it was over@dots{} but you were wrong!
565
566 Decoding Articles
567
568 * Uuencoded Articles::          Uudecode articles.
569 * Shell Archives::              Unshar articles.
570 * PostScript Files::            Split PostScript.
571 * Other Files::                 Plain save and binhex.
572 * Decoding Variables::          Variables for a happy decoding.
573 * Viewing Files::               You want to look at the result of the decoding?
574
575 Decoding Variables
576
577 * Rule Variables::              Variables that say how a file is to be viewed.
578 * Other Decode Variables::      Other decode variables.
579 * Uuencoding and Posting::      Variables for customizing uuencoding.
580
581 Article Treatment
582
583 * Article Highlighting::        You want to make the article look like fruit salad.
584 * Article Fontisizing::         Making emphasized text look nice.
585 * Article Hiding::              You also want to make certain info go away.
586 * Article Washing::             Lots of way-neat functions to make life better.
587 * Article Header::              Doing various header transformations.
588 * Article Buttons::             Click on URLs, Message-IDs, addresses and the like.
589 * Article Button Levels::       Controlling appearance of buttons.
590 * Article Date::                Grumble, UT!
591 * Article Display::             Display various stuff---X-Face, Picons, Smileys, Gravatars
592 * Article Signature::           What is a signature?
593 * Article Miscellanea::         Various other stuff.
594
595 Alternative Approaches
596
597 * Pick and Read::               First mark articles and then read them.
598 * Binary Groups::               Auto-decode all articles.
599
600 Various Summary Stuff
601
602 * Summary Group Information::   Information oriented commands.
603 * Searching for Articles::      Multiple article commands.
604 * Summary Generation Commands::
605 * Really Various Summary Commands::  Those pesky non-conformant commands.
606
607 Article Buffer
608
609 * Hiding Headers::              Deciding what headers should be displayed.
610 * Using MIME::                  Pushing articles through @acronym{MIME} before reading them.
611 * Customizing Articles::        Tailoring the look of the articles.
612 * Article Keymap::              Keystrokes available in the article buffer.
613 * Misc Article::                Other stuff.
614
615 Composing Messages
616
617 * Mail::                        Mailing and replying.
618 * Posting Server::              What server should you post and mail via?
619 * POP before SMTP::             You cannot send a mail unless you read a mail.
620 * Mail and Post::               Mailing and posting at the same time.
621 * Archived Messages::           Where Gnus stores the messages you've sent.
622 * Posting Styles::              An easier way to specify who you are.
623 * Drafts::                      Postponing messages and rejected messages.
624 * Rejected Articles::           What happens if the server doesn't like your article?
625 * Signing and encrypting::      How to compose secure messages.
626
627 Select Methods
628
629 * Server Buffer::               Making and editing virtual servers.
630 * Getting News::                Reading USENET news with Gnus.
631 * Using IMAP::                  Reading mail from @acronym{IMAP}.
632 * Getting Mail::                Reading your personal mail with Gnus.
633 * Browsing the Web::            Getting messages from a plethora of Web sources.
634 * Other Sources::               Reading directories, files.
635 * Combined Groups::             Combining groups into one group.
636 * Email Based Diary::           Using mails to manage diary events in Gnus.
637 * Gnus Unplugged::              Reading news and mail offline.
638
639 Server Buffer
640
641 * Server Buffer Format::        You can customize the look of this buffer.
642 * Server Commands::             Commands to manipulate servers.
643 * Example Methods::             Examples server specifications.
644 * Creating a Virtual Server::   An example session.
645 * Server Variables::            Which variables to set.
646 * Servers and Methods::         You can use server names as select methods.
647 * Unavailable Servers::         Some servers you try to contact may be down.
648
649 Getting News
650
651 * NNTP::                        Reading news from an @acronym{NNTP} server.
652 * News Spool::                  Reading news from the local spool.
653
654 @acronym{NNTP}
655
656 * Direct Functions::            Connecting directly to the server.
657 * Indirect Functions::          Connecting indirectly to the server.
658 * Common Variables::            Understood by several connection functions.
659 * NNTP marks::                  Storing marks for @acronym{NNTP} servers.
660
661 Getting Mail
662
663 * Mail in a Newsreader::        Important introductory notes.
664 * Getting Started Reading Mail::  A simple cookbook example.
665 * Splitting Mail::              How to create mail groups.
666 * Mail Sources::                How to tell Gnus where to get mail from.
667 * Mail Back End Variables::     Variables for customizing mail handling.
668 * Fancy Mail Splitting::        Gnus can do hairy splitting of incoming mail.
669 * Group Mail Splitting::        Use group customize to drive mail splitting.
670 * Incorporating Old Mail::      What about the old mail you have?
671 * Expiring Mail::               Getting rid of unwanted mail.
672 * Washing Mail::                Removing cruft from the mail you get.
673 * Duplicates::                  Dealing with duplicated mail.
674 * Not Reading Mail::            Using mail back ends for reading other files.
675 * Choosing a Mail Back End::    Gnus can read a variety of mail formats.
676
677 Mail Sources
678
679 * Mail Source Specifiers::      How to specify what a mail source is.
680 * Mail Source Customization::   Some variables that influence things.
681 * Fetching Mail::               Using the mail source specifiers.
682
683 Choosing a Mail Back End
684
685 * Unix Mail Box::               Using the (quite) standard Un*x mbox.
686 * Babyl::                       Babyl was used by older versions of Rmail.
687 * Mail Spool::                  Store your mail in a private spool?
688 * MH Spool::                    An mhspool-like back end.
689 * Maildir::                     Another one-file-per-message format.
690 * Mail Folders::                Having one file for each group.
691 * Comparing Mail Back Ends::    An in-depth looks at pros and cons.
692
693 Browsing the Web
694
695 * Archiving Mail::
696 * Web Searches::                Creating groups from articles that match a string.
697 * RSS::                         Reading RDF site summary.
698 * Customizing W3::              Doing stuff to Emacs/W3 from Gnus.
699
700 Other Sources
701
702 * Directory Groups::            You can read a directory as if it was a newsgroup.
703 * Anything Groups::             Dired?  Who needs dired?
704 * Document Groups::             Single files can be the basis of a group.
705 * Mail-To-News Gateways::       Posting articles via mail-to-news gateways.
706 * The Empty Backend::           The backend that never has any news.
707
708 Document Groups
709
710 * Document Server Internals::   How to add your own document types.
711
712 Combined Groups
713
714 * Virtual Groups::              Combining articles from many groups.
715
716 Email Based Diary
717
718 * The NNDiary Back End::        Basic setup and usage.
719 * The Gnus Diary Library::      Utility toolkit on top of nndiary.
720 * Sending or Not Sending::      A final note on sending diary messages.
721
722 The NNDiary Back End
723
724 * Diary Messages::              What makes a message valid for nndiary.
725 * Running NNDiary::             NNDiary has two modes of operation.
726 * Customizing NNDiary::         Bells and whistles.
727
728 The Gnus Diary Library
729
730 * Diary Summary Line Format::           A nicer summary buffer line format.
731 * Diary Articles Sorting::              A nicer way to sort messages.
732 * Diary Headers Generation::            Not doing it manually.
733 * Diary Group Parameters::              Not handling them manually.
734
735 Gnus Unplugged
736
737 * Agent Basics::                How it all is supposed to work.
738 * Agent Categories::            How to tell the Gnus Agent what to download.
739 * Agent Commands::              New commands for all the buffers.
740 * Agent Visuals::               Ways that the agent may effect your summary buffer.
741 * Agent as Cache::              The Agent is a big cache too.
742 * Agent Expiry::                How to make old articles go away.
743 * Agent Regeneration::          How to recover from lost connections and other accidents.
744 * Agent and flags::             How the Agent maintains flags.
745 * Agent and IMAP::              How to use the Agent with @acronym{IMAP}.
746 * Outgoing Messages::           What happens when you post/mail something?
747 * Agent Variables::             Customizing is fun.
748 * Example Setup::               An example @file{~/.gnus.el} file for offline people.
749 * Batching Agents::             How to fetch news from a @code{cron} job.
750 * Agent Caveats::               What you think it'll do and what it does.
751
752 Agent Categories
753
754 * Category Syntax::             What a category looks like.
755 * Category Buffer::             A buffer for maintaining categories.
756 * Category Variables::          Customize'r'Us.
757
758 Agent Commands
759
760 * Group Agent Commands::        Configure groups and fetch their contents.
761 * Summary Agent Commands::      Manually select then fetch specific articles.
762 * Server Agent Commands::       Select the servers that are supported by the agent.
763
764 Scoring
765
766 * Summary Score Commands::      Adding score entries for the current group.
767 * Group Score Commands::        General score commands.
768 * Score Variables::             Customize your scoring.  (My, what terminology).
769 * Score File Format::           What a score file may contain.
770 * Score File Editing::          You can edit score files by hand as well.
771 * Adaptive Scoring::            Big Sister Gnus knows what you read.
772 * Home Score File::             How to say where new score entries are to go.
773 * Followups To Yourself::       Having Gnus notice when people answer you.
774 * Scoring On Other Headers::    Scoring on non-standard headers.
775 * Scoring Tips::                How to score effectively.
776 * Reverse Scoring::             That problem child of old is not problem.
777 * Global Score Files::          Earth-spanning, ear-splitting score files.
778 * Kill Files::                  They are still here, but they can be ignored.
779 * Converting Kill Files::       Translating kill files to score files.
780 * Advanced Scoring::            Using logical expressions to build score rules.
781 * Score Decays::                It can be useful to let scores wither away.
782
783 Advanced Scoring
784
785 * Advanced Scoring Syntax::     A definition.
786 * Advanced Scoring Examples::   What they look like.
787 * Advanced Scoring Tips::       Getting the most out of it.
788
789 Searching
790
791 * nnir::                        Searching with various engines.
792 * nnmairix::                    Searching with Mairix.
793
794 nnir
795
796 * What is nnir?::               What does nnir do.
797 * Basic Usage::                 How to perform simple searches.
798 * Setting up nnir::             How to set up nnir.
799
800 Setting up nnir
801
802 * Associating Engines::         How to associate engines.
803
804 Various
805
806 * Process/Prefix::              A convention used by many treatment commands.
807 * Interactive::                 Making Gnus ask you many questions.
808 * Symbolic Prefixes::           How to supply some Gnus functions with options.
809 * Formatting Variables::        You can specify what buffers should look like.
810 * Window Layout::               Configuring the Gnus buffer windows.
811 * Faces and Fonts::             How to change how faces look.
812 * Compilation::                 How to speed Gnus up.
813 * Mode Lines::                  Displaying information in the mode lines.
814 * Highlighting and Menus::      Making buffers look all nice and cozy.
815 * Daemons::                     Gnus can do things behind your back.
816 * Undo::                        Some actions can be undone.
817 * Predicate Specifiers::        Specifying predicates.
818 * Moderation::                  What to do if you're a moderator.
819 * Image Enhancements::          Modern versions of Emacs/XEmacs can display images.
820 * Fuzzy Matching::              What's the big fuzz?
821 * Thwarting Email Spam::        Simple ways to avoid unsolicited commercial email.
822 * Spam Package::                A package for filtering and processing spam.
823 * The Gnus Registry::           A package for tracking messages by Message-ID.
824 * Other modes::                 Interaction with other modes.
825 * Various Various::             Things that are really various.
826
827 Formatting Variables
828
829 * Formatting Basics::           A formatting variable is basically a format string.
830 * Mode Line Formatting::        Some rules about mode line formatting variables.
831 * Advanced Formatting::         Modifying output in various ways.
832 * User-Defined Specs::          Having Gnus call your own functions.
833 * Formatting Fonts::            Making the formatting look colorful and nice.
834 * Positioning Point::           Moving point to a position after an operation.
835 * Tabulation::                  Tabulating your output.
836 * Wide Characters::             Dealing with wide characters.
837
838 Image Enhancements
839
840 * X-Face::                      Display a funky, teensy black-and-white image.
841 * Face::                        Display a funkier, teensier colored image.
842 * Smileys::                     Show all those happy faces the way they were
843                                   meant to be shown.
844 * Picons::                      How to display pictures of what you're reading.
845 * Gravatars::                   Display the avatar of people you read.
846 * XVarious::                    Other XEmacsy Gnusey variables.
847
848 Thwarting Email Spam
849
850 * The problem of spam::         Some background, and some solutions
851 * Anti-Spam Basics::            Simple steps to reduce the amount of spam.
852 * SpamAssassin::                How to use external anti-spam tools.
853 * Hashcash::                    Reduce spam by burning CPU time.
854
855 Spam Package
856
857 * Spam Package Introduction::
858 * Filtering Incoming Mail::
859 * Detecting Spam in Groups::
860 * Spam and Ham Processors::
861 * Spam Package Configuration Examples::
862 * Spam Back Ends::
863 * Extending the Spam package::
864 * Spam Statistics Package::
865
866 Spam Statistics Package
867
868 * Creating a spam-stat dictionary::
869 * Splitting mail using spam-stat::
870 * Low-level interface to the spam-stat dictionary::
871
872 Appendices
873
874 * XEmacs::                      Requirements for installing under XEmacs.
875 * History::                     How Gnus got where it is today.
876 * On Writing Manuals::          Why this is not a beginner's guide.
877 * Terminology::                 We use really difficult, like, words here.
878 * Customization::               Tailoring Gnus to your needs.
879 * Troubleshooting::             What you might try if things do not work.
880 * Gnus Reference Guide::        Rilly, rilly technical stuff.
881 * Emacs for Heathens::          A short introduction to Emacsian terms.
882 * Frequently Asked Questions::  The Gnus FAQ
883
884 History
885
886 * Gnus Versions::               What Gnus versions have been released.
887 * Other Gnus Versions::         Other Gnus versions that also have been released.
888 * Why?::                        What's the point of Gnus?
889 * Compatibility::               Just how compatible is Gnus with @sc{gnus}?
890 * Conformity::                  Gnus tries to conform to all standards.
891 * Emacsen::                     Gnus can be run on a few modern Emacsen.
892 * Gnus Development::            How Gnus is developed.
893 * Contributors::                Oodles of people.
894 * New Features::                Pointers to some of the new stuff in Gnus.
895
896 New Features
897
898 * ding Gnus::                   New things in Gnus 5.0/5.1, the first new Gnus.
899 * September Gnus::              The Thing Formally Known As Gnus 5.2/5.3.
900 * Red Gnus::                    Third time best---Gnus 5.4/5.5.
901 * Quassia Gnus::                Two times two is four, or Gnus 5.6/5.7.
902 * Pterodactyl Gnus::            Pentad also starts with P, AKA Gnus 5.8/5.9.
903 * Oort Gnus::                   It's big.  It's far out.  Gnus 5.10/5.11.
904 * No Gnus::                     Very punny.
905
906 Customization
907
908 * Slow/Expensive Connection::   You run a local Emacs and get the news elsewhere.
909 * Slow Terminal Connection::    You run a remote Emacs.
910 * Little Disk Space::           You feel that having large setup files is icky.
911 * Slow Machine::                You feel like buying a faster machine.
912
913 Gnus Reference Guide
914
915 * Gnus Utility Functions::      Common functions and variable to use.
916 * Back End Interface::          How Gnus communicates with the servers.
917 * Score File Syntax::           A BNF definition of the score file standard.
918 * Headers::                     How Gnus stores headers internally.
919 * Ranges::                      A handy format for storing mucho numbers.
920 * Group Info::                  The group info format.
921 * Extended Interactive::        Symbolic prefixes and stuff.
922 * Emacs/XEmacs Code::           Gnus can be run under all modern Emacsen.
923 * Various File Formats::        Formats of files that Gnus use.
924
925 Back End Interface
926
927 * Required Back End Functions::  Functions that must be implemented.
928 * Optional Back End Functions::  Functions that need not be implemented.
929 * Error Messaging::             How to get messages and report errors.
930 * Writing New Back Ends::       Extending old back ends.
931 * Hooking New Back Ends Into Gnus::  What has to be done on the Gnus end.
932 * Mail-like Back Ends::         Some tips on mail back ends.
933
934 Various File Formats
935
936 * Active File Format::          Information on articles and groups available.
937 * Newsgroups File Format::      Group descriptions.
938
939 Emacs for Heathens
940
941 * Keystrokes::                  Entering text and executing commands.
942 * Emacs Lisp::                  The built-in Emacs programming language.
943
944 @end detailmenu
945 @end menu
946
947 @node Starting Up
948 @chapter Starting Gnus
949 @cindex starting up
950
951 If you haven't used Emacs much before using Gnus, read @ref{Emacs for
952 Heathens} first.
953
954 @kindex M-x gnus
955 @findex gnus
956 If your system administrator has set things up properly, starting Gnus
957 and reading news is extremely easy---you just type @kbd{M-x gnus} in
958 your Emacs.  If not, you should customize the variable
959 @code{gnus-select-method} as described in @ref{Finding the News}.  For a
960 minimal setup for posting should also customize the variables
961 @code{user-full-name} and @code{user-mail-address}.
962
963 @findex gnus-other-frame
964 @kindex M-x gnus-other-frame
965 If you want to start Gnus in a different frame, you can use the command
966 @kbd{M-x gnus-other-frame} instead.
967
968 If things do not go smoothly at startup, you have to twiddle some
969 variables in your @file{~/.gnus.el} file.  This file is similar to
970 @file{~/.emacs}, but is read when Gnus starts.
971
972 If you puzzle at any terms used in this manual, please refer to the
973 terminology section (@pxref{Terminology}).
974
975 @menu
976 * Finding the News::      Choosing a method for getting news.
977 * The Server is Down::    How can I read my mail then?
978 * Slave Gnusae::          You can have more than one Gnus active at a time.
979 * New Groups::            What is Gnus supposed to do with new groups?
980 * Changing Servers::      You may want to move from one server to another.
981 * Startup Files::         Those pesky startup files---@file{.newsrc}.
982 * Auto Save::             Recovering from a crash.
983 * The Active File::       Reading the active file over a slow line Takes Time.
984 * Startup Variables::     Other variables you might change.
985 @end menu
986
987
988 @node Finding the News
989 @section Finding the News
990 @cindex finding news
991
992 First of all, you should know that there is a special buffer called
993 @code{*Server*} that lists all the servers Gnus knows about.  You can
994 press @kbd{^} from the Group buffer to see it.  In the Server buffer,
995 you can press @kbd{RET} on a defined server to see all the groups it
996 serves (subscribed or not!).  You can also add or delete servers, edit
997 a foreign server's definition, agentize or de-agentize a server, and
998 do many other neat things.  @xref{Server Buffer}.  
999 @xref{Foreign Groups}.  @xref{Agent Basics}.
1000
1001 @vindex gnus-select-method
1002 @c @head
1003 The @code{gnus-select-method} variable says where Gnus should look for
1004 news.  This variable should be a list where the first element says
1005 @dfn{how} and the second element says @dfn{where}.  This method is your
1006 native method.  All groups not fetched with this method are
1007 foreign groups.
1008
1009 For instance, if the @samp{news.somewhere.edu} @acronym{NNTP} server is where
1010 you want to get your daily dosage of news from, you'd say:
1011
1012 @lisp
1013 (setq gnus-select-method '(nntp "news.somewhere.edu"))
1014 @end lisp
1015
1016 If you want to read directly from the local spool, say:
1017
1018 @lisp
1019 (setq gnus-select-method '(nnspool ""))
1020 @end lisp
1021
1022 If you can use a local spool, you probably should, as it will almost
1023 certainly be much faster.  But do not use the local spool if your
1024 server is running Leafnode (which is a simple, standalone private news
1025 server); in this case, use @code{(nntp "localhost")}.
1026
1027 @vindex gnus-nntpserver-file
1028 @cindex NNTPSERVER
1029 @cindex @acronym{NNTP} server
1030 If this variable is not set, Gnus will take a look at the
1031 @env{NNTPSERVER} environment variable.  If that variable isn't set,
1032 Gnus will see whether @code{gnus-nntpserver-file}
1033 (@file{/etc/nntpserver} by default) has any opinions on the matter.
1034 If that fails as well, Gnus will try to use the machine running Emacs
1035 as an @acronym{NNTP} server.  That's a long shot, though.
1036
1037 @findex gnus-group-browse-foreign-server
1038 @kindex B (Group)
1039 However, if you use one @acronym{NNTP} server regularly and are just
1040 interested in a couple of groups from a different server, you would be
1041 better served by using the @kbd{B} command in the group buffer.  It will
1042 let you have a look at what groups are available, and you can subscribe
1043 to any of the groups you want to.  This also makes @file{.newsrc}
1044 maintenance much tidier.  @xref{Foreign Groups}.
1045
1046 @vindex gnus-secondary-select-methods
1047 @c @head
1048 A slightly different approach to foreign groups is to set the
1049 @code{gnus-secondary-select-methods} variable.  The select methods
1050 listed in this variable are in many ways just as native as the
1051 @code{gnus-select-method} server.  They will also be queried for active
1052 files during startup (if that's required), and new newsgroups that
1053 appear on these servers will be subscribed (or not) just as native
1054 groups are.
1055
1056 For instance, if you use the @code{nnmbox} back end to read your mail,
1057 you would typically set this variable to
1058
1059 @lisp
1060 (setq gnus-secondary-select-methods '((nnmbox "")))
1061 @end lisp
1062
1063 Note: the @acronym{NNTP} back end stores marks in marks files
1064 (@pxref{NNTP marks}).  This feature makes it easy to share marks between
1065 several Gnus installations, but may slow down things a bit when fetching
1066 new articles.  @xref{NNTP marks}, for more information.
1067
1068
1069 @node The Server is Down
1070 @section The Server is Down
1071 @cindex server errors
1072
1073 If the default server is down, Gnus will understandably have some
1074 problems starting.  However, if you have some mail groups in addition to
1075 the news groups, you may want to start Gnus anyway.
1076
1077 Gnus, being the trusting sort of program, will ask whether to proceed
1078 without a native select method if that server can't be contacted.  This
1079 will happen whether the server doesn't actually exist (i.e., you have
1080 given the wrong address) or the server has just momentarily taken ill
1081 for some reason or other.  If you decide to continue and have no foreign
1082 groups, you'll find it difficult to actually do anything in the group
1083 buffer.  But, hey, that's your problem.  Blllrph!
1084
1085 @findex gnus-no-server
1086 @kindex M-x gnus-no-server
1087 @c @head
1088 If you know that the server is definitely down, or you just want to read
1089 your mail without bothering with the server at all, you can use the
1090 @code{gnus-no-server} command to start Gnus.  That might come in handy
1091 if you're in a hurry as well.  This command will not attempt to contact
1092 your primary server---instead, it will just activate all groups on level
1093 1 and 2.  (You should preferably keep no native groups on those two
1094 levels.) Also @pxref{Group Levels}.
1095
1096
1097 @node Slave Gnusae
1098 @section Slave Gnusae
1099 @cindex slave
1100
1101 You might want to run more than one Emacs with more than one Gnus at the
1102 same time.  If you are using different @file{.newsrc} files (e.g., if you
1103 are using the two different Gnusae to read from two different servers),
1104 that is no problem whatsoever.  You just do it.
1105
1106 The problem appears when you want to run two Gnusae that use the same
1107 @file{.newsrc} file.
1108
1109 To work around that problem some, we here at the Think-Tank at the Gnus
1110 Towers have come up with a new concept: @dfn{Masters} and
1111 @dfn{slaves}.  (We have applied for a patent on this concept, and have
1112 taken out a copyright on those words.  If you wish to use those words in
1113 conjunction with each other, you have to send $1 per usage instance to
1114 me.  Usage of the patent (@dfn{Master/Slave Relationships In Computer
1115 Applications}) will be much more expensive, of course.)
1116
1117 @findex gnus-slave
1118 Anyway, you start one Gnus up the normal way with @kbd{M-x gnus} (or
1119 however you do it).  Each subsequent slave Gnusae should be started with
1120 @kbd{M-x gnus-slave}.  These slaves won't save normal @file{.newsrc}
1121 files, but instead save @dfn{slave files} that contain information only
1122 on what groups have been read in the slave session.  When a master Gnus
1123 starts, it will read (and delete) these slave files, incorporating all
1124 information from them.  (The slave files will be read in the sequence
1125 they were created, so the latest changes will have precedence.)
1126
1127 Information from the slave files has, of course, precedence over the
1128 information in the normal (i.e., master) @file{.newsrc} file.
1129
1130 If the @file{.newsrc*} files have not been saved in the master when the
1131 slave starts, you may be prompted as to whether to read an auto-save
1132 file.  If you answer ``yes'', the unsaved changes to the master will be
1133 incorporated into the slave.  If you answer ``no'', the slave may see some
1134 messages as unread that have been read in the master.
1135
1136
1137
1138 @node New Groups
1139 @section New Groups
1140 @cindex new groups
1141 @cindex subscription
1142
1143 @vindex gnus-check-new-newsgroups
1144 If you are satisfied that you really never want to see any new groups,
1145 you can set @code{gnus-check-new-newsgroups} to @code{nil}.  This will
1146 also save you some time at startup.  Even if this variable is
1147 @code{nil}, you can always subscribe to the new groups just by pressing
1148 @kbd{U} in the group buffer (@pxref{Group Maintenance}).  This variable
1149 is @code{ask-server} by default.  If you set this variable to
1150 @code{always}, then Gnus will query the back ends for new groups even
1151 when you do the @kbd{g} command (@pxref{Scanning New Messages}).
1152
1153 @menu
1154 * Checking New Groups::         Determining what groups are new.
1155 * Subscription Methods::        What Gnus should do with new groups.
1156 * Filtering New Groups::        Making Gnus ignore certain new groups.
1157 @end menu
1158
1159
1160 @node Checking New Groups
1161 @subsection Checking New Groups
1162
1163 Gnus normally determines whether a group is new or not by comparing the
1164 list of groups from the active file(s) with the lists of subscribed and
1165 dead groups.  This isn't a particularly fast method.  If
1166 @code{gnus-check-new-newsgroups} is @code{ask-server}, Gnus will ask the
1167 server for new groups since the last time.  This is both faster and
1168 cheaper.  This also means that you can get rid of the list of killed
1169 groups altogether, so you may set @code{gnus-save-killed-list} to
1170 @code{nil}, which will save time both at startup, at exit, and all over.
1171 Saves disk space, too.  Why isn't this the default, then?
1172 Unfortunately, not all servers support this command.
1173
1174 I bet I know what you're thinking now: How do I find out whether my
1175 server supports @code{ask-server}?  No?  Good, because I don't have a
1176 fail-safe answer.  I would suggest just setting this variable to
1177 @code{ask-server} and see whether any new groups appear within the next
1178 few days.  If any do, then it works.  If none do, then it doesn't
1179 work.  I could write a function to make Gnus guess whether the server
1180 supports @code{ask-server}, but it would just be a guess.  So I won't.
1181 You could @code{telnet} to the server and say @code{HELP} and see
1182 whether it lists @samp{NEWGROUPS} among the commands it understands.  If
1183 it does, then it might work.  (But there are servers that lists
1184 @samp{NEWGROUPS} without supporting the function properly.)
1185
1186 This variable can also be a list of select methods.  If so, Gnus will
1187 issue an @code{ask-server} command to each of the select methods, and
1188 subscribe them (or not) using the normal methods.  This might be handy
1189 if you are monitoring a few servers for new groups.  A side effect is
1190 that startup will take much longer, so you can meditate while waiting.
1191 Use the mantra ``dingnusdingnusdingnus'' to achieve permanent bliss.
1192
1193
1194 @node Subscription Methods
1195 @subsection Subscription Methods
1196
1197 @vindex gnus-subscribe-newsgroup-method
1198 What Gnus does when it encounters a new group is determined by the
1199 @code{gnus-subscribe-newsgroup-method} variable.
1200
1201 This variable should contain a function.  This function will be called
1202 with the name of the new group as the only parameter.
1203
1204 Some handy pre-fab functions are:
1205
1206 @table @code
1207
1208 @item gnus-subscribe-zombies
1209 @vindex gnus-subscribe-zombies
1210 Make all new groups zombies.  This is the default.  You can browse the
1211 zombies later (with @kbd{A z}) and either kill them all off properly
1212 (with @kbd{S z}), or subscribe to them (with @kbd{u}).
1213
1214 @item gnus-subscribe-randomly
1215 @vindex gnus-subscribe-randomly
1216 Subscribe all new groups in arbitrary order.  This really means that all
1217 new groups will be added at ``the top'' of the group buffer.
1218
1219 @item gnus-subscribe-alphabetically
1220 @vindex gnus-subscribe-alphabetically
1221 Subscribe all new groups in alphabetical order.
1222
1223 @item gnus-subscribe-hierarchically
1224 @vindex gnus-subscribe-hierarchically
1225 Subscribe all new groups hierarchically.  The difference between this
1226 function and @code{gnus-subscribe-alphabetically} is slight.
1227 @code{gnus-subscribe-alphabetically} will subscribe new groups in a strictly
1228 alphabetical fashion, while this function will enter groups into its
1229 hierarchy.  So if you want to have the @samp{rec} hierarchy before the
1230 @samp{comp} hierarchy, this function will not mess that configuration
1231 up.  Or something like that.
1232
1233 @item gnus-subscribe-interactively
1234 @vindex gnus-subscribe-interactively
1235 Subscribe new groups interactively.  This means that Gnus will ask
1236 you about @strong{all} new groups.  The groups you choose to subscribe
1237 to will be subscribed hierarchically.
1238
1239 @item gnus-subscribe-killed
1240 @vindex gnus-subscribe-killed
1241 Kill all new groups.
1242
1243 @item gnus-subscribe-topics
1244 @vindex gnus-subscribe-topics
1245 Put the groups into the topic that has a matching @code{subscribe} topic
1246 parameter (@pxref{Topic Parameters}).  For instance, a @code{subscribe}
1247 topic parameter that looks like
1248
1249 @example
1250 "nnml"
1251 @end example
1252
1253 will mean that all groups that match that regex will be subscribed under
1254 that topic.
1255
1256 If no topics match the groups, the groups will be subscribed in the
1257 top-level topic.
1258
1259 @end table
1260
1261 @vindex gnus-subscribe-hierarchical-interactive
1262 A closely related variable is
1263 @code{gnus-subscribe-hierarchical-interactive}.  (That's quite a
1264 mouthful.)  If this variable is non-@code{nil}, Gnus will ask you in a
1265 hierarchical fashion whether to subscribe to new groups or not.  Gnus
1266 will ask you for each sub-hierarchy whether you want to descend the
1267 hierarchy or not.
1268
1269 One common mistake is to set the variable a few paragraphs above
1270 (@code{gnus-subscribe-newsgroup-method}) to
1271 @code{gnus-subscribe-hierarchical-interactive}.  This is an error.  This
1272 will not work.  This is ga-ga.  So don't do it.
1273
1274
1275 @node Filtering New Groups
1276 @subsection Filtering New Groups
1277
1278 A nice and portable way to control which new newsgroups should be
1279 subscribed (or ignored) is to put an @dfn{options} line at the start of
1280 the @file{.newsrc} file.  Here's an example:
1281
1282 @example
1283 options -n !alt.all !rec.all sci.all
1284 @end example
1285
1286 @vindex gnus-subscribe-options-newsgroup-method
1287 This line obviously belongs to a serious-minded intellectual scientific
1288 person (or she may just be plain old boring), because it says that all
1289 groups that have names beginning with @samp{alt} and @samp{rec} should
1290 be ignored, and all groups with names beginning with @samp{sci} should
1291 be subscribed.  Gnus will not use the normal subscription method for
1292 subscribing these groups.
1293 @code{gnus-subscribe-options-newsgroup-method} is used instead.  This
1294 variable defaults to @code{gnus-subscribe-alphabetically}.
1295
1296 @vindex gnus-options-not-subscribe
1297 @vindex gnus-options-subscribe
1298 If you don't want to mess with your @file{.newsrc} file, you can just
1299 set the two variables @code{gnus-options-subscribe} and
1300 @code{gnus-options-not-subscribe}.  These two variables do exactly the
1301 same as the @file{.newsrc} @samp{options -n} trick.  Both are regexps,
1302 and if the new group matches the former, it will be unconditionally
1303 subscribed, and if it matches the latter, it will be ignored.
1304
1305 @vindex gnus-auto-subscribed-groups
1306 Yet another variable that meddles here is
1307 @code{gnus-auto-subscribed-groups}.  It works exactly like
1308 @code{gnus-options-subscribe}, and is therefore really superfluous,
1309 but I thought it would be nice to have two of these.  This variable is
1310 more meant for setting some ground rules, while the other variable is
1311 used more for user fiddling.  By default this variable makes all new
1312 groups that come from mail back ends (@code{nnml}, @code{nnbabyl},
1313 @code{nnfolder}, @code{nnmbox}, @code{nnmh}, @code{nnimap}, and
1314 @code{nnmaildir}) subscribed.  If you don't like that, just set this
1315 variable to @code{nil}.
1316
1317 @vindex gnus-auto-subscribed-categories
1318 As if that wasn't enough, @code{gnus-auto-subscribed-categories} also
1319 allows you to specify that new groups should be subcribed based on the
1320 category their select methods belong to.  The default is @samp{(mail
1321 post-mail)}, meaning that all new groups from mail-like backends
1322 should be subscribed automatically.
1323
1324 New groups that match these variables are subscribed using
1325 @code{gnus-subscribe-options-newsgroup-method}.
1326
1327
1328 @node Changing Servers
1329 @section Changing Servers
1330 @cindex changing servers
1331
1332 Sometimes it is necessary to move from one @acronym{NNTP} server to another.
1333 This happens very rarely, but perhaps you change jobs, or one server is
1334 very flaky and you want to use another.
1335
1336 Changing the server is pretty easy, right?  You just change
1337 @code{gnus-select-method} to point to the new server?
1338
1339 @emph{Wrong!}
1340
1341 Article numbers are not (in any way) kept synchronized between different
1342 @acronym{NNTP} servers, and the only way Gnus keeps track of what articles
1343 you have read is by keeping track of article numbers.  So when you
1344 change @code{gnus-select-method}, your @file{.newsrc} file becomes
1345 worthless.
1346
1347 @kindex M-x gnus-group-clear-data-on-native-groups
1348 @findex gnus-group-clear-data-on-native-groups
1349 You can use the @kbd{M-x gnus-group-clear-data-on-native-groups}
1350 command to clear out all data that you have on your native groups.
1351 Use with caution.
1352
1353 @kindex M-x gnus-group-clear-data
1354 @findex gnus-group-clear-data
1355 Clear the data from the current group only---nix out marks and the
1356 list of read articles (@code{gnus-group-clear-data}).
1357
1358 After changing servers, you @strong{must} move the cache hierarchy away,
1359 since the cached articles will have wrong article numbers, which will
1360 affect which articles Gnus thinks are read.
1361 @code{gnus-group-clear-data-on-native-groups} will ask you if you want
1362 to have it done automatically; for @code{gnus-group-clear-data}, you
1363 can use @kbd{M-x gnus-cache-move-cache} (but beware, it will move the
1364 cache for all groups).
1365
1366
1367 @node Startup Files
1368 @section Startup Files
1369 @cindex startup files
1370 @cindex .newsrc
1371 @cindex .newsrc.el
1372 @cindex .newsrc.eld
1373
1374 Most common Unix news readers use a shared startup file called
1375 @file{.newsrc}.  This file contains all the information about what
1376 groups are subscribed, and which articles in these groups have been
1377 read.
1378
1379 Things got a bit more complicated with @sc{gnus}.  In addition to
1380 keeping the @file{.newsrc} file updated, it also used a file called
1381 @file{.newsrc.el} for storing all the information that didn't fit into
1382 the @file{.newsrc} file.  (Actually, it also duplicated everything in
1383 the @file{.newsrc} file.)  @sc{gnus} would read whichever one of these
1384 files was the most recently saved, which enabled people to swap between
1385 @sc{gnus} and other newsreaders.
1386
1387 That was kinda silly, so Gnus went one better: In addition to the
1388 @file{.newsrc} and @file{.newsrc.el} files, Gnus also has a file called
1389 @file{.newsrc.eld}.  It will read whichever of these files that are most
1390 recent, but it will never write a @file{.newsrc.el} file.  You should
1391 never delete the @file{.newsrc.eld} file---it contains much information
1392 not stored in the @file{.newsrc} file.
1393
1394 @vindex gnus-save-newsrc-file
1395 @vindex gnus-read-newsrc-file
1396 You can turn off writing the @file{.newsrc} file by setting
1397 @code{gnus-save-newsrc-file} to @code{nil}, which means you can delete
1398 the file and save some space, as well as exiting from Gnus faster.
1399 However, this will make it impossible to use other newsreaders than
1400 Gnus.  But hey, who would want to, right?  Similarly, setting
1401 @code{gnus-read-newsrc-file} to @code{nil} makes Gnus ignore the
1402 @file{.newsrc} file and any @file{.newsrc-SERVER} files, which can be
1403 convenient if you use a different news reader occasionally, and you
1404 want to read a different subset of the available groups with that
1405 news reader.
1406
1407 @vindex gnus-save-killed-list
1408 If @code{gnus-save-killed-list} (default @code{t}) is @code{nil}, Gnus
1409 will not save the list of killed groups to the startup file.  This will
1410 save both time (when starting and quitting) and space (on disk).  It
1411 will also mean that Gnus has no record of what groups are new or old,
1412 so the automatic new groups subscription methods become meaningless.
1413 You should always set @code{gnus-check-new-newsgroups} to @code{nil} or
1414 @code{ask-server} if you set this variable to @code{nil} (@pxref{New
1415 Groups}).  This variable can also be a regular expression.  If that's
1416 the case, remove all groups that do not match this regexp before
1417 saving.  This can be useful in certain obscure situations that involve
1418 several servers where not all servers support @code{ask-server}.
1419
1420 @vindex gnus-startup-file
1421 @vindex gnus-backup-startup-file
1422 @vindex version-control
1423 The @code{gnus-startup-file} variable says where the startup files are.
1424 The default value is @file{~/.newsrc}, with the Gnus (El Dingo) startup
1425 file being whatever that one is, with a @samp{.eld} appended.
1426 If you want version control for this file, set
1427 @code{gnus-backup-startup-file}.  It respects the same values as the
1428 @code{version-control} variable.
1429
1430 @vindex gnus-save-newsrc-hook
1431 @vindex gnus-save-quick-newsrc-hook
1432 @vindex gnus-save-standard-newsrc-hook
1433 @code{gnus-save-newsrc-hook} is called before saving any of the newsrc
1434 files, while @code{gnus-save-quick-newsrc-hook} is called just before
1435 saving the @file{.newsrc.eld} file, and
1436 @code{gnus-save-standard-newsrc-hook} is called just before saving the
1437 @file{.newsrc} file.  The latter two are commonly used to turn version
1438 control on or off.  Version control is on by default when saving the
1439 startup files.  If you want to turn backup creation off, say something like:
1440
1441 @lisp
1442 (defun turn-off-backup ()
1443   (set (make-local-variable 'backup-inhibited) t))
1444
1445 (add-hook 'gnus-save-quick-newsrc-hook 'turn-off-backup)
1446 (add-hook 'gnus-save-standard-newsrc-hook 'turn-off-backup)
1447 @end lisp
1448
1449 @vindex gnus-init-file
1450 @vindex gnus-site-init-file
1451 When Gnus starts, it will read the @code{gnus-site-init-file}
1452 (@file{.../site-lisp/gnus-init} by default) and @code{gnus-init-file}
1453 (@file{~/.gnus} by default) files.  These are normal Emacs Lisp files
1454 and can be used to avoid cluttering your @file{~/.emacs} and
1455 @file{site-init} files with Gnus stuff.  Gnus will also check for files
1456 with the same names as these, but with @file{.elc} and @file{.el}
1457 suffixes.  In other words, if you have set @code{gnus-init-file} to
1458 @file{~/.gnus}, it will look for @file{~/.gnus.elc}, @file{~/.gnus.el},
1459 and finally @file{~/.gnus} (in this order).  If Emacs was invoked with
1460 the @option{-q} or @option{--no-init-file} options (@pxref{Initial
1461 Options, ,Initial Options, emacs, The Emacs Manual}), Gnus doesn't read
1462 @code{gnus-init-file}.
1463
1464
1465 @node Auto Save
1466 @section Auto Save
1467 @cindex dribble file
1468 @cindex auto-save
1469
1470 Whenever you do something that changes the Gnus data (reading articles,
1471 catching up, killing/subscribing groups), the change is added to a
1472 special @dfn{dribble buffer}.  This buffer is auto-saved the normal
1473 Emacs way.  If your Emacs should crash before you have saved the
1474 @file{.newsrc} files, all changes you have made can be recovered from
1475 this file.
1476
1477 If Gnus detects this file at startup, it will ask the user whether to
1478 read it.  The auto save file is deleted whenever the real startup file is
1479 saved.
1480
1481 @vindex gnus-use-dribble-file
1482 If @code{gnus-use-dribble-file} is @code{nil}, Gnus won't create and
1483 maintain a dribble buffer.  The default is @code{t}.
1484
1485 @vindex gnus-dribble-directory
1486 Gnus will put the dribble file(s) in @code{gnus-dribble-directory}.  If
1487 this variable is @code{nil}, which it is by default, Gnus will dribble
1488 into the directory where the @file{.newsrc} file is located.  (This is
1489 normally the user's home directory.)  The dribble file will get the same
1490 file permissions as the @file{.newsrc} file.
1491
1492 @vindex gnus-always-read-dribble-file
1493 If @code{gnus-always-read-dribble-file} is non-@code{nil}, Gnus will
1494 read the dribble file on startup without querying the user.
1495
1496
1497 @node The Active File
1498 @section The Active File
1499 @cindex active file
1500 @cindex ignored groups
1501
1502 When Gnus starts, or indeed whenever it tries to determine whether new
1503 articles have arrived, it reads the active file.  This is a very large
1504 file that lists all the active groups and articles on the server.
1505
1506 @vindex gnus-ignored-newsgroups
1507 Before examining the active file, Gnus deletes all lines that match the
1508 regexp @code{gnus-ignored-newsgroups}.  This is done primarily to reject
1509 any groups with bogus names, but you can use this variable to make Gnus
1510 ignore hierarchies you aren't ever interested in.  However, this is not
1511 recommended.  In fact, it's highly discouraged.  Instead, @pxref{New
1512 Groups} for an overview of other variables that can be used instead.
1513
1514 @c This variable is
1515 @c @code{nil} by default, and will slow down active file handling somewhat
1516 @c if you set it to anything else.
1517
1518 @vindex gnus-read-active-file
1519 @c @head
1520 The active file can be rather Huge, so if you have a slow network, you
1521 can set @code{gnus-read-active-file} to @code{nil} to prevent Gnus from
1522 reading the active file.  This variable is @code{some} by default.
1523
1524 Gnus will try to make do by getting information just on the groups that
1525 you actually subscribe to.
1526
1527 Note that if you subscribe to lots and lots of groups, setting this
1528 variable to @code{nil} will probably make Gnus slower, not faster.  At
1529 present, having this variable @code{nil} will slow Gnus down
1530 considerably, unless you read news over a 2400 baud modem.
1531
1532 This variable can also have the value @code{some}.  Gnus will then
1533 attempt to read active info only on the subscribed groups.  On some
1534 servers this is quite fast (on sparkling, brand new INN servers that
1535 support the @code{LIST ACTIVE group} command), on others this isn't fast
1536 at all.  In any case, @code{some} should be faster than @code{nil}, and
1537 is certainly faster than @code{t} over slow lines.
1538
1539 Some news servers (old versions of Leafnode and old versions of INN, for
1540 instance) do not support the @code{LIST ACTIVE group}.  For these
1541 servers, @code{nil} is probably the most efficient value for this
1542 variable.
1543
1544 If this variable is @code{nil}, Gnus will ask for group info in total
1545 lock-step, which isn't very fast.  If it is @code{some} and you use an
1546 @acronym{NNTP} server, Gnus will pump out commands as fast as it can, and
1547 read all the replies in one swoop.  This will normally result in better
1548 performance, but if the server does not support the aforementioned
1549 @code{LIST ACTIVE group} command, this isn't very nice to the server.
1550
1551 If you think that starting up Gnus takes too long, try all the three
1552 different values for this variable and see what works best for you.
1553
1554 In any case, if you use @code{some} or @code{nil}, you should definitely
1555 kill all groups that you aren't interested in to speed things up.
1556
1557 Note that this variable also affects active file retrieval from
1558 secondary select methods.
1559
1560
1561 @node Startup Variables
1562 @section Startup Variables
1563
1564 @table @code
1565
1566 @item gnus-load-hook
1567 @vindex gnus-load-hook
1568 A hook run while Gnus is being loaded.  Note that this hook will
1569 normally be run just once in each Emacs session, no matter how many
1570 times you start Gnus.
1571
1572 @item gnus-before-startup-hook
1573 @vindex gnus-before-startup-hook
1574 A hook called as the first thing when Gnus is started.
1575
1576 @item gnus-startup-hook
1577 @vindex gnus-startup-hook
1578 A hook run as the very last thing after starting up Gnus
1579
1580 @item gnus-started-hook
1581 @vindex gnus-started-hook
1582 A hook that is run as the very last thing after starting up Gnus
1583 successfully.
1584
1585 @item gnus-setup-news-hook
1586 @vindex gnus-setup-news-hook
1587 A hook that is run after reading the @file{.newsrc} file(s), but before
1588 generating the group buffer.
1589
1590 @item gnus-check-bogus-newsgroups
1591 @vindex gnus-check-bogus-newsgroups
1592 If non-@code{nil}, Gnus will check for and delete all bogus groups at
1593 startup.  A @dfn{bogus group} is a group that you have in your
1594 @file{.newsrc} file, but doesn't exist on the news server.  Checking for
1595 bogus groups can take quite a while, so to save time and resources it's
1596 best to leave this option off, and do the checking for bogus groups once
1597 in a while from the group buffer instead (@pxref{Group Maintenance}).
1598
1599 @item gnus-inhibit-startup-message
1600 @vindex gnus-inhibit-startup-message
1601 If non-@code{nil}, the startup message won't be displayed.  That way,
1602 your boss might not notice as easily that you are reading news instead
1603 of doing your job.  Note that this variable is used before
1604 @file{~/.gnus.el} is loaded, so it should be set in @file{.emacs} instead.
1605
1606 @item gnus-no-groups-message
1607 @vindex gnus-no-groups-message
1608 Message displayed by Gnus when no groups are available.
1609
1610 @item gnus-use-backend-marks
1611 @vindex gnus-use-backend-marks
1612 If non-@code{nil}, Gnus will store article marks both in the
1613 @file{.newsrc.eld} file and in the backends.  This will slow down
1614 group operation some.
1615
1616 @end table
1617
1618
1619 @node Group Buffer
1620 @chapter Group Buffer
1621 @cindex group buffer
1622
1623 @c Alex Schroeder suggests to rearrange this as follows:
1624 @c
1625 @c <kensanata> ok, just save it for reference.  I'll go to bed in a minute.
1626 @c   1. Selecting a Group, 2. (new) Finding a Group, 3. Group Levels,
1627 @c   4. Subscription Commands, 5. Group Maneuvering, 6. Group Data,
1628 @c   7. Group Score, 8. Group Buffer Format
1629 @c <kensanata> Group Levels should have more information on levels 5 to 9.  I
1630 @c   suggest to split the 4th paragraph ("Gnus considers groups...") as follows:
1631 @c <kensanata> First, "Gnus considers groups... (default 9)."
1632 @c <kensanata> New, a table summarizing what levels 1 to 9 mean.
1633 @c <kensanata> Third, "Gnus treats subscribed ... reasons of efficiency"
1634 @c <kensanata> Then expand the next paragraph or add some more to it.
1635 @c    This short one sentence explains levels 1 and 2, therefore I understand
1636 @c    that I should keep important news at 3 and boring news at 4.
1637 @c    Say so!  Then go on to explain why I should bother with levels 6 to 9.
1638 @c    Maybe keep those that you don't want to read temporarily at 6,
1639 @c    those that you never want to read at 8, those that offend your
1640 @c    human rights at 9...
1641
1642
1643 The @dfn{group buffer} lists all (or parts) of the available groups.  It
1644 is the first buffer shown when Gnus starts, and will never be killed as
1645 long as Gnus is active.
1646
1647 @iftex
1648 @iflatex
1649 \gnusfigure{The Group Buffer}{320}{
1650 \put(75,50){\epsfig{figure=ps/group,height=9cm}}
1651 \put(120,37){\makebox(0,0)[t]{Buffer name}}
1652 \put(120,38){\vector(1,2){10}}
1653 \put(40,60){\makebox(0,0)[r]{Mode line}}
1654 \put(40,58){\vector(1,0){30}}
1655 \put(200,28){\makebox(0,0)[t]{Native select method}}
1656 \put(200,26){\vector(-1,2){15}}
1657 }
1658 @end iflatex
1659 @end iftex
1660
1661 @menu
1662 * Group Buffer Format::         Information listed and how you can change it.
1663 * Group Maneuvering::           Commands for moving in the group buffer.
1664 * Selecting a Group::           Actually reading news.
1665 * Subscription Commands::       Unsubscribing, killing, subscribing.
1666 * Group Data::                  Changing the info for a group.
1667 * Group Levels::                Levels? What are those, then?
1668 * Group Score::                 A mechanism for finding out what groups you like.
1669 * Marking Groups::              You can mark groups for later processing.
1670 * Foreign Groups::              Creating and editing groups.
1671 * Group Parameters::            Each group may have different parameters set.
1672 * Listing Groups::              Gnus can list various subsets of the groups.
1673 * Sorting Groups::              Re-arrange the group order.
1674 * Group Maintenance::           Maintaining a tidy @file{.newsrc} file.
1675 * Browse Foreign Server::       You can browse a server.  See what it has to offer.
1676 * Exiting Gnus::                Stop reading news and get some work done.
1677 * Group Topics::                A folding group mode divided into topics.
1678 * Non-ASCII Group Names::       Accessing groups of non-English names.
1679 * Misc Group Stuff::            Other stuff that you can to do.
1680 @end menu
1681
1682
1683 @node Group Buffer Format
1684 @section Group Buffer Format
1685
1686 @menu
1687 * Group Line Specification::    Deciding how the group buffer is to look.
1688 * Group Mode Line Specification::  The group buffer mode line.
1689 * Group Highlighting::          Having nice colors in the group buffer.
1690 @end menu
1691
1692 You can customize the Group Mode tool bar, see @kbd{M-x
1693 customize-apropos RET gnus-group-tool-bar}.  This feature is only
1694 available in Emacs.
1695
1696 The tool bar icons are now (de)activated correctly depending on the
1697 cursor position.  Therefore, moving around in the Group Buffer is
1698 slower.  You can disable this via the variable
1699 @code{gnus-group-update-tool-bar}.  Its default value depends on your
1700 Emacs version.
1701
1702 @node Group Line Specification
1703 @subsection Group Line Specification
1704 @cindex group buffer format
1705
1706 The default format of the group buffer is nice and dull, but you can
1707 make it as exciting and ugly as you feel like.
1708
1709 Here's a couple of example group lines:
1710
1711 @example
1712      25: news.announce.newusers
1713  *    0: alt.fan.andrea-dworkin
1714 @end example
1715
1716 Quite simple, huh?
1717
1718 You can see that there are 25 unread articles in
1719 @samp{news.announce.newusers}.  There are no unread articles, but some
1720 ticked articles, in @samp{alt.fan.andrea-dworkin} (see that little
1721 asterisk at the beginning of the line?).
1722
1723 @vindex gnus-group-line-format
1724 You can change that format to whatever you want by fiddling with the
1725 @code{gnus-group-line-format} variable.  This variable works along the
1726 lines of a @code{format} specification, which is pretty much the same as
1727 a @code{printf} specifications, for those of you who use (feh!) C.
1728 @xref{Formatting Variables}.
1729
1730 @samp{%M%S%5y:%B%(%g%)\n} is the value that produced those lines above.
1731
1732 There should always be a colon on the line; the cursor always moves to
1733 the colon after performing an operation.  @xref{Positioning
1734 Point}.  Nothing else is required---not even the group name.  All
1735 displayed text is just window dressing, and is never examined by Gnus.
1736 Gnus stores all real information it needs using text properties.
1737
1738 (Note that if you make a really strange, wonderful, spreadsheet-like
1739 layout, everybody will believe you are hard at work with the accounting
1740 instead of wasting time reading news.)
1741
1742 Here's a list of all available format characters:
1743
1744 @table @samp
1745
1746 @item M
1747 An asterisk if the group only has marked articles.
1748
1749 @item S
1750 Whether the group is subscribed.
1751
1752 @item L
1753 Level of subscribedness.
1754
1755 @item N
1756 Number of unread articles.
1757
1758 @item I
1759 Number of dormant articles.
1760
1761 @item T
1762 Number of ticked articles.
1763
1764 @item R
1765 Number of read articles.
1766
1767 @item U
1768 Number of unseen articles.
1769
1770 @item t
1771 Estimated total number of articles.  (This is really @var{max-number}
1772 minus @var{min-number} plus 1.)
1773
1774 Gnus uses this estimation because the @acronym{NNTP} protocol provides
1775 efficient access to @var{max-number} and @var{min-number} but getting
1776 the true unread message count is not possible efficiently.  For
1777 hysterical raisins, even the mail back ends, where the true number of
1778 unread messages might be available efficiently, use the same limited
1779 interface.  To remove this restriction from Gnus means that the back
1780 end interface has to be changed, which is not an easy job.
1781
1782 The nnml backend (@pxref{Mail Spool}) has a feature called ``group
1783 compaction'' which circumvents this deficiency: the idea is to
1784 renumber all articles from 1, removing all gaps between numbers, hence
1785 getting a correct total count.  Other backends may support this in the
1786 future.  In order to keep your total article count relatively up to
1787 date, you might want to compact your groups (or even directly your
1788 server) from time to time. @xref{Misc Group Stuff}, @xref{Server Commands}.
1789
1790 @item y
1791 Number of unread, unticked, non-dormant articles.
1792
1793 @item i
1794 Number of ticked and dormant articles.
1795
1796 @item g
1797 Full group name.
1798
1799 @item G
1800 Group name.
1801
1802 @item C
1803 Group comment (@pxref{Group Parameters}) or group name if there is no
1804 comment element in the group parameters.
1805
1806 @item D
1807 Newsgroup description.  You need to read the group descriptions
1808 before these will appear, and to do that, you either have to set
1809 @code{gnus-read-active-file} or use the group buffer @kbd{M-d}
1810 command.
1811
1812 @item o
1813 @samp{m} if moderated.
1814
1815 @item O
1816 @samp{(m)} if moderated.
1817
1818 @item s
1819 Select method.
1820
1821 @item B
1822 If the summary buffer for the group is open or not.
1823
1824 @item n
1825 Select from where.
1826
1827 @item z
1828 A string that looks like @samp{<%s:%n>} if a foreign select method is
1829 used.
1830
1831 @item P
1832 Indentation based on the level of the topic (@pxref{Group Topics}).
1833
1834 @item c
1835 @vindex gnus-group-uncollapsed-levels
1836 Short (collapsed) group name.  The @code{gnus-group-uncollapsed-levels}
1837 variable says how many levels to leave at the end of the group name.
1838 The default is 1---this will mean that group names like
1839 @samp{gnu.emacs.gnus} will be shortened to @samp{g.e.gnus}.
1840
1841 @item m
1842 @vindex gnus-new-mail-mark
1843 @cindex %
1844 @samp{%} (@code{gnus-new-mail-mark}) if there has arrived new mail to
1845 the group lately.
1846
1847 @item p
1848 @samp{#} (@code{gnus-process-mark}) if the group is process marked.
1849
1850 @item d
1851 A string that says when you last read the group (@pxref{Group
1852 Timestamp}).
1853
1854 @item F
1855 The disk space used by the articles fetched by both the cache and
1856 agent.  The value is automatically scaled to bytes(B), kilobytes(K),
1857 megabytes(M), or gigabytes(G) to minimize the column width.  A format
1858 of %7F is sufficient for a fixed-width column.
1859
1860 @item u
1861 User defined specifier.  The next character in the format string should
1862 be a letter.  Gnus will call the function
1863 @code{gnus-user-format-function-}@samp{X}, where @samp{X} is the letter
1864 following @samp{%u}.  The function will be passed a single dummy
1865 parameter as argument.  The function should return a string, which will
1866 be inserted into the buffer just like information from any other
1867 specifier.
1868 @end table
1869
1870 @cindex *
1871 All the ``number-of'' specs will be filled with an asterisk (@samp{*})
1872 if no info is available---for instance, if it is a non-activated foreign
1873 group, or a bogus native group.
1874
1875
1876 @node Group Mode Line Specification
1877 @subsection Group Mode Line Specification
1878 @cindex group mode line
1879
1880 @vindex gnus-group-mode-line-format
1881 The mode line can be changed by setting
1882 @code{gnus-group-mode-line-format} (@pxref{Mode Line Formatting}).  It
1883 doesn't understand that many format specifiers:
1884
1885 @table @samp
1886 @item S
1887 The native news server.
1888 @item M
1889 The native select method.
1890 @end table
1891
1892
1893 @node Group Highlighting
1894 @subsection Group Highlighting
1895 @cindex highlighting
1896 @cindex group highlighting
1897
1898 @vindex gnus-group-highlight
1899 Highlighting in the group buffer is controlled by the
1900 @code{gnus-group-highlight} variable.  This is an alist with elements
1901 that look like @code{(@var{form} . @var{face})}.  If @var{form} evaluates to
1902 something non-@code{nil}, the @var{face} will be used on the line.
1903
1904 Here's an example value for this variable that might look nice if the
1905 background is dark:
1906
1907 @lisp
1908 (cond (window-system
1909        (setq custom-background-mode 'light)
1910        (defface my-group-face-1
1911          '((t (:foreground "Red" :bold t))) "First group face")
1912        (defface my-group-face-2
1913          '((t (:foreground "DarkSeaGreen4" :bold t)))
1914          "Second group face")
1915        (defface my-group-face-3
1916          '((t (:foreground "Green4" :bold t))) "Third group face")
1917        (defface my-group-face-4
1918          '((t (:foreground "SteelBlue" :bold t))) "Fourth group face")
1919        (defface my-group-face-5
1920          '((t (:foreground "Blue" :bold t))) "Fifth group face")))
1921
1922 (setq gnus-group-highlight
1923       '(((> unread 200) . my-group-face-1)
1924         ((and (< level 3) (zerop unread)) . my-group-face-2)
1925         ((< level 3) . my-group-face-3)
1926         ((zerop unread) . my-group-face-4)
1927         (t . my-group-face-5)))
1928 @end lisp
1929
1930 Also @pxref{Faces and Fonts}.
1931
1932 Variables that are dynamically bound when the forms are evaluated
1933 include:
1934
1935 @table @code
1936 @item group
1937 The group name.
1938 @item unread
1939 The number of unread articles in the group.
1940 @item method
1941 The select method.
1942 @item mailp
1943 Whether the group is a mail group.
1944 @item level
1945 The level of the group.
1946 @item score
1947 The score of the group.
1948 @item ticked
1949 The number of ticked articles in the group.
1950 @item total
1951 The total number of articles in the group.  Or rather,
1952 @var{max-number} minus @var{min-number} plus one.
1953 @item topic
1954 When using the topic minor mode, this variable is bound to the current
1955 topic being inserted.
1956 @end table
1957
1958 When the forms are @code{eval}ed, point is at the beginning of the line
1959 of the group in question, so you can use many of the normal Gnus
1960 functions for snarfing info on the group.
1961
1962 @vindex gnus-group-update-hook
1963 @findex gnus-group-highlight-line
1964 @code{gnus-group-update-hook} is called when a group line is changed.
1965 It will not be called when @code{gnus-visual} is @code{nil}.
1966
1967
1968 @node Group Maneuvering
1969 @section Group Maneuvering
1970 @cindex group movement
1971
1972 All movement commands understand the numeric prefix and will behave as
1973 expected, hopefully.
1974
1975 @table @kbd
1976
1977 @item n
1978 @kindex n (Group)
1979 @findex gnus-group-next-unread-group
1980 Go to the next group that has unread articles
1981 (@code{gnus-group-next-unread-group}).
1982
1983 @item p
1984 @itemx DEL
1985 @kindex DEL (Group)
1986 @kindex p (Group)
1987 @findex gnus-group-prev-unread-group
1988 Go to the previous group that has unread articles
1989 (@code{gnus-group-prev-unread-group}).
1990
1991 @item N
1992 @kindex N (Group)
1993 @findex gnus-group-next-group
1994 Go to the next group (@code{gnus-group-next-group}).
1995
1996 @item P
1997 @kindex P (Group)
1998 @findex gnus-group-prev-group
1999 Go to the previous group (@code{gnus-group-prev-group}).
2000
2001 @item M-n
2002 @kindex M-n (Group)
2003 @findex gnus-group-next-unread-group-same-level
2004 Go to the next unread group on the same (or lower) level
2005 (@code{gnus-group-next-unread-group-same-level}).
2006
2007 @item M-p
2008 @kindex M-p (Group)
2009 @findex gnus-group-prev-unread-group-same-level
2010 Go to the previous unread group on the same (or lower) level
2011 (@code{gnus-group-prev-unread-group-same-level}).
2012 @end table
2013
2014 Three commands for jumping to groups:
2015
2016 @table @kbd
2017
2018 @item j
2019 @kindex j (Group)
2020 @findex gnus-group-jump-to-group
2021 Jump to a group (and make it visible if it isn't already)
2022 (@code{gnus-group-jump-to-group}).  Killed groups can be jumped to, just
2023 like living groups.
2024
2025 @item ,
2026 @kindex , (Group)
2027 @findex gnus-group-best-unread-group
2028 Jump to the unread group with the lowest level
2029 (@code{gnus-group-best-unread-group}).
2030
2031 @item .
2032 @kindex . (Group)
2033 @findex gnus-group-first-unread-group
2034 Jump to the first group with unread articles
2035 (@code{gnus-group-first-unread-group}).
2036 @end table
2037
2038 @vindex gnus-group-goto-unread
2039 If @code{gnus-group-goto-unread} is @code{nil}, all the movement
2040 commands will move to the next group, not the next unread group.  Even
2041 the commands that say they move to the next unread group.  The default
2042 is @code{t}.
2043
2044 @vindex gnus-summary-next-group-on-exit
2045 If @code{gnus-summary-next-group-on-exit} is @code{t}, when a summary is
2046 exited, the point in the group buffer is moved to the next unread group.
2047 Otherwise, the point is set to the group just exited.  The default is
2048 @code{t}.
2049
2050 @node Selecting a Group
2051 @section Selecting a Group
2052 @cindex group selection
2053
2054 @table @kbd
2055
2056 @item SPACE
2057 @kindex SPACE (Group)
2058 @findex gnus-group-read-group
2059 Select the current group, switch to the summary buffer and display the
2060 first unread article (@code{gnus-group-read-group}).  If there are no
2061 unread articles in the group, or if you give a non-numerical prefix to
2062 this command, Gnus will offer to fetch all the old articles in this
2063 group from the server.  If you give a numerical prefix @var{n}, @var{n}
2064 determines the number of articles Gnus will fetch.  If @var{n} is
2065 positive, Gnus fetches the @var{n} newest articles, if @var{n} is
2066 negative, Gnus fetches the @code{abs(@var{n})} oldest articles.
2067
2068 Thus, @kbd{SPC} enters the group normally, @kbd{C-u SPC} offers old
2069 articles, @kbd{C-u 4 2 SPC} fetches the 42 newest articles, and @kbd{C-u
2070 - 4 2 SPC} fetches the 42 oldest ones.
2071
2072 When you are in the group (in the Summary buffer), you can type
2073 @kbd{M-g} to fetch new articles, or @kbd{C-u M-g} to also show the old
2074 ones.
2075
2076 @item RET
2077 @kindex RET (Group)
2078 @findex gnus-group-select-group
2079 Select the current group and switch to the summary buffer
2080 (@code{gnus-group-select-group}).  Takes the same arguments as
2081 @code{gnus-group-read-group}---the only difference is that this command
2082 does not display the first unread article automatically upon group
2083 entry.
2084
2085 @item M-RET
2086 @kindex M-RET (Group)
2087 @findex gnus-group-quick-select-group
2088 This does the same as the command above, but tries to do it with the
2089 minimum amount of fuzz (@code{gnus-group-quick-select-group}).  No
2090 scoring/killing will be performed, there will be no highlights and no
2091 expunging.  This might be useful if you're in a real hurry and have to
2092 enter some humongous group.  If you give a 0 prefix to this command
2093 (i.e., @kbd{0 M-RET}), Gnus won't even generate the summary buffer,
2094 which is useful if you want to toggle threading before generating the
2095 summary buffer (@pxref{Summary Generation Commands}).
2096
2097 @item M-SPACE
2098 @kindex M-SPACE (Group)
2099 @findex gnus-group-visible-select-group
2100 This is yet one more command that does the same as the @kbd{RET}
2101 command, but this one does it without expunging and hiding dormants
2102 (@code{gnus-group-visible-select-group}).
2103
2104 @item C-M-RET
2105 @kindex C-M-RET (Group)
2106 @findex gnus-group-select-group-ephemerally
2107 Finally, this command selects the current group ephemerally without
2108 doing any processing of its contents
2109 (@code{gnus-group-select-group-ephemerally}).  Even threading has been
2110 turned off.  Everything you do in the group after selecting it in this
2111 manner will have no permanent effects.
2112
2113 @end table
2114
2115 @vindex gnus-large-newsgroup
2116 The @code{gnus-large-newsgroup} variable says what Gnus should
2117 consider to be a big group.  If it is @code{nil}, no groups are
2118 considered big.  The default value is 200.  If the group has more
2119 (unread and/or ticked) articles than this, Gnus will query the user
2120 before entering the group.  The user can then specify how many
2121 articles should be fetched from the server.  If the user specifies a
2122 negative number (@var{-n}), the @var{n} oldest articles will be
2123 fetched.  If it is positive, the @var{n} articles that have arrived
2124 most recently will be fetched.
2125
2126 @vindex gnus-large-ephemeral-newsgroup
2127 @code{gnus-large-ephemeral-newsgroup} is the same as
2128 @code{gnus-large-newsgroup}, but is only used for ephemeral
2129 newsgroups.
2130
2131 @vindex gnus-newsgroup-maximum-articles
2132 In groups in some news servers, there might be a big gap between a few
2133 very old articles that will never be expired and the recent ones.  In
2134 such a case, the server will return the data like @code{(1 . 30000000)}
2135 for the @code{LIST ACTIVE group} command, for example.  Even if there
2136 are actually only the articles 1-10 and 29999900-30000000, Gnus doesn't
2137 know it at first and prepares for getting 30000000 articles.  However,
2138 it will consume hundreds megabytes of memories and might make Emacs get
2139 stuck as the case may be.  If you use such news servers, set the
2140 variable @code{gnus-newsgroup-maximum-articles} to a positive number.
2141 The value means that Gnus ignores articles other than this number of the
2142 latest ones in every group.  For instance, the value 10000 makes Gnus
2143 get only the articles 29990001-30000000 (if the latest article number is
2144 30000000 in a group).  Note that setting this variable to a number might
2145 prevent you from reading very old articles.  The default value of the
2146 variable @code{gnus-newsgroup-maximum-articles} is @code{nil}, which
2147 means Gnus never ignores old articles.
2148
2149 @vindex gnus-select-group-hook
2150 @vindex gnus-auto-select-first
2151 @vindex gnus-auto-select-subject
2152 If @code{gnus-auto-select-first} is non-@code{nil}, select an article
2153 automatically when entering a group with the @kbd{SPACE} command.
2154 Which article this is controlled by the
2155 @code{gnus-auto-select-subject} variable.  Valid values for this
2156 variable are:
2157
2158 @table @code
2159
2160 @item unread
2161 Place point on the subject line of the first unread article.
2162
2163 @item first
2164 Place point on the subject line of the first article.
2165
2166 @item unseen
2167 Place point on the subject line of the first unseen article.
2168
2169 @item unseen-or-unread
2170 Place point on the subject line of the first unseen article, and if
2171 there is no such article, place point on the subject line of the first
2172 unread article.
2173
2174 @item best
2175 Place point on the subject line of the highest-scored unread article.
2176
2177 @end table
2178
2179 This variable can also be a function.  In that case, that function
2180 will be called to place point on a subject line.
2181
2182 If you want to prevent automatic selection in some group (say, in a
2183 binary group with Huge articles) you can set the
2184 @code{gnus-auto-select-first} variable to @code{nil} in
2185 @code{gnus-select-group-hook}, which is called when a group is
2186 selected.
2187
2188
2189 @node Subscription Commands
2190 @section Subscription Commands
2191 @cindex subscription
2192
2193 The following commands allow for managing your subscriptions in the
2194 Group buffer.  If you want to subscribe to many groups, it's probably
2195 more convenient to go to the @ref{Server Buffer}, and choose the
2196 server there using @kbd{RET} or @kbd{SPC}.  Then you'll have the
2197 commands listed in @ref{Browse Foreign Server} at hand.
2198
2199 @table @kbd
2200
2201 @item S t
2202 @itemx u
2203 @kindex S t (Group)
2204 @kindex u (Group)
2205 @findex gnus-group-unsubscribe-current-group
2206 @c @icon{gnus-group-unsubscribe}
2207 Toggle subscription to the current group
2208 (@code{gnus-group-unsubscribe-current-group}).
2209
2210 @item S s
2211 @itemx U
2212 @kindex S s (Group)
2213 @kindex U (Group)
2214 @findex gnus-group-unsubscribe-group
2215 Prompt for a group to subscribe, and then subscribe it.  If it was
2216 subscribed already, unsubscribe it instead
2217 (@code{gnus-group-unsubscribe-group}).
2218
2219 @item S k
2220 @itemx C-k
2221 @kindex S k (Group)
2222 @kindex C-k (Group)
2223 @findex gnus-group-kill-group
2224 @c @icon{gnus-group-kill-group}
2225 Kill the current group (@code{gnus-group-kill-group}).
2226
2227 @item S y
2228 @itemx C-y
2229 @kindex S y (Group)
2230 @kindex C-y (Group)
2231 @findex gnus-group-yank-group
2232 Yank the last killed group (@code{gnus-group-yank-group}).
2233
2234 @item C-x C-t
2235 @kindex C-x C-t (Group)
2236 @findex gnus-group-transpose-groups
2237 Transpose two groups (@code{gnus-group-transpose-groups}).  This isn't
2238 really a subscription command, but you can use it instead of a
2239 kill-and-yank sequence sometimes.
2240
2241 @item S w
2242 @itemx C-w
2243 @kindex S w (Group)
2244 @kindex C-w (Group)
2245 @findex gnus-group-kill-region
2246 Kill all groups in the region (@code{gnus-group-kill-region}).
2247
2248 @item S z
2249 @kindex S z (Group)
2250 @findex gnus-group-kill-all-zombies
2251 Kill all zombie groups (@code{gnus-group-kill-all-zombies}).
2252
2253 @item S C-k
2254 @kindex S C-k (Group)
2255 @findex gnus-group-kill-level
2256 Kill all groups on a certain level (@code{gnus-group-kill-level}).
2257 These groups can't be yanked back after killing, so this command should
2258 be used with some caution.  The only time where this command comes in
2259 really handy is when you have a @file{.newsrc} with lots of unsubscribed
2260 groups that you want to get rid off.  @kbd{S C-k} on level 7 will
2261 kill off all unsubscribed groups that do not have message numbers in the
2262 @file{.newsrc} file.
2263
2264 @end table
2265
2266 Also @pxref{Group Levels}.
2267
2268
2269 @node Group Data
2270 @section Group Data
2271
2272 @table @kbd
2273
2274 @item c
2275 @kindex c (Group)
2276 @findex gnus-group-catchup-current
2277 @vindex gnus-group-catchup-group-hook
2278 @c @icon{gnus-group-catchup-current}
2279 Mark all unticked articles in this group as read
2280 (@code{gnus-group-catchup-current}).
2281 @code{gnus-group-catchup-group-hook} is called when catching up a group from
2282 the group buffer.
2283
2284 @item C
2285 @kindex C (Group)
2286 @findex gnus-group-catchup-current-all
2287 Mark all articles in this group, even the ticked ones, as read
2288 (@code{gnus-group-catchup-current-all}).
2289
2290 @item M-c
2291 @kindex M-c (Group)
2292 @findex gnus-group-clear-data
2293 Clear the data from the current group---nix out marks and the list of
2294 read articles (@code{gnus-group-clear-data}).
2295
2296 @item M-x gnus-group-clear-data-on-native-groups
2297 @kindex M-x gnus-group-clear-data-on-native-groups
2298 @findex gnus-group-clear-data-on-native-groups
2299 If you have switched from one @acronym{NNTP} server to another, all your marks
2300 and read ranges have become worthless.  You can use this command to
2301 clear out all data that you have on your native groups.  Use with
2302 caution.
2303
2304 @end table
2305
2306
2307 @node Group Levels
2308 @section Group Levels
2309 @cindex group level
2310 @cindex level
2311
2312 All groups have a level of @dfn{subscribedness}.  For instance, if a
2313 group is on level 2, it is more subscribed than a group on level 5.  You
2314 can ask Gnus to just list groups on a given level or lower
2315 (@pxref{Listing Groups}), or to just check for new articles in groups on
2316 a given level or lower (@pxref{Scanning New Messages}).
2317
2318 Remember:  The higher the level of the group, the less important it is.
2319
2320 @table @kbd
2321
2322 @item S l
2323 @kindex S l (Group)
2324 @findex gnus-group-set-current-level
2325 Set the level of the current group.  If a numeric prefix is given, the
2326 next @var{n} groups will have their levels set.  The user will be
2327 prompted for a level.
2328 @end table
2329
2330 @vindex gnus-level-killed
2331 @vindex gnus-level-zombie
2332 @vindex gnus-level-unsubscribed
2333 @vindex gnus-level-subscribed
2334 Gnus considers groups from levels 1 to
2335 @code{gnus-level-subscribed} (inclusive) (default 5) to be subscribed,
2336 @code{gnus-level-subscribed} (exclusive) and
2337 @code{gnus-level-unsubscribed} (inclusive) (default 7) to be
2338 unsubscribed, @code{gnus-level-zombie} to be zombies (walking dead)
2339 (default 8) and @code{gnus-level-killed} to be killed (completely dead)
2340 (default 9).  Gnus treats subscribed and unsubscribed groups exactly the
2341 same, but zombie and killed groups have no information on what articles
2342 you have read, etc, stored.  This distinction between dead and living
2343 groups isn't done because it is nice or clever, it is done purely for
2344 reasons of efficiency.
2345
2346 It is recommended that you keep all your mail groups (if any) on quite
2347 low levels (e.g. 1 or 2).
2348
2349 Maybe the following description of the default behavior of Gnus helps to
2350 understand what these levels are all about.  By default, Gnus shows you
2351 subscribed nonempty groups, but by hitting @kbd{L} you can have it show
2352 empty subscribed groups and unsubscribed groups, too.  Type @kbd{l} to
2353 go back to showing nonempty subscribed groups again.  Thus, unsubscribed
2354 groups are hidden, in a way.
2355
2356 Zombie and killed groups are similar to unsubscribed groups in that they
2357 are hidden by default.  But they are different from subscribed and
2358 unsubscribed groups in that Gnus doesn't ask the news server for
2359 information (number of messages, number of unread messages) on zombie
2360 and killed groups.  Normally, you use @kbd{C-k} to kill the groups you
2361 aren't interested in.  If most groups are killed, Gnus is faster.
2362
2363 Why does Gnus distinguish between zombie and killed groups?  Well, when
2364 a new group arrives on the server, Gnus by default makes it a zombie
2365 group.  This means that you are normally not bothered with new groups,
2366 but you can type @kbd{A z} to get a list of all new groups.  Subscribe
2367 the ones you like and kill the ones you don't want.  (@kbd{A k} shows a
2368 list of killed groups.)
2369
2370 If you want to play with the level variables, you should show some care.
2371 Set them once, and don't touch them ever again.  Better yet, don't touch
2372 them at all unless you know exactly what you're doing.
2373
2374 @vindex gnus-level-default-unsubscribed
2375 @vindex gnus-level-default-subscribed
2376 Two closely related variables are @code{gnus-level-default-subscribed}
2377 (default 3) and @code{gnus-level-default-unsubscribed} (default 6),
2378 which are the levels that new groups will be put on if they are
2379 (un)subscribed.  These two variables should, of course, be inside the
2380 relevant valid ranges.
2381
2382 @vindex gnus-keep-same-level
2383 If @code{gnus-keep-same-level} is non-@code{nil}, some movement commands
2384 will only move to groups of the same level (or lower).  In
2385 particular, going from the last article in one group to the next group
2386 will go to the next group of the same level (or lower).  This might be
2387 handy if you want to read the most important groups before you read the
2388 rest.
2389
2390 If this variable is @code{best}, Gnus will make the next newsgroup the
2391 one with the best level.
2392
2393 @vindex gnus-group-default-list-level
2394 All groups with a level less than or equal to
2395 @code{gnus-group-default-list-level} will be listed in the group buffer
2396 by default.
2397 This variable can also be a function.  In that case, that function will
2398 be called and the result will be used as value.
2399
2400
2401 @vindex gnus-group-list-inactive-groups
2402 If @code{gnus-group-list-inactive-groups} is non-@code{nil}, non-active
2403 groups will be listed along with the unread groups.  This variable is
2404 @code{t} by default.  If it is @code{nil}, inactive groups won't be
2405 listed.
2406
2407 @vindex gnus-group-use-permanent-levels
2408 If @code{gnus-group-use-permanent-levels} is non-@code{nil}, once you
2409 give a level prefix to @kbd{g} or @kbd{l}, all subsequent commands will
2410 use this level as the ``work'' level.
2411
2412 @vindex gnus-activate-level
2413 Gnus will normally just activate (i. e., query the server about) groups
2414 on level @code{gnus-activate-level} or less.  If you don't want to
2415 activate unsubscribed groups, for instance, you might set this variable
2416 to 5.  The default is 6.
2417
2418
2419 @node Group Score
2420 @section Group Score
2421 @cindex group score
2422 @cindex group rank
2423 @cindex rank
2424
2425 You would normally keep important groups on high levels, but that scheme
2426 is somewhat restrictive.  Don't you wish you could have Gnus sort the
2427 group buffer according to how often you read groups, perhaps?  Within
2428 reason?
2429
2430 This is what @dfn{group score} is for.  You can have Gnus assign a score
2431 to each group through the mechanism described below.  You can then sort
2432 the group buffer based on this score.  Alternatively, you can sort on
2433 score and then level.  (Taken together, the level and the score is
2434 called the @dfn{rank} of the group.  A group that is on level 4 and has
2435 a score of 1 has a higher rank than a group on level 5 that has a score
2436 of 300.  (The level is the most significant part and the score is the
2437 least significant part.))
2438
2439 @findex gnus-summary-bubble-group
2440 If you want groups you read often to get higher scores than groups you
2441 read seldom you can add the @code{gnus-summary-bubble-group} function to
2442 the @code{gnus-summary-exit-hook} hook.  This will result (after
2443 sorting) in a bubbling sort of action.  If you want to see that in
2444 action after each summary exit, you can add
2445 @code{gnus-group-sort-groups-by-rank} or
2446 @code{gnus-group-sort-groups-by-score} to the same hook, but that will
2447 slow things down somewhat.
2448
2449
2450 @node Marking Groups
2451 @section Marking Groups
2452 @cindex marking groups
2453
2454 If you want to perform some command on several groups, and they appear
2455 subsequently in the group buffer, you would normally just give a
2456 numerical prefix to the command.  Most group commands will then do your
2457 bidding on those groups.
2458
2459 However, if the groups are not in sequential order, you can still
2460 perform a command on several groups.  You simply mark the groups first
2461 with the process mark and then execute the command.
2462
2463 @table @kbd
2464
2465 @item #
2466 @kindex # (Group)
2467 @itemx M m
2468 @kindex M m (Group)
2469 @findex gnus-group-mark-group
2470 Set the mark on the current group (@code{gnus-group-mark-group}).
2471
2472 @item M-#
2473 @kindex M-# (Group)
2474 @itemx M u
2475 @kindex M u (Group)
2476 @findex gnus-group-unmark-group
2477 Remove the mark from the current group
2478 (@code{gnus-group-unmark-group}).
2479
2480 @item M U
2481 @kindex M U (Group)
2482 @findex gnus-group-unmark-all-groups
2483 Remove the mark from all groups (@code{gnus-group-unmark-all-groups}).
2484
2485 @item M w
2486 @kindex M w (Group)
2487 @findex gnus-group-mark-region
2488 Mark all groups between point and mark (@code{gnus-group-mark-region}).
2489
2490 @item M b
2491 @kindex M b (Group)
2492 @findex gnus-group-mark-buffer
2493 Mark all groups in the buffer (@code{gnus-group-mark-buffer}).
2494
2495 @item M r
2496 @kindex M r (Group)
2497 @findex gnus-group-mark-regexp
2498 Mark all groups that match some regular expression
2499 (@code{gnus-group-mark-regexp}).
2500 @end table
2501
2502 Also @pxref{Process/Prefix}.
2503
2504 @findex gnus-group-universal-argument
2505 If you want to execute some command on all groups that have been marked
2506 with the process mark, you can use the @kbd{M-&}
2507 (@code{gnus-group-universal-argument}) command.  It will prompt you for
2508 the command to be executed.
2509
2510
2511 @node Foreign Groups
2512 @section Foreign Groups
2513 @cindex foreign groups
2514
2515 If you recall how to subscribe to servers (@pxref{Finding the News})
2516 you will remember that @code{gnus-secondary-select-methods} and
2517 @code{gnus-select-method} let you write a definition in Emacs Lisp of
2518 what servers you want to see when you start up.  The alternate
2519 approach is to use foreign servers and groups.  ``Foreign'' here means
2520 they are not coming from the select methods.  All foreign server
2521 configuration and subscriptions are stored only in the
2522 @file{~/.newsrc.eld} file.
2523
2524 Below are some group mode commands for making and editing general foreign
2525 groups, as well as commands to ease the creation of a few
2526 special-purpose groups.  All these commands insert the newly created
2527 groups under point---@code{gnus-subscribe-newsgroup-method} is not
2528 consulted.
2529
2530 Changes from the group editing commands are stored in
2531 @file{~/.newsrc.eld} (@code{gnus-startup-file}).  An alternative is the
2532 variable @code{gnus-parameters}, @xref{Group Parameters}.
2533
2534 @table @kbd
2535
2536 @item G m
2537 @kindex G m (Group)
2538 @findex gnus-group-make-group
2539 @cindex making groups
2540 Make a new group (@code{gnus-group-make-group}).  Gnus will prompt you
2541 for a name, a method and possibly an @dfn{address}.  For an easier way
2542 to subscribe to @acronym{NNTP} groups (@pxref{Browse Foreign Server}).
2543
2544 @item G M
2545 @kindex G M (Group)
2546 @findex gnus-group-read-ephemeral-group
2547 Make an ephemeral group (@code{gnus-group-read-ephemeral-group}).  Gnus
2548 will prompt you for a name, a method and an @dfn{address}.
2549
2550 @item G r
2551 @kindex G r (Group)
2552 @findex gnus-group-rename-group
2553 @cindex renaming groups
2554 Rename the current group to something else
2555 (@code{gnus-group-rename-group}).  This is valid only on some
2556 groups---mail groups mostly.  This command might very well be quite slow
2557 on some back ends.
2558
2559 @item G c
2560 @kindex G c (Group)
2561 @cindex customizing
2562 @findex gnus-group-customize
2563 Customize the group parameters (@code{gnus-group-customize}).
2564
2565 @item G e
2566 @kindex G e (Group)
2567 @findex gnus-group-edit-group-method
2568 @cindex renaming groups
2569 Enter a buffer where you can edit the select method of the current
2570 group (@code{gnus-group-edit-group-method}).
2571
2572 @item G p
2573 @kindex G p (Group)
2574 @findex gnus-group-edit-group-parameters
2575 Enter a buffer where you can edit the group parameters
2576 (@code{gnus-group-edit-group-parameters}).
2577
2578 @item G E
2579 @kindex G E (Group)
2580 @findex gnus-group-edit-group
2581 Enter a buffer where you can edit the group info
2582 (@code{gnus-group-edit-group}).
2583
2584 @item G d
2585 @kindex G d (Group)
2586 @findex gnus-group-make-directory-group
2587 @cindex nndir
2588 Make a directory group (@pxref{Directory Groups}).  You will be prompted
2589 for a directory name (@code{gnus-group-make-directory-group}).
2590
2591 @item G h
2592 @kindex G h (Group)
2593 @cindex help group
2594 @findex gnus-group-make-help-group
2595 Make the Gnus help group (@code{gnus-group-make-help-group}).
2596
2597 @item G D
2598 @kindex G D (Group)
2599 @findex gnus-group-enter-directory
2600 @cindex nneething
2601 Read an arbitrary directory as if it were a newsgroup with the
2602 @code{nneething} back end (@code{gnus-group-enter-directory}).
2603 @xref{Anything Groups}.
2604
2605 @item G f
2606 @kindex G f (Group)
2607 @findex gnus-group-make-doc-group
2608 @cindex ClariNet Briefs
2609 @cindex nndoc
2610 Make a group based on some file or other
2611 (@code{gnus-group-make-doc-group}).  If you give a prefix to this
2612 command, you will be prompted for a file name and a file type.
2613 Currently supported types are @code{mbox}, @code{babyl},
2614 @code{digest}, @code{news}, @code{rnews}, @code{mmdf}, @code{forward},
2615 @code{rfc934}, @code{rfc822-forward}, @code{mime-parts},
2616 @code{standard-digest}, @code{slack-digest}, @code{clari-briefs},
2617 @code{nsmail}, @code{outlook}, @code{oe-dbx}, and @code{mailman}.  If
2618 you run this command without a prefix, Gnus will guess at the file
2619 type.  @xref{Document Groups}.
2620
2621 @item G u
2622 @kindex G u (Group)
2623 @vindex gnus-useful-groups
2624 @findex gnus-group-make-useful-group
2625 Create one of the groups mentioned in @code{gnus-useful-groups}
2626 (@code{gnus-group-make-useful-group}).
2627
2628 @item G w
2629 @kindex G w (Group)
2630 @findex gnus-group-make-web-group
2631 @cindex Google
2632 @cindex nnweb
2633 @cindex gmane
2634 Make an ephemeral group based on a web search
2635 (@code{gnus-group-make-web-group}).  If you give a prefix to this
2636 command, make a solid group instead.  You will be prompted for the
2637 search engine type and the search string.  Valid search engine types
2638 include @code{google}, @code{dejanews}, and @code{gmane}.
2639 @xref{Web Searches}.
2640
2641 If you use the @code{google} search engine, you can limit the search
2642 to a particular group by using a match string like
2643 @samp{shaving group:alt.sysadmin.recovery}.
2644
2645 @item G R
2646 @kindex G R (Group)
2647 @findex gnus-group-make-rss-group
2648 Make a group based on an @acronym{RSS} feed
2649 (@code{gnus-group-make-rss-group}).  You will be prompted for an URL.
2650 @xref{RSS}.
2651
2652 @item G DEL
2653 @kindex G DEL (Group)
2654 @findex gnus-group-delete-group
2655 This function will delete the current group
2656 (@code{gnus-group-delete-group}).  If given a prefix, this function will
2657 actually delete all the articles in the group, and forcibly remove the
2658 group itself from the face of the Earth.  Use a prefix only if you are
2659 absolutely sure of what you are doing.  This command can't be used on
2660 read-only groups (like @code{nntp} groups), though.
2661
2662 @item G V
2663 @kindex G V (Group)
2664 @findex gnus-group-make-empty-virtual
2665 Make a new, fresh, empty @code{nnvirtual} group
2666 (@code{gnus-group-make-empty-virtual}).  @xref{Virtual Groups}.
2667
2668 @item G v
2669 @kindex G v (Group)
2670 @findex gnus-group-add-to-virtual
2671 Add the current group to an @code{nnvirtual} group
2672 (@code{gnus-group-add-to-virtual}).  Uses the process/prefix convention.
2673 @end table
2674
2675 @xref{Select Methods}, for more information on the various select
2676 methods.
2677
2678 @vindex gnus-activate-foreign-newsgroups
2679 If @code{gnus-activate-foreign-newsgroups} is a positive number,
2680 Gnus will check all foreign groups with this level or lower at startup.
2681 This might take quite a while, especially if you subscribe to lots of
2682 groups from different @acronym{NNTP} servers.  Also @pxref{Group Levels};
2683 @code{gnus-activate-level} also affects activation of foreign
2684 newsgroups.
2685
2686
2687 The following commands create ephemeral groups.  They can be called not
2688 only from the Group buffer, but in any Gnus buffer.
2689
2690 @table @code
2691 @item gnus-read-ephemeral-gmane-group
2692 @findex gnus-read-ephemeral-gmane-group
2693 @vindex gnus-gmane-group-download-format
2694 Read an ephemeral group on Gmane.org.  The articles are downloaded via
2695 HTTP using the URL specified by @code{gnus-gmane-group-download-format}.
2696 Gnus will prompt you for a group name, the start article number and an
2697 the article range.
2698
2699 @item gnus-read-ephemeral-gmane-group-url
2700 @findex gnus-read-ephemeral-gmane-group-url
2701 This command is similar to @code{gnus-read-ephemeral-gmane-group}, but
2702 the group name and the article number and range are constructed from a
2703 given @acronym{URL}.  Supported @acronym{URL} formats include e.g.
2704 @url{http://thread.gmane.org/gmane.foo.bar/12300/focus=12399},
2705 @url{http://thread.gmane.org/gmane.foo.bar/12345/},
2706 @url{http://article.gmane.org/gmane.foo.bar/12345/},
2707 @url{http://permalink.gmane.org/gmane.foo.bar/12345/}, and
2708 @url{http://news.gmane.org/group/gmane.foo.bar/thread=12345}.
2709
2710 @item gnus-read-ephemeral-emacs-bug-group
2711 @findex gnus-read-ephemeral-emacs-bug-group
2712 Read an Emacs bug report in an ephemeral group.  Gnus will prompt for a
2713 bug number.  The default is the number at point.  The @acronym{URL} is
2714 specified in @code{gnus-bug-group-download-format-alist}.
2715
2716 @item gnus-read-ephemeral-debian-bug-group
2717 @findex gnus-read-ephemeral-debian-bug-group
2718 Read a Debian bug report in an ephemeral group.  Analog to
2719 @code{gnus-read-ephemeral-emacs-bug-group}.
2720 @end table
2721
2722 Some of these command are also useful for article buttons, @xref{Article
2723 Buttons}.
2724
2725 Here is an example:
2726 @lisp
2727 (require 'gnus-art)
2728 (add-to-list
2729  'gnus-button-alist
2730  '("#\\([0-9]+\\)\\>" 1
2731    (string-match "\\<emacs\\>" (or gnus-newsgroup-name ""))
2732    gnus-read-ephemeral-emacs-bug-group 1))
2733 @end lisp
2734
2735
2736 @node Group Parameters
2737 @section Group Parameters
2738 @cindex group parameters
2739
2740 The group parameters store information local to a particular group.
2741
2742 Use the @kbd{G p} or the @kbd{G c} command to edit group parameters of a
2743 group.  (@kbd{G p} presents you with a Lisp-based interface, @kbd{G c}
2744 presents you with a Customize-like interface.  The latter helps avoid
2745 silly Lisp errors.)  You might also be interested in reading about topic
2746 parameters (@pxref{Topic Parameters}).
2747 Additionally, you can set group parameters via the
2748 @code{gnus-parameters} variable, see below.
2749
2750 Here's an example group parameter list:
2751
2752 @example
2753 ((to-address . "ding@@gnus.org")
2754  (auto-expire . t))
2755 @end example
2756
2757 We see that each element consists of a ``dotted pair''---the thing before
2758 the dot is the key, while the thing after the dot is the value.  All the
2759 parameters have this form @emph{except} local variable specs, which are
2760 not dotted pairs, but proper lists.
2761
2762 Some parameters have correspondent customizable variables, each of which
2763 is an alist of regexps and values.
2764
2765 The following group parameters can be used:
2766
2767 @table @code
2768 @item to-address
2769 @cindex to-address
2770 Address used by when doing followups and new posts.
2771
2772 @example
2773 (to-address . "some@@where.com")
2774 @end example
2775
2776 This is primarily useful in mail groups that represent closed mailing
2777 lists---mailing lists where it's expected that everybody that writes to
2778 the mailing list is subscribed to it.  Since using this parameter
2779 ensures that the mail only goes to the mailing list itself, it means
2780 that members won't receive two copies of your followups.
2781
2782 Using @code{to-address} will actually work whether the group is foreign
2783 or not.  Let's say there's a group on the server that is called
2784 @samp{fa.4ad-l}.  This is a real newsgroup, but the server has gotten
2785 the articles from a mail-to-news gateway.  Posting directly to this
2786 group is therefore impossible---you have to send mail to the mailing
2787 list address instead.
2788
2789 See also @code{gnus-parameter-to-address-alist}.
2790
2791 @item to-list
2792 @cindex to-list
2793 Address used when doing @kbd{a} in that group.
2794
2795 @example
2796 (to-list . "some@@where.com")
2797 @end example
2798
2799 It is totally ignored
2800 when doing a followup---except that if it is present in a news group,
2801 you'll get mail group semantics when doing @kbd{f}.
2802
2803 If you do an @kbd{a} command in a mail group and you have neither a
2804 @code{to-list} group parameter nor a @code{to-address} group parameter,
2805 then a @code{to-list} group parameter will be added automatically upon
2806 sending the message if @code{gnus-add-to-list} is set to @code{t}.
2807 @vindex gnus-add-to-list
2808
2809 @findex gnus-mailing-list-mode
2810 @cindex mail list groups
2811 If this variable is set, @code{gnus-mailing-list-mode} is turned on when
2812 entering summary buffer.
2813
2814 See also @code{gnus-parameter-to-list-alist}.
2815
2816 @anchor{subscribed}
2817 @item subscribed
2818 @cindex subscribed
2819 @cindex Mail-Followup-To
2820 @findex gnus-find-subscribed-addresses
2821 If this parameter is set to @code{t}, Gnus will consider the
2822 to-address and to-list parameters for this group as addresses of
2823 mailing lists you are subscribed to.  Giving Gnus this information is
2824 (only) a first step in getting it to generate correct Mail-Followup-To
2825 headers for your posts to these lists.  The second step is to put the
2826 following in your @file{.gnus.el}
2827
2828 @lisp
2829 (setq message-subscribed-address-functions
2830       '(gnus-find-subscribed-addresses))
2831 @end lisp
2832
2833 @xref{Mailing Lists, ,Mailing Lists, message, The Message Manual}, for
2834 a complete treatment of available MFT support.
2835
2836 @item visible
2837 @cindex visible
2838 If the group parameter list has the element @code{(visible . t)},
2839 that group will always be visible in the Group buffer, regardless
2840 of whether it has any unread articles.
2841
2842 This parameter cannot be set via @code{gnus-parameters}. See
2843 @code{gnus-permanently-visible-groups} as an alternative.
2844
2845 @item broken-reply-to
2846 @cindex broken-reply-to
2847 Elements like @code{(broken-reply-to . t)} signals that @code{Reply-To}
2848 headers in this group are to be ignored, and for the header to be hidden
2849 if @code{reply-to} is part of @code{gnus-boring-article-headers}.  This
2850 can be useful if you're reading a mailing list group where the listserv
2851 has inserted @code{Reply-To} headers that point back to the listserv
2852 itself.  That is broken behavior.  So there!
2853
2854 @item to-group
2855 @cindex to-group
2856 Elements like @code{(to-group . "some.group.name")} means that all
2857 posts in that group will be sent to @code{some.group.name}.
2858
2859 @item newsgroup
2860 @cindex newsgroup
2861 If you have @code{(newsgroup . t)} in the group parameter list, Gnus
2862 will treat all responses as if they were responses to news articles.
2863 This can be useful if you have a mail group that's really a mirror of a
2864 news group.
2865
2866 @item gcc-self
2867 @cindex gcc-self
2868 If @code{(gcc-self . t)} is present in the group parameter list, newly
2869 composed messages will be @code{Gcc}'d to the current group.  If
2870 @code{(gcc-self . none)} is present, no @code{Gcc:} header will be
2871 generated, if @code{(gcc-self . "string")} is present, this string will
2872 be inserted literally as a @code{gcc} header.  This parameter takes
2873 precedence over any default @code{Gcc} rules as described later
2874 (@pxref{Archived Messages}).
2875
2876 @strong{Caveat}: Adding @code{(gcc-self . t)} to the parameter list of
2877 @code{nntp} groups (or the like) isn't valid.  An @code{nntp} server
2878 doesn't accept articles.
2879
2880 @item auto-expire
2881 @cindex auto-expire
2882 @cindex expiring mail
2883 If the group parameter has an element that looks like @code{(auto-expire
2884 . t)}, all articles read will be marked as expirable.  For an
2885 alternative approach, @pxref{Expiring Mail}.
2886
2887 See also @code{gnus-auto-expirable-newsgroups}.
2888
2889 @item total-expire
2890 @cindex total-expire
2891 @cindex expiring mail
2892 If the group parameter has an element that looks like
2893 @code{(total-expire . t)}, all read articles will be put through the
2894 expiry process, even if they are not marked as expirable.  Use with
2895 caution.  Unread, ticked and dormant articles are not eligible for
2896 expiry.
2897
2898 See also @code{gnus-total-expirable-newsgroups}.
2899
2900 @item expiry-wait
2901 @cindex expiry-wait
2902 @vindex nnmail-expiry-wait-function
2903 If the group parameter has an element that looks like
2904 @code{(expiry-wait . 10)}, this value will override any
2905 @code{nnmail-expiry-wait} and @code{nnmail-expiry-wait-function}
2906 (@pxref{Expiring Mail}) when expiring expirable messages.  The value
2907 can either be a number of days (not necessarily an integer) or the
2908 symbols @code{never} or @code{immediate}.
2909
2910 @item expiry-target
2911 @cindex expiry-target
2912 Where expired messages end up.  This parameter overrides
2913 @code{nnmail-expiry-target}.
2914
2915 @item score-file
2916 @cindex score file group parameter
2917 Elements that look like @code{(score-file . "file")} will make
2918 @file{file} into the current score file for the group in question.  All
2919 interactive score entries will be put into this file.
2920
2921 @item adapt-file
2922 @cindex adapt file group parameter
2923 Elements that look like @code{(adapt-file . "file")} will make
2924 @file{file} into the current adaptive file for the group in question.
2925 All adaptive score entries will be put into this file.
2926
2927 @item admin-address
2928 @cindex admin-address
2929 When unsubscribing from a mailing list you should never send the
2930 unsubscription notice to the mailing list itself.  Instead, you'd send
2931 messages to the administrative address.  This parameter allows you to
2932 put the admin address somewhere convenient.
2933
2934 @item display
2935 @cindex display
2936 Elements that look like @code{(display . MODE)} say which articles to
2937 display on entering the group.  Valid values are:
2938
2939 @table @code
2940 @item all
2941 Display all articles, both read and unread.
2942
2943 @item an integer
2944 Display the last @var{integer} articles in the group.  This is the same as
2945 entering the group with @kbd{C-u @var{integer}}.
2946
2947 @item default
2948 Display the default visible articles, which normally includes unread and
2949 ticked articles.
2950
2951 @item an array
2952 Display articles that satisfy a predicate.
2953
2954 Here are some examples:
2955
2956 @table @code
2957 @item [unread]
2958 Display only unread articles.
2959
2960 @item [not expire]
2961 Display everything except expirable articles.
2962
2963 @item [and (not reply) (not expire)]
2964 Display everything except expirable and articles you've already
2965 responded to.
2966 @end table
2967
2968 The available operators are @code{not}, @code{and} and @code{or}.
2969 Predicates include @code{tick}, @code{unsend}, @code{undownload},
2970 @code{unread}, @code{dormant}, @code{expire}, @code{reply},
2971 @code{killed}, @code{bookmark}, @code{score}, @code{save},
2972 @code{cache}, @code{forward}, @code{unseen} and @code{recent}.
2973
2974 @end table
2975
2976 The @code{display} parameter works by limiting the summary buffer to
2977 the subset specified.  You can pop the limit by using the @kbd{/ w}
2978 command (@pxref{Limiting}).
2979
2980 @item comment
2981 @cindex comment
2982 Elements that look like @code{(comment . "This is a comment")} are
2983 arbitrary comments on the group.  You can display comments in the
2984 group line (@pxref{Group Line Specification}).
2985
2986 @item charset
2987 @cindex charset
2988 Elements that look like @code{(charset . iso-8859-1)} will make
2989 @code{iso-8859-1} the default charset; that is, the charset that will be
2990 used for all articles that do not specify a charset.
2991
2992 See also @code{gnus-group-charset-alist}.
2993
2994 @item ignored-charsets
2995 @cindex ignored-charset
2996 Elements that look like @code{(ignored-charsets x-unknown iso-8859-1)}
2997 will make @code{iso-8859-1} and @code{x-unknown} ignored; that is, the
2998 default charset will be used for decoding articles.
2999
3000 See also @code{gnus-group-ignored-charsets-alist}.
3001
3002 @item posting-style
3003 @cindex posting-style
3004 You can store additional posting style information for this group
3005 here (@pxref{Posting Styles}).  The format is that of an entry in the
3006 @code{gnus-posting-styles} alist, except that there's no regexp matching
3007 the group name (of course).  Style elements in this group parameter will
3008 take precedence over the ones found in @code{gnus-posting-styles}.
3009
3010 For instance, if you want a funky name and signature in this group only,
3011 instead of hacking @code{gnus-posting-styles}, you could put something
3012 like this in the group parameters:
3013
3014 @example
3015 (posting-style
3016   (name "Funky Name")
3017   ("X-My-Header" "Funky Value")
3018   (signature "Funky Signature"))
3019 @end example
3020
3021 If you're using topics to organize your group buffer
3022 (@pxref{Group Topics}), note that posting styles can also be set in
3023 the topics parameters. Posting styles in topic parameters apply to all
3024 groups in this topic. More precisely, the posting-style settings for a
3025 group result from the hierarchical merging of all posting-style
3026 entries in the parameters of this group and all the topics it belongs
3027 to.
3028
3029
3030 @item post-method
3031 @cindex post-method
3032 If it is set, the value is used as the method for posting message
3033 instead of @code{gnus-post-method}.
3034
3035 @item mail-source
3036 @cindex mail-source
3037 If it is set, and the setting of @code{mail-sources} includes a
3038 @code{group} mail source (@pxref{Mail Sources}), the value is a
3039 mail source for this group.
3040
3041 @item banner
3042 @cindex banner
3043 An item like @code{(banner . @var{regexp})} causes any part of an article
3044 that matches the regular expression @var{regexp} to be stripped.  Instead of
3045 @var{regexp}, you can also use the symbol @code{signature} which strips the
3046 last signature or any of the elements of the alist
3047 @code{gnus-article-banner-alist}.
3048
3049 @item sieve
3050 @cindex sieve
3051 This parameter contains a Sieve test that should match incoming mail
3052 that should be placed in this group.  From this group parameter, a
3053 Sieve @samp{IF} control structure is generated, having the test as the
3054 condition and @samp{fileinto "group.name";} as the body.
3055
3056 For example, if the @samp{INBOX.list.sieve} group has the @code{(sieve
3057 address "sender" "sieve-admin@@extundo.com")} group parameter, when
3058 translating the group parameter into a Sieve script (@pxref{Sieve
3059 Commands}) the following Sieve code is generated:
3060
3061 @example
3062 if address "sender" "sieve-admin@@extundo.com" @{
3063         fileinto "INBOX.list.sieve";
3064 @}
3065 @end example
3066
3067 To generate tests for multiple email-addresses use a group parameter
3068 like @code{(sieve address "sender" ("name@@one.org" else@@two.org"))}.
3069 When generating a sieve script (@pxref{Sieve Commands}) Sieve code
3070 like the following is generated:
3071
3072 @example
3073 if address "sender" ["name@@one.org", "else@@two.org"] @{
3074         fileinto "INBOX.list.sieve";
3075 @}
3076 @end example
3077
3078 See @pxref{Sieve Commands} for commands and variables that might be of
3079 interest in relation to the sieve parameter.
3080
3081 The Sieve language is described in RFC 3028.  @xref{Top, Emacs Sieve,
3082 Top, sieve, Emacs Sieve}.
3083
3084 @item (agent parameters)
3085 If the agent has been enabled, you can set any of its parameters to
3086 control the behavior of the agent in individual groups.  See Agent
3087 Parameters in @ref{Category Syntax}.  Most users will choose to set
3088 agent parameters in either an agent category or group topic to
3089 minimize the configuration effort.
3090
3091 @item (@var{variable} @var{form})
3092 You can use the group parameters to set variables local to the group you
3093 are entering.  If you want to turn threading off in @samp{news.answers},
3094 you could put @code{(gnus-show-threads nil)} in the group parameters of
3095 that group.  @code{gnus-show-threads} will be made into a local variable
3096 in the summary buffer you enter, and the form @code{nil} will be
3097 @code{eval}ed there.
3098
3099 Note that this feature sets the variable locally to the summary buffer
3100 if and only if @var{variable} has been bound as a variable.  Otherwise,
3101 only evaluating the form will take place.  So, you may want to bind the
3102 variable in advance using @code{defvar} or other if the result of the
3103 form needs to be set to it.
3104
3105 But some variables are evaluated in the article buffer, or in the
3106 message buffer (of a reply or followup or otherwise newly created
3107 message).  As a workaround, it might help to add the variable in
3108 question to @code{gnus-newsgroup-variables}.  @xref{Various Summary
3109 Stuff}.  So if you want to set @code{message-from-style} via the group
3110 parameters, then you may need the following statement elsewhere in your
3111 @file{~/.gnus.el} file:
3112
3113 @lisp
3114 (add-to-list 'gnus-newsgroup-variables 'message-from-style)
3115 @end lisp
3116
3117 @vindex gnus-list-identifiers
3118 A use for this feature is to remove a mailing list identifier tag in
3119 the subject fields of articles.  E.g. if the news group
3120
3121 @example
3122 nntp+news.gnus.org:gmane.text.docbook.apps
3123 @end example
3124
3125 has the tag @samp{DOC-BOOK-APPS:} in the subject of all articles, this
3126 tag can be removed from the article subjects in the summary buffer for
3127 the group by putting @code{(gnus-list-identifiers "DOCBOOK-APPS:")}
3128 into the group parameters for the group.
3129
3130 This can also be used as a group-specific hook function.  If you want to
3131 hear a beep when you enter a group, you could put something like
3132 @code{(dummy-variable (ding))} in the parameters of that group.  If
3133 @code{dummy-variable} has been bound (see above), it will be set to the
3134 (meaningless) result of the @code{(ding)} form.
3135
3136 Alternatively, since the VARIABLE becomes local to the group, this
3137 pattern can be used to temporarily change a hook.  For example, if the
3138 following is added to a group parameter
3139
3140 @lisp
3141 (gnus-summary-prepared-hook
3142   '(lambda nil (local-set-key "d" (local-key-binding "n"))))
3143 @end lisp
3144
3145 when the group is entered, the 'd' key will not mark the article as
3146 expired.
3147
3148 @end table
3149
3150 @vindex gnus-parameters
3151 Group parameters can be set via the @code{gnus-parameters} variable too.
3152 But some variables, such as @code{visible}, have no effect (For this
3153 case see @code{gnus-permanently-visible-groups} as an alternative.).
3154 For example:
3155
3156 @lisp
3157 (setq gnus-parameters
3158       '(("mail\\..*"
3159          (gnus-show-threads nil)
3160          (gnus-use-scoring nil)
3161          (gnus-summary-line-format
3162           "%U%R%z%I%(%[%d:%ub%-23,23f%]%) %s\n")
3163          (gcc-self . t)
3164          (display . all))
3165
3166         ("^nnimap:\\(foo.bar\\)$"
3167          (to-group . "\\1"))
3168
3169         ("mail\\.me"
3170          (gnus-use-scoring  t))
3171
3172         ("list\\..*"
3173          (total-expire . t)
3174          (broken-reply-to . t))))
3175 @end lisp
3176
3177 String value of parameters will be subjected to regexp substitution, as
3178 the @code{to-group} example shows.
3179
3180 @vindex gnus-parameters-case-fold-search
3181 By default, whether comparing the group name and one of those regexps
3182 specified in @code{gnus-parameters} is done in a case-sensitive manner
3183 or a case-insensitive manner depends on the value of
3184 @code{case-fold-search} at the time when the comparison is done.  The
3185 value of @code{case-fold-search} is typically @code{t}; it means, for
3186 example, the element @code{("INBOX\\.FOO" (total-expire . t))} might be
3187 applied to both the @samp{INBOX.FOO} group and the @samp{INBOX.foo}
3188 group.  If you want to make those regexps always case-sensitive, set the
3189 value of the @code{gnus-parameters-case-fold-search} variable to
3190 @code{nil}.  Otherwise, set it to @code{t} if you want to compare them
3191 always in a case-insensitive manner.
3192
3193 You can define different sorting to different groups via
3194 @code{gnus-parameters}.  Here is an example to sort an @acronym{NNTP}
3195 group by reverse date to see the latest news at the top and an
3196 @acronym{RSS} group by subject.  In this example, the first group is the
3197 Debian daily news group @code{gmane.linux.debian.user.news} from
3198 news.gmane.org.  The @acronym{RSS} group corresponds to the Debian
3199 weekly news RSS feed
3200 @url{http://packages.debian.org/unstable/newpkg_main.en.rdf},
3201 @xref{RSS}.
3202
3203 @lisp
3204 (setq
3205  gnus-parameters
3206  '(("nntp.*gmane\\.debian\\.user\\.news"
3207     (gnus-show-threads nil)
3208     (gnus-article-sort-functions '((not gnus-article-sort-by-date)))
3209     (gnus-use-adaptive-scoring nil)
3210     (gnus-use-scoring nil))
3211    ("nnrss.*debian"
3212     (gnus-show-threads nil)
3213     (gnus-article-sort-functions 'gnus-article-sort-by-subject)
3214     (gnus-use-adaptive-scoring nil)
3215     (gnus-use-scoring t)
3216     (gnus-score-find-score-files-function 'gnus-score-find-single)
3217     (gnus-summary-line-format "%U%R%z%d %I%(%[ %s %]%)\n"))))
3218 @end lisp
3219
3220
3221 @node Listing Groups
3222 @section Listing Groups
3223 @cindex group listing
3224
3225 These commands all list various slices of the groups available.
3226
3227 @table @kbd
3228
3229 @item l
3230 @itemx A s
3231 @kindex A s (Group)
3232 @kindex l (Group)
3233 @findex gnus-group-list-groups
3234 List all groups that have unread articles
3235 (@code{gnus-group-list-groups}).  If the numeric prefix is used, this
3236 command will list only groups of level ARG and lower.  By default, it
3237 only lists groups of level five (i.e.,
3238 @code{gnus-group-default-list-level}) or lower (i.e., just subscribed
3239 groups).
3240
3241 @item L
3242 @itemx A u
3243 @kindex A u (Group)
3244 @kindex L (Group)
3245 @findex gnus-group-list-all-groups
3246 List all groups, whether they have unread articles or not
3247 (@code{gnus-group-list-all-groups}).  If the numeric prefix is used,
3248 this command will list only groups of level ARG and lower.  By default,
3249 it lists groups of level seven or lower (i.e., just subscribed and
3250 unsubscribed groups).
3251
3252 @item A l
3253 @kindex A l (Group)
3254 @findex gnus-group-list-level
3255 List all unread groups on a specific level
3256 (@code{gnus-group-list-level}).  If given a prefix, also list the groups
3257 with no unread articles.
3258
3259 @item A k
3260 @kindex A k (Group)
3261 @findex gnus-group-list-killed
3262 List all killed groups (@code{gnus-group-list-killed}).  If given a
3263 prefix argument, really list all groups that are available, but aren't
3264 currently (un)subscribed.  This could entail reading the active file
3265 from the server.
3266
3267 @item A z
3268 @kindex A z (Group)
3269 @findex gnus-group-list-zombies
3270 List all zombie groups (@code{gnus-group-list-zombies}).
3271
3272 @item A m
3273 @kindex A m (Group)
3274 @findex gnus-group-list-matching
3275 List all unread, subscribed groups with names that match a regexp
3276 (@code{gnus-group-list-matching}).
3277
3278 @item A M
3279 @kindex A M (Group)
3280 @findex gnus-group-list-all-matching
3281 List groups that match a regexp (@code{gnus-group-list-all-matching}).
3282
3283 @item A A
3284 @kindex A A (Group)
3285 @findex gnus-group-list-active
3286 List absolutely all groups in the active file(s) of the
3287 server(s) you are connected to (@code{gnus-group-list-active}).  This
3288 might very well take quite a while.  It might actually be a better idea
3289 to do a @kbd{A M} to list all matching, and just give @samp{.} as the
3290 thing to match on.  Also note that this command may list groups that
3291 don't exist (yet)---these will be listed as if they were killed groups.
3292 Take the output with some grains of salt.
3293
3294 @item A a
3295 @kindex A a (Group)
3296 @findex gnus-group-apropos
3297 List all groups that have names that match a regexp
3298 (@code{gnus-group-apropos}).
3299
3300 @item A d
3301 @kindex A d (Group)
3302 @findex gnus-group-description-apropos
3303 List all groups that have names or descriptions that match a regexp
3304 (@code{gnus-group-description-apropos}).
3305
3306 @item A c
3307 @kindex A c (Group)
3308 @findex gnus-group-list-cached
3309 List all groups with cached articles (@code{gnus-group-list-cached}).
3310
3311 @item A ?
3312 @kindex A ? (Group)
3313 @findex gnus-group-list-dormant
3314 List all groups with dormant articles (@code{gnus-group-list-dormant}).
3315
3316 @item A /
3317 @kindex A / (Group)
3318 @findex gnus-group-list-limit
3319 List groups limited within the current selection
3320 (@code{gnus-group-list-limit}).
3321
3322 @item A f
3323 @kindex A f (Group)
3324 @findex gnus-group-list-flush
3325 Flush groups from the current selection (@code{gnus-group-list-flush}).
3326
3327 @item A p
3328 @kindex A p (Group)
3329 @findex gnus-group-list-plus
3330 List groups plus the current selection (@code{gnus-group-list-plus}).
3331
3332 @end table
3333
3334 @vindex gnus-permanently-visible-groups
3335 @cindex visible group parameter
3336 Groups that match the @code{gnus-permanently-visible-groups} regexp will
3337 always be shown, whether they have unread articles or not.  You can also
3338 add the @code{visible} element to the group parameters in question to
3339 get the same effect.
3340
3341 @vindex gnus-list-groups-with-ticked-articles
3342 Groups that have just ticked articles in it are normally listed in the
3343 group buffer.  If @code{gnus-list-groups-with-ticked-articles} is
3344 @code{nil}, these groups will be treated just like totally empty
3345 groups.  It is @code{t} by default.
3346
3347
3348 @node Sorting Groups
3349 @section Sorting Groups
3350 @cindex sorting groups
3351
3352 @kindex C-c C-s (Group)
3353 @findex gnus-group-sort-groups
3354 @vindex gnus-group-sort-function
3355 The @kbd{C-c C-s} (@code{gnus-group-sort-groups}) command sorts the
3356 group buffer according to the function(s) given by the
3357 @code{gnus-group-sort-function} variable.  Available sorting functions
3358 include:
3359
3360 @table @code
3361
3362 @item gnus-group-sort-by-alphabet
3363 @findex gnus-group-sort-by-alphabet
3364 Sort the group names alphabetically.  This is the default.
3365
3366 @item gnus-group-sort-by-real-name
3367 @findex gnus-group-sort-by-real-name
3368 Sort the group alphabetically on the real (unprefixed) group names.
3369
3370 @item gnus-group-sort-by-level
3371 @findex gnus-group-sort-by-level
3372 Sort by group level.
3373
3374 @item gnus-group-sort-by-score
3375 @findex gnus-group-sort-by-score
3376 Sort by group score.  @xref{Group Score}.
3377
3378 @item gnus-group-sort-by-rank
3379 @findex gnus-group-sort-by-rank
3380 Sort by group score and then the group level.  The level and the score
3381 are, when taken together, the group's @dfn{rank}.  @xref{Group Score}.
3382
3383 @item gnus-group-sort-by-unread
3384 @findex gnus-group-sort-by-unread
3385 Sort by number of unread articles.
3386
3387 @item gnus-group-sort-by-method
3388 @findex gnus-group-sort-by-method
3389 Sort alphabetically on the select method.
3390
3391 @item gnus-group-sort-by-server
3392 @findex gnus-group-sort-by-server
3393 Sort alphabetically on the Gnus server name.
3394
3395
3396 @end table
3397
3398 @code{gnus-group-sort-function} can also be a list of sorting
3399 functions.  In that case, the most significant sort key function must be
3400 the last one.
3401
3402
3403 There are also a number of commands for sorting directly according to
3404 some sorting criteria:
3405
3406 @table @kbd
3407 @item G S a
3408 @kindex G S a (Group)
3409 @findex gnus-group-sort-groups-by-alphabet
3410 Sort the group buffer alphabetically by group name
3411 (@code{gnus-group-sort-groups-by-alphabet}).
3412
3413 @item G S u
3414 @kindex G S u (Group)
3415 @findex gnus-group-sort-groups-by-unread
3416 Sort the group buffer by the number of unread articles
3417 (@code{gnus-group-sort-groups-by-unread}).
3418
3419 @item G S l
3420 @kindex G S l (Group)
3421 @findex gnus-group-sort-groups-by-level
3422 Sort the group buffer by group level
3423 (@code{gnus-group-sort-groups-by-level}).
3424
3425 @item G S v
3426 @kindex G S v (Group)
3427 @findex gnus-group-sort-groups-by-score
3428 Sort the group buffer by group score
3429 (@code{gnus-group-sort-groups-by-score}).  @xref{Group Score}.
3430
3431 @item G S r
3432 @kindex G S r (Group)
3433 @findex gnus-group-sort-groups-by-rank
3434 Sort the group buffer by group rank
3435 (@code{gnus-group-sort-groups-by-rank}).  @xref{Group Score}.
3436
3437 @item G S m
3438 @kindex G S m (Group)
3439 @findex gnus-group-sort-groups-by-method
3440 Sort the group buffer alphabetically by back end name@*
3441 (@code{gnus-group-sort-groups-by-method}).
3442
3443 @item G S n
3444 @kindex G S n (Group)
3445 @findex gnus-group-sort-groups-by-real-name
3446 Sort the group buffer alphabetically by real (unprefixed) group name
3447 (@code{gnus-group-sort-groups-by-real-name}).
3448
3449 @end table
3450
3451 All the commands below obey the process/prefix convention
3452 (@pxref{Process/Prefix}).
3453
3454 When given a symbolic prefix (@pxref{Symbolic Prefixes}), all these
3455 commands will sort in reverse order.
3456
3457 You can also sort a subset of the groups:
3458
3459 @table @kbd
3460 @item G P a
3461 @kindex G P a (Group)
3462 @findex gnus-group-sort-selected-groups-by-alphabet
3463 Sort the groups alphabetically by group name
3464 (@code{gnus-group-sort-selected-groups-by-alphabet}).
3465
3466 @item G P u
3467 @kindex G P u (Group)
3468 @findex gnus-group-sort-selected-groups-by-unread
3469 Sort the groups by the number of unread articles
3470 (@code{gnus-group-sort-selected-groups-by-unread}).
3471
3472 @item G P l
3473 @kindex G P l (Group)
3474 @findex gnus-group-sort-selected-groups-by-level
3475 Sort the groups by group level
3476 (@code{gnus-group-sort-selected-groups-by-level}).
3477
3478 @item G P v
3479 @kindex G P v (Group)
3480 @findex gnus-group-sort-selected-groups-by-score
3481 Sort the groups by group score
3482 (@code{gnus-group-sort-selected-groups-by-score}).  @xref{Group Score}.
3483
3484 @item G P r
3485 @kindex G P r (Group)
3486 @findex gnus-group-sort-selected-groups-by-rank
3487 Sort the groups by group rank
3488 (@code{gnus-group-sort-selected-groups-by-rank}).  @xref{Group Score}.
3489
3490 @item G P m
3491 @kindex G P m (Group)
3492 @findex gnus-group-sort-selected-groups-by-method
3493 Sort the groups alphabetically by back end name@*
3494 (@code{gnus-group-sort-selected-groups-by-method}).
3495
3496 @item G P n
3497 @kindex G P n (Group)
3498 @findex gnus-group-sort-selected-groups-by-real-name
3499 Sort the groups alphabetically by real (unprefixed) group name
3500 (@code{gnus-group-sort-selected-groups-by-real-name}).
3501
3502 @item G P s
3503 @kindex G P s (Group)
3504 @findex gnus-group-sort-selected-groups
3505 Sort the groups according to @code{gnus-group-sort-function}.
3506
3507 @end table
3508
3509 And finally, note that you can use @kbd{C-k} and @kbd{C-y} to manually
3510 move groups around.
3511
3512
3513 @node Group Maintenance
3514 @section Group Maintenance
3515 @cindex bogus groups
3516
3517 @table @kbd
3518 @item b
3519 @kindex b (Group)
3520 @findex gnus-group-check-bogus-groups
3521 Find bogus groups and delete them
3522 (@code{gnus-group-check-bogus-groups}).
3523
3524 @item F
3525 @kindex F (Group)
3526 @findex gnus-group-find-new-groups
3527 Find new groups and process them (@code{gnus-group-find-new-groups}).
3528 With 1 @kbd{C-u}, use the @code{ask-server} method to query the server
3529 for new groups.  With 2 @kbd{C-u}'s, use most complete method possible
3530 to query the server for new groups, and subscribe the new groups as
3531 zombies.
3532
3533 @item C-c C-x
3534 @kindex C-c C-x (Group)
3535 @findex gnus-group-expire-articles
3536 @cindex expiring mail
3537 Run all expirable articles in the current group through the expiry
3538 process (if any) (@code{gnus-group-expire-articles}).  That is, delete
3539 all expirable articles in the group that have been around for a while.
3540 (@pxref{Expiring Mail}).
3541
3542 @item C-c C-M-x
3543 @kindex C-c C-M-x (Group)
3544 @findex gnus-group-expire-all-groups
3545 @cindex expiring mail
3546 Run all expirable articles in all groups through the expiry process
3547 (@code{gnus-group-expire-all-groups}).
3548
3549 @end table
3550
3551
3552 @node Browse Foreign Server
3553 @section Browse Foreign Server
3554 @cindex foreign servers
3555 @cindex browsing servers
3556
3557 @table @kbd
3558 @item B
3559 @kindex B (Group)
3560 @findex gnus-group-browse-foreign-server
3561 You will be queried for a select method and a server name.  Gnus will
3562 then attempt to contact this server and let you browse the groups there
3563 (@code{gnus-group-browse-foreign-server}).
3564 @end table
3565
3566 @findex gnus-browse-mode
3567 A new buffer with a list of available groups will appear.  This buffer
3568 will use the @code{gnus-browse-mode}.  This buffer looks a bit (well,
3569 a lot) like a normal group buffer.
3570
3571 Here's a list of keystrokes available in the browse mode:
3572
3573 @table @kbd
3574 @item n
3575 @kindex n (Browse)
3576 @findex gnus-group-next-group
3577 Go to the next group (@code{gnus-group-next-group}).
3578
3579 @item p
3580 @kindex p (Browse)
3581 @findex gnus-group-prev-group
3582 Go to the previous group (@code{gnus-group-prev-group}).
3583
3584 @item SPACE
3585 @kindex SPACE (Browse)
3586 @findex gnus-browse-read-group
3587 Enter the current group and display the first article
3588 (@code{gnus-browse-read-group}).
3589
3590 @item RET
3591 @kindex RET (Browse)
3592 @findex gnus-browse-select-group
3593 Enter the current group (@code{gnus-browse-select-group}).
3594
3595 @item u
3596 @kindex u (Browse)
3597 @findex gnus-browse-unsubscribe-current-group
3598 @vindex gnus-browse-subscribe-newsgroup-method
3599 Unsubscribe to the current group, or, as will be the case here,
3600 subscribe to it (@code{gnus-browse-unsubscribe-current-group}).  You
3601 can affect the way the new group is entered into the Group buffer
3602 using the variable @code{gnus-browse-subscribe-newsgroup-method}.  See
3603 @pxref{Subscription Methods} for available options.
3604
3605 @item l
3606 @itemx q
3607 @kindex q (Browse)
3608 @kindex l (Browse)
3609 @findex gnus-browse-exit
3610 Exit browse mode (@code{gnus-browse-exit}).
3611
3612 @item d
3613 @kindex d (Browse)
3614 @findex gnus-browse-describe-group
3615 Describe the current group (@code{gnus-browse-describe-group}).
3616
3617 @item ?
3618 @kindex ? (Browse)
3619 @findex gnus-browse-describe-briefly
3620 Describe browse mode briefly (well, there's not much to describe, is
3621 there) (@code{gnus-browse-describe-briefly}).
3622 @end table
3623
3624
3625 @node Exiting Gnus
3626 @section Exiting Gnus
3627 @cindex exiting Gnus
3628
3629 Yes, Gnus is ex(c)iting.
3630
3631 @table @kbd
3632 @item z
3633 @kindex z (Group)
3634 @findex gnus-group-suspend
3635 Suspend Gnus (@code{gnus-group-suspend}).  This doesn't really exit Gnus,
3636 but it kills all buffers except the Group buffer.  I'm not sure why this
3637 is a gain, but then who am I to judge?
3638
3639 @item q
3640 @kindex q (Group)
3641 @findex gnus-group-exit
3642 @c @icon{gnus-group-exit}
3643 Quit Gnus (@code{gnus-group-exit}).
3644
3645 @item Q
3646 @kindex Q (Group)
3647 @findex gnus-group-quit
3648 Quit Gnus without saving the @file{.newsrc} files (@code{gnus-group-quit}).
3649 The dribble file will be saved, though (@pxref{Auto Save}).
3650 @end table
3651
3652 @vindex gnus-exit-gnus-hook
3653 @vindex gnus-suspend-gnus-hook
3654 @vindex gnus-after-exiting-gnus-hook
3655 @code{gnus-suspend-gnus-hook} is called when you suspend Gnus and
3656 @code{gnus-exit-gnus-hook} is called when you quit Gnus, while
3657 @code{gnus-after-exiting-gnus-hook} is called as the final item when
3658 exiting Gnus.
3659
3660 Note:
3661
3662 @quotation
3663 Miss Lisa Cannifax, while sitting in English class, felt her feet go
3664 numbly heavy and herself fall into a hazy trance as the boy sitting
3665 behind her drew repeated lines with his pencil across the back of her
3666 plastic chair.
3667 @end quotation
3668
3669
3670 @node Group Topics
3671 @section Group Topics
3672 @cindex topics
3673
3674 If you read lots and lots of groups, it might be convenient to group
3675 them hierarchically according to topics.  You put your Emacs groups over
3676 here, your sex groups over there, and the rest (what, two groups or so?)
3677 you put in some misc section that you never bother with anyway.  You can
3678 even group the Emacs sex groups as a sub-topic to either the Emacs
3679 groups or the sex groups---or both!  Go wild!
3680
3681 @iftex
3682 @iflatex
3683 \gnusfigure{Group Topics}{400}{
3684 \put(75,50){\epsfig{figure=ps/group-topic,height=9cm}}
3685 }
3686 @end iflatex
3687 @end iftex
3688
3689 Here's an example:
3690
3691 @example
3692 Gnus
3693   Emacs -- I wuw it!
3694      3: comp.emacs
3695      2: alt.religion.emacs
3696     Naughty Emacs
3697      452: alt.sex.emacs
3698        0: comp.talk.emacs.recovery
3699   Misc
3700      8: comp.binaries.fractals
3701     13: comp.sources.unix
3702 @end example
3703
3704 @findex gnus-topic-mode
3705 @kindex t (Group)
3706 To get this @emph{fab} functionality you simply turn on (ooh!) the
3707 @code{gnus-topic} minor mode---type @kbd{t} in the group buffer.  (This
3708 is a toggling command.)
3709
3710 Go ahead, just try it.  I'll still be here when you get back.  La de
3711 dum@dots{} Nice tune, that@dots{} la la la@dots{} What, you're back?
3712 Yes, and now press @kbd{l}.  There.  All your groups are now listed
3713 under @samp{misc}.  Doesn't that make you feel all warm and fuzzy?
3714 Hot and bothered?
3715
3716 If you want this permanently enabled, you should add that minor mode to
3717 the hook for the group mode.  Put the following line in your
3718 @file{~/.gnus.el} file:
3719
3720 @lisp
3721 (add-hook 'gnus-group-mode-hook 'gnus-topic-mode)
3722 @end lisp
3723
3724 @menu
3725 * Topic Commands::              Interactive E-Z commands.
3726 * Topic Variables::             How to customize the topics the Lisp Way.
3727 * Topic Sorting::               Sorting each topic individually.
3728 * Topic Topology::              A map of the world.
3729 * Topic Parameters::            Parameters that apply to all groups in a topic.
3730 @end menu
3731
3732
3733 @node Topic Commands
3734 @subsection Topic Commands
3735 @cindex topic commands
3736
3737 When the topic minor mode is turned on, a new @kbd{T} submap will be
3738 available.  In addition, a few of the standard keys change their
3739 definitions slightly.
3740
3741 In general, the following kinds of operations are possible on topics.
3742 First of all, you want to create topics.  Secondly, you want to put
3743 groups in topics and to move them around until you have an order you
3744 like.  The third kind of operation is to show/hide parts of the whole
3745 shebang.  You might want to hide a topic including its subtopics and
3746 groups, to get a better overview of the other groups.
3747
3748 Here is a list of the basic keys that you might need to set up topics
3749 the way you like.
3750
3751 @table @kbd
3752
3753 @item T n
3754 @kindex T n (Topic)
3755 @findex gnus-topic-create-topic
3756 Prompt for a new topic name and create it
3757 (@code{gnus-topic-create-topic}).
3758
3759 @item T TAB
3760 @itemx TAB
3761 @kindex T TAB (Topic)
3762 @kindex TAB (Topic)
3763 @findex gnus-topic-indent
3764 ``Indent'' the current topic so that it becomes a sub-topic of the
3765 previous topic (@code{gnus-topic-indent}).  If given a prefix,
3766 ``un-indent'' the topic instead.
3767
3768 @item M-TAB
3769 @kindex M-TAB (Topic)
3770 @findex gnus-topic-unindent
3771 ``Un-indent'' the current topic so that it becomes a sub-topic of the
3772 parent of its current parent (@code{gnus-topic-unindent}).
3773
3774 @end table
3775
3776 The following two keys can be used to move groups and topics around.
3777 They work like the well-known cut and paste.  @kbd{C-k} is like cut and
3778 @kbd{C-y} is like paste.  Of course, this being Emacs, we use the terms
3779 kill and yank rather than cut and paste.
3780
3781 @table @kbd
3782
3783 @item C-k
3784 @kindex C-k (Topic)
3785 @findex gnus-topic-kill-group
3786 Kill a group or topic (@code{gnus-topic-kill-group}).  All groups in the
3787 topic will be removed along with the topic.
3788
3789 @item C-y
3790 @kindex C-y (Topic)
3791 @findex gnus-topic-yank-group
3792 Yank the previously killed group or topic
3793 (@code{gnus-topic-yank-group}).  Note that all topics will be yanked
3794 before all groups.
3795
3796 So, to move a topic to the beginning of the list of topics, just hit
3797 @kbd{C-k} on it.  This is like the ``cut'' part of cut and paste.  Then,
3798 move the cursor to the beginning of the buffer (just below the ``Gnus''
3799 topic) and hit @kbd{C-y}.  This is like the ``paste'' part of cut and
3800 paste.  Like I said -- E-Z.
3801
3802 You can use @kbd{C-k} and @kbd{C-y} on groups as well as on topics.  So
3803 you can move topics around as well as groups.
3804
3805 @end table
3806
3807 After setting up the topics the way you like them, you might wish to
3808 hide a topic, or to show it again.  That's why we have the following
3809 key.
3810
3811 @table @kbd
3812
3813 @item RET
3814 @kindex RET (Topic)
3815 @findex gnus-topic-select-group
3816 @itemx SPACE
3817 Either select a group or fold a topic (@code{gnus-topic-select-group}).
3818 When you perform this command on a group, you'll enter the group, as
3819 usual.  When done on a topic line, the topic will be folded (if it was
3820 visible) or unfolded (if it was folded already).  So it's basically a
3821 toggling command on topics.  In addition, if you give a numerical
3822 prefix, group on that level (and lower) will be displayed.
3823
3824 @end table
3825
3826 Now for a list of other commands, in no particular order.
3827
3828 @table @kbd
3829
3830 @item T m
3831 @kindex T m (Topic)
3832 @findex gnus-topic-move-group
3833 Move the current group to some other topic
3834 (@code{gnus-topic-move-group}).  This command uses the process/prefix
3835 convention (@pxref{Process/Prefix}).
3836
3837 @item T j
3838 @kindex T j (Topic)
3839 @findex gnus-topic-jump-to-topic
3840 Go to a topic (@code{gnus-topic-jump-to-topic}).
3841
3842 @item T c
3843 @kindex T c (Topic)
3844 @findex gnus-topic-copy-group
3845 Copy the current group to some other topic
3846 (@code{gnus-topic-copy-group}).  This command uses the process/prefix
3847 convention (@pxref{Process/Prefix}).
3848
3849 @item T h
3850 @kindex T h (Topic)
3851 @findex gnus-topic-hide-topic
3852 Hide the current topic (@code{gnus-topic-hide-topic}).  If given
3853 a prefix, hide the topic permanently.
3854
3855 @item T s
3856 @kindex T s (Topic)
3857 @findex gnus-topic-show-topic
3858 Show the current topic (@code{gnus-topic-show-topic}).  If given
3859 a prefix, show the topic permanently.
3860
3861 @item T D
3862 @kindex T D (Topic)
3863 @findex gnus-topic-remove-group
3864 Remove a group from the current topic (@code{gnus-topic-remove-group}).
3865 This command is mainly useful if you have the same group in several
3866 topics and wish to remove it from one of the topics.  You may also
3867 remove a group from all topics, but in that case, Gnus will add it to
3868 the root topic the next time you start Gnus.  In fact, all new groups
3869 (which, naturally, don't belong to any topic) will show up in the root
3870 topic.
3871
3872 This command uses the process/prefix convention
3873 (@pxref{Process/Prefix}).
3874
3875 @item T M
3876 @kindex T M (Topic)
3877 @findex gnus-topic-move-matching
3878 Move all groups that match some regular expression to a topic
3879 (@code{gnus-topic-move-matching}).
3880
3881 @item T C
3882 @kindex T C (Topic)
3883 @findex gnus-topic-copy-matching
3884 Copy all groups that match some regular expression to a topic
3885 (@code{gnus-topic-copy-matching}).
3886
3887 @item T H
3888 @kindex T H (Topic)
3889 @findex gnus-topic-toggle-display-empty-topics
3890 Toggle hiding empty topics
3891 (@code{gnus-topic-toggle-display-empty-topics}).
3892
3893 @item T #
3894 @kindex T # (Topic)
3895 @findex gnus-topic-mark-topic
3896 Mark all groups in the current topic with the process mark
3897 (@code{gnus-topic-mark-topic}).  This command works recursively on
3898 sub-topics unless given a prefix.
3899
3900 @item T M-#
3901 @kindex T M-# (Topic)
3902 @findex gnus-topic-unmark-topic
3903 Remove the process mark from all groups in the current topic
3904 (@code{gnus-topic-unmark-topic}).  This command works recursively on
3905 sub-topics unless given a prefix.
3906
3907 @item C-c C-x
3908 @kindex C-c C-x (Topic)
3909 @findex gnus-topic-expire-articles
3910 @cindex expiring mail
3911 Run all expirable articles in the current group or topic through the
3912 expiry process (if any)
3913 (@code{gnus-topic-expire-articles}).  (@pxref{Expiring Mail}).
3914
3915 @item T r
3916 @kindex T r (Topic)
3917 @findex gnus-topic-rename
3918 Rename a topic (@code{gnus-topic-rename}).
3919
3920 @item T DEL
3921 @kindex T DEL (Topic)
3922 @findex gnus-topic-delete
3923 Delete an empty topic (@code{gnus-topic-delete}).
3924
3925 @item A T
3926 @kindex A T (Topic)
3927 @findex gnus-topic-list-active
3928 List all groups that Gnus knows about in a topics-ified way
3929 (@code{gnus-topic-list-active}).
3930
3931 @item T M-n
3932 @kindex T M-n (Topic)
3933 @findex gnus-topic-goto-next-topic
3934 Go to the next topic (@code{gnus-topic-goto-next-topic}).
3935
3936 @item T M-p
3937 @kindex T M-p (Topic)
3938 @findex gnus-topic-goto-previous-topic
3939 Go to the previous topic (@code{gnus-topic-goto-previous-topic}).
3940
3941 @item G p
3942 @kindex G p (Topic)
3943 @findex gnus-topic-edit-parameters
3944 @cindex group parameters
3945 @cindex topic parameters
3946 @cindex parameters
3947 Edit the topic parameters (@code{gnus-topic-edit-parameters}).
3948 @xref{Topic Parameters}.
3949
3950 @end table
3951
3952
3953 @node Topic Variables
3954 @subsection Topic Variables
3955 @cindex topic variables
3956
3957 The previous section told you how to tell Gnus which topics to display.
3958 This section explains how to tell Gnus what to display about each topic.
3959
3960 @vindex gnus-topic-line-format
3961 The topic lines themselves are created according to the
3962 @code{gnus-topic-line-format} variable (@pxref{Formatting Variables}).
3963 Valid elements are:
3964
3965 @table @samp
3966 @item i
3967 Indentation.
3968 @item n
3969 Topic name.
3970 @item v
3971 Visibility.
3972 @item l
3973 Level.
3974 @item g
3975 Number of groups in the topic.
3976 @item a
3977 Number of unread articles in the topic.
3978 @item A
3979 Number of unread articles in the topic and all its subtopics.
3980 @end table
3981
3982 @vindex gnus-topic-indent-level
3983 Each sub-topic (and the groups in the sub-topics) will be indented with
3984 @code{gnus-topic-indent-level} times the topic level number of spaces.
3985 The default is 2.
3986
3987 @vindex gnus-topic-mode-hook
3988 @code{gnus-topic-mode-hook} is called in topic minor mode buffers.
3989
3990 @vindex gnus-topic-display-empty-topics
3991 The @code{gnus-topic-display-empty-topics} says whether to display even
3992 topics that have no unread articles in them.  The default is @code{t}.
3993
3994
3995 @node Topic Sorting
3996 @subsection Topic Sorting
3997 @cindex topic sorting
3998
3999 You can sort the groups in each topic individually with the following
4000 commands:
4001
4002
4003 @table @kbd
4004 @item T S a
4005 @kindex T S a (Topic)
4006 @findex gnus-topic-sort-groups-by-alphabet
4007 Sort the current topic alphabetically by group name
4008 (@code{gnus-topic-sort-groups-by-alphabet}).
4009
4010 @item T S u
4011 @kindex T S u (Topic)
4012 @findex gnus-topic-sort-groups-by-unread
4013 Sort the current topic by the number of unread articles
4014 (@code{gnus-topic-sort-groups-by-unread}).
4015
4016 @item T S l
4017 @kindex T S l (Topic)
4018 @findex gnus-topic-sort-groups-by-level
4019 Sort the current topic by group level
4020 (@code{gnus-topic-sort-groups-by-level}).
4021
4022 @item T S v
4023 @kindex T S v (Topic)
4024 @findex gnus-topic-sort-groups-by-score
4025 Sort the current topic by group score
4026 (@code{gnus-topic-sort-groups-by-score}).  @xref{Group Score}.
4027
4028 @item T S r
4029 @kindex T S r (Topic)
4030 @findex gnus-topic-sort-groups-by-rank
4031 Sort the current topic by group rank
4032 (@code{gnus-topic-sort-groups-by-rank}).  @xref{Group Score}.
4033
4034 @item T S m
4035 @kindex T S m (Topic)
4036 @findex gnus-topic-sort-groups-by-method
4037 Sort the current topic alphabetically by back end name
4038 (@code{gnus-topic-sort-groups-by-method}).
4039
4040 @item T S e
4041 @kindex T S e (Topic)
4042 @findex gnus-topic-sort-groups-by-server
4043 Sort the current topic alphabetically by server name
4044 (@code{gnus-topic-sort-groups-by-server}).
4045
4046 @item T S s
4047 @kindex T S s (Topic)
4048 @findex gnus-topic-sort-groups
4049 Sort the current topic according to the function(s) given by the
4050 @code{gnus-group-sort-function} variable
4051 (@code{gnus-topic-sort-groups}).
4052
4053 @end table
4054
4055 When given a prefix argument, all these commands will sort in reverse
4056 order.  @xref{Sorting Groups}, for more information about group
4057 sorting.
4058
4059
4060 @node Topic Topology
4061 @subsection Topic Topology
4062 @cindex topic topology
4063 @cindex topology
4064
4065 So, let's have a look at an example group buffer:
4066
4067 @example
4068 @group
4069 Gnus
4070   Emacs -- I wuw it!
4071      3: comp.emacs
4072      2: alt.religion.emacs
4073     Naughty Emacs
4074      452: alt.sex.emacs
4075        0: comp.talk.emacs.recovery
4076   Misc
4077      8: comp.binaries.fractals
4078     13: comp.sources.unix
4079 @end group
4080 @end example
4081
4082 So, here we have one top-level topic (@samp{Gnus}), two topics under
4083 that, and one sub-topic under one of the sub-topics.  (There is always
4084 just one (1) top-level topic).  This topology can be expressed as
4085 follows:
4086
4087 @lisp
4088 (("Gnus" visible)
4089  (("Emacs -- I wuw it!" visible)
4090   (("Naughty Emacs" visible)))
4091  (("Misc" visible)))
4092 @end lisp
4093
4094 @vindex gnus-topic-topology
4095 This is in fact how the variable @code{gnus-topic-topology} would look
4096 for the display above.  That variable is saved in the @file{.newsrc.eld}
4097 file, and shouldn't be messed with manually---unless you really want
4098 to.  Since this variable is read from the @file{.newsrc.eld} file,
4099 setting it in any other startup files will have no effect.
4100
4101 This topology shows what topics are sub-topics of what topics (right),
4102 and which topics are visible.  Two settings are currently
4103 allowed---@code{visible} and @code{invisible}.
4104
4105
4106 @node Topic Parameters
4107 @subsection Topic Parameters
4108 @cindex topic parameters
4109
4110 All groups in a topic will inherit group parameters from the parent
4111 (and ancestor) topic parameters.  All valid group parameters are valid
4112 topic parameters (@pxref{Group Parameters}).  When the agent is
4113 enabled, all agent parameters (See Agent Parameters in @ref{Category
4114 Syntax}) are also valid topic parameters.
4115
4116 In addition, the following parameters are only valid as topic
4117 parameters:
4118
4119 @table @code
4120 @item subscribe
4121 When subscribing new groups by topic (@pxref{Subscription Methods}), the
4122 @code{subscribe} topic parameter says what groups go in what topic.  Its
4123 value should be a regexp to match the groups that should go in that
4124 topic.
4125
4126 @item subscribe-level
4127 When subscribing new groups by topic (see the @code{subscribe} parameter),
4128 the group will be subscribed with the level specified in the
4129 @code{subscribe-level} instead of @code{gnus-level-default-subscribed}.
4130
4131 @end table
4132
4133 Group parameters (of course) override topic parameters, and topic
4134 parameters in sub-topics override topic parameters in super-topics.  You
4135 know.  Normal inheritance rules.  (@dfn{Rules} is here a noun, not a
4136 verb, although you may feel free to disagree with me here.)
4137
4138 @example
4139 @group
4140 Gnus
4141   Emacs
4142      3: comp.emacs
4143      2: alt.religion.emacs
4144    452: alt.sex.emacs
4145     Relief
4146      452: alt.sex.emacs
4147        0: comp.talk.emacs.recovery
4148   Misc
4149      8: comp.binaries.fractals
4150     13: comp.sources.unix
4151    452: alt.sex.emacs
4152 @end group
4153 @end example
4154
4155 The @samp{Emacs} topic has the topic parameter @code{(score-file
4156 . "emacs.SCORE")}; the @samp{Relief} topic has the topic parameter
4157 @code{(score-file . "relief.SCORE")}; and the @samp{Misc} topic has the
4158 topic parameter @code{(score-file . "emacs.SCORE")}.  In addition,
4159 @* @samp{alt.religion.emacs} has the group parameter @code{(score-file
4160 . "religion.SCORE")}.
4161
4162 Now, when you enter @samp{alt.sex.emacs} in the @samp{Relief} topic, you
4163 will get the @file{relief.SCORE} home score file.  If you enter the same
4164 group in the @samp{Emacs} topic, you'll get the @file{emacs.SCORE} home
4165 score file.  If you enter the group @samp{alt.religion.emacs}, you'll
4166 get the @file{religion.SCORE} home score file.
4167
4168 This seems rather simple and self-evident, doesn't it?  Well, yes.  But
4169 there are some problems, especially with the @code{total-expiry}
4170 parameter.  Say you have a mail group in two topics; one with
4171 @code{total-expiry} and one without.  What happens when you do @kbd{M-x
4172 gnus-expire-all-expirable-groups}?  Gnus has no way of telling which one
4173 of these topics you mean to expire articles from, so anything may
4174 happen.  In fact, I hereby declare that it is @dfn{undefined} what
4175 happens.  You just have to be careful if you do stuff like that.
4176
4177
4178 @node Non-ASCII Group Names
4179 @section Accessing groups of non-English names
4180 @cindex non-ascii group names
4181
4182 There are some news servers that provide groups of which the names are
4183 expressed with their native languages in the world.  For instance, in a
4184 certain news server there are some newsgroups of which the names are
4185 spelled in Chinese, where people are talking in Chinese.  You can, of
4186 course, subscribe to such news groups using Gnus.  Currently Gnus
4187 supports non-@acronym{ASCII} group names not only with the @code{nntp}
4188 back end but also with the @code{nnml} back end and the @code{nnrss}
4189 back end.
4190
4191 Every such group name is encoded by a certain charset in the server
4192 side (in an @acronym{NNTP} server its administrator determines the
4193 charset, but for groups in the other back ends it is determined by you).
4194 Gnus has to display the decoded ones for you in the group buffer and the
4195 article buffer, and needs to use the encoded ones when communicating
4196 with servers.  However, Gnus doesn't know what charset is used for each
4197 non-@acronym{ASCII} group name.  The following two variables are just
4198 the ones for telling Gnus what charset should be used for each group:
4199
4200 @table @code
4201 @item gnus-group-name-charset-method-alist
4202 @vindex gnus-group-name-charset-method-alist
4203 An alist of select methods and charsets.  The default value is
4204 @code{nil}.  The names of groups in the server specified by that select
4205 method are all supposed to use the corresponding charset.  For example:
4206
4207 @lisp
4208 (setq gnus-group-name-charset-method-alist
4209       '(((nntp "news.com.cn") . cn-gb-2312)))
4210 @end lisp
4211
4212 Charsets specified for groups with this variable are preferred to the
4213 ones specified for the same groups with the
4214 @code{gnus-group-name-charset-group-alist} variable (see below).
4215
4216 A select method can be very long, like:
4217
4218 @lisp
4219 (nntp "gmane"
4220       (nntp-address "news.gmane.org")
4221       (nntp-end-of-line "\n")
4222       (nntp-open-connection-function
4223        nntp-open-via-rlogin-and-telnet)
4224       (nntp-via-rlogin-command "ssh")
4225       (nntp-via-rlogin-command-switches
4226        ("-C" "-t" "-e" "none"))
4227       (nntp-via-address @dots{}))
4228 @end lisp
4229
4230 In that case, you can truncate it into @code{(nntp "gmane")} in this
4231 variable.  That is, it is enough to contain only the back end name and
4232 the server name.
4233
4234 @item gnus-group-name-charset-group-alist
4235 @cindex UTF-8 group names
4236 @vindex gnus-group-name-charset-group-alist
4237 An alist of regexp of group name and the charset for group names.
4238 @code{((".*" . utf-8))} is the default value if UTF-8 is supported,
4239 otherwise the default is @code{nil}.  For example:
4240
4241 @lisp
4242 (setq gnus-group-name-charset-group-alist
4243       '(("\\.com\\.cn:" . cn-gb-2312)
4244         (".*" . utf-8)))
4245 @end lisp
4246
4247 Note that this variable is ignored if the match is made with
4248 @code{gnus-group-name-charset-method-alist}.
4249 @end table
4250
4251 Those two variables are used also to determine the charset for encoding
4252 and decoding non-@acronym{ASCII} group names that are in the back ends
4253 other than @code{nntp}.  It means that it is you who determine it.  If
4254 you do nothing, the charset used for group names in those back ends will
4255 all be @code{utf-8} because of the last element of
4256 @code{gnus-group-name-charset-group-alist}.
4257
4258 There is one more important variable for non-@acronym{ASCII} group
4259 names:
4260
4261 @table @code
4262 @item nnmail-pathname-coding-system
4263 @vindex nnmail-pathname-coding-system
4264 The value of this variable should be a coding system or @code{nil}.  The
4265 default is @code{nil} in Emacs, or is the aliasee of the coding system
4266 named @code{file-name} (a certain coding system of which an alias is
4267 @code{file-name}) in XEmacs.
4268
4269 The @code{nnml} back end, the @code{nnrss} back end, the @acronym{NNTP}
4270 marks feature (@pxref{NNTP marks}), the agent, and the cache use
4271 non-@acronym{ASCII} group names in those files and directories.  This
4272 variable overrides the value of @code{file-name-coding-system} which
4273 specifies the coding system used when encoding and decoding those file
4274 names and directory names.
4275
4276 In XEmacs (with the @code{mule} feature), @code{file-name-coding-system}
4277 is the only means to specify the coding system used to encode and decode
4278 file names.  On the other hand, Emacs uses the value of
4279 @code{default-file-name-coding-system} if @code{file-name-coding-system}
4280 is @code{nil} or it is bound to the value of
4281 @code{nnmail-pathname-coding-system} which is @code{nil}.
4282
4283 Normally the value of @code{default-file-name-coding-system} in Emacs or
4284 @code{nnmail-pathname-coding-system} in XEmacs is initialized according
4285 to the locale, so you will need to do nothing if the value is suitable
4286 to encode and decode non-@acronym{ASCII} group names.
4287
4288 The value of this variable (or @code{default-file-name-coding-system})
4289 does not necessarily need to be the same value that is determined by
4290 @code{gnus-group-name-charset-method-alist} and
4291 @code{gnus-group-name-charset-group-alist}.
4292
4293 If @code{default-file-name-coding-system} or this variable is
4294 initialized by default to @code{iso-latin-1} for example, although you
4295 want to subscribe to the groups spelled in Chinese, that is the most
4296 typical case where you have to customize
4297 @code{nnmail-pathname-coding-system}.  The @code{utf-8} coding system is
4298 a good candidate for it.  Otherwise, you may change the locale in your
4299 system so that @code{default-file-name-coding-system} or this variable
4300 may be initialized to an appropriate value.
4301 @end table
4302
4303 Note that when you copy or move articles from a non-@acronym{ASCII}
4304 group to another group, the charset used to encode and decode group
4305 names should be the same in both groups.  Otherwise the Newsgroups
4306 header will be displayed incorrectly in the article buffer.
4307
4308
4309 @node Misc Group Stuff
4310 @section Misc Group Stuff
4311
4312 @menu
4313 * Scanning New Messages::       Asking Gnus to see whether new messages have arrived.
4314 * Group Information::           Information and help on groups and Gnus.
4315 * Group Timestamp::             Making Gnus keep track of when you last read a group.
4316 * File Commands::               Reading and writing the Gnus files.
4317 * Sieve Commands::              Managing Sieve scripts.
4318 @end menu
4319
4320 @table @kbd
4321
4322 @item v
4323 @kindex v (Group)
4324 @cindex keys, reserved for users (Group)
4325 The key @kbd{v} is reserved for users.  You can bind it to some
4326 command or better use it as a prefix key.  For example:
4327
4328 @lisp
4329 (define-key gnus-group-mode-map (kbd "v j d")
4330   (lambda ()
4331     (interactive)
4332     (gnus-group-jump-to-group "nndraft:drafts")))
4333 @end lisp
4334
4335 On keys reserved for users in Emacs and on keybindings in general
4336 @xref{Keymaps, Keymaps, , emacs, The Emacs Editor}.
4337
4338 @item ^
4339 @kindex ^ (Group)
4340 @findex gnus-group-enter-server-mode
4341 Enter the server buffer (@code{gnus-group-enter-server-mode}).
4342 @xref{Server Buffer}.
4343
4344 @item a
4345 @kindex a (Group)
4346 @findex gnus-group-post-news
4347 Start composing a message (a news by default)
4348 (@code{gnus-group-post-news}).  If given a prefix, post to the group
4349 under the point.  If the prefix is 1, prompt for a group to post to.
4350 Contrary to what the name of this function suggests, the prepared
4351 article might be a mail instead of a news, if a mail group is specified
4352 with the prefix argument.  @xref{Composing Messages}.
4353
4354 @item m
4355 @kindex m (Group)
4356 @findex gnus-group-mail
4357 Mail a message somewhere (@code{gnus-group-mail}).  If given a prefix,
4358 use the posting style of the group under the point.  If the prefix is 1,
4359 prompt for a group name to find the posting style.
4360 @xref{Composing Messages}.
4361
4362 @item i
4363 @kindex i (Group)
4364 @findex gnus-group-news
4365 Start composing a news (@code{gnus-group-news}).  If given a prefix,
4366 post to the group under the point.  If the prefix is 1, prompt
4367 for group to post to.  @xref{Composing Messages}.
4368
4369 This function actually prepares a news even when using mail groups.
4370 This is useful for ``posting'' messages to mail groups without actually
4371 sending them over the network: they're just saved directly to the group
4372 in question.  The corresponding back end must have a request-post method
4373 for this to work though.
4374
4375 @item G z
4376 @kindex G z (Group)
4377 @findex gnus-group-compact-group
4378
4379 Compact the group under point (@code{gnus-group-compact-group}).
4380 Currently implemented only in nnml (@pxref{Mail Spool}).  This removes
4381 gaps between article numbers, hence getting a correct total article
4382 count.
4383
4384 @end table
4385
4386 Variables for the group buffer:
4387
4388 @table @code
4389
4390 @item gnus-group-mode-hook
4391 @vindex gnus-group-mode-hook
4392 is called after the group buffer has been
4393 created.
4394
4395 @item gnus-group-prepare-hook
4396 @vindex gnus-group-prepare-hook
4397 is called after the group buffer is
4398 generated.  It may be used to modify the buffer in some strange,
4399 unnatural way.
4400
4401 @item gnus-group-prepared-hook
4402 @vindex gnus-group-prepare-hook
4403 is called as the very last thing after the group buffer has been
4404 generated.  It may be used to move point around, for instance.
4405
4406 @item gnus-permanently-visible-groups
4407 @vindex gnus-permanently-visible-groups
4408 Groups matching this regexp will always be listed in the group buffer,
4409 whether they are empty or not.
4410
4411 @end table
4412
4413 @node Scanning New Messages
4414 @subsection Scanning New Messages
4415 @cindex new messages
4416 @cindex scanning new news
4417
4418 @table @kbd
4419
4420 @item g
4421 @kindex g (Group)
4422 @findex gnus-group-get-new-news
4423 @c @icon{gnus-group-get-new-news}
4424 Check the server(s) for new articles.  If the numerical prefix is used,
4425 this command will check only groups of level @var{arg} and lower
4426 (@code{gnus-group-get-new-news}).  If given a non-numerical prefix, this
4427 command will force a total re-reading of the active file(s) from the
4428 back end(s).
4429
4430 @item M-g
4431 @kindex M-g (Group)
4432 @findex gnus-group-get-new-news-this-group
4433 @vindex gnus-goto-next-group-when-activating
4434 @c @icon{gnus-group-get-new-news-this-group}
4435 Check whether new articles have arrived in the current group
4436 (@code{gnus-group-get-new-news-this-group}).
4437 @code{gnus-goto-next-group-when-activating} says whether this command is
4438 to move point to the next group or not.  It is @code{t} by default.
4439
4440 @findex gnus-activate-all-groups
4441 @cindex activating groups
4442 @item C-c M-g
4443 @kindex C-c M-g (Group)
4444 Activate absolutely all groups (@code{gnus-activate-all-groups}).
4445
4446 @item R
4447 @kindex R (Group)
4448 @cindex restarting
4449 @findex gnus-group-restart
4450 Restart Gnus (@code{gnus-group-restart}).  This saves the @file{.newsrc}
4451 file(s), closes the connection to all servers, clears up all run-time
4452 Gnus variables, and then starts Gnus all over again.
4453
4454 @end table
4455
4456 @vindex gnus-get-new-news-hook
4457 @code{gnus-get-new-news-hook} is run just before checking for new news.
4458
4459 @vindex gnus-after-getting-new-news-hook
4460 @code{gnus-after-getting-new-news-hook} is run after checking for new
4461 news.
4462
4463
4464 @node Group Information
4465 @subsection Group Information
4466 @cindex group information
4467 @cindex information on groups
4468
4469 @table @kbd
4470
4471
4472 @item H f
4473 @kindex H f (Group)
4474 @findex gnus-group-fetch-faq
4475 @vindex gnus-group-faq-directory
4476 @cindex FAQ
4477 @cindex ange-ftp
4478 Try to fetch the @acronym{FAQ} for the current group
4479 (@code{gnus-group-fetch-faq}).  Gnus will try to get the @acronym{FAQ}
4480 from @code{gnus-group-faq-directory}, which is usually a directory on
4481 a remote machine.  This variable can also be a list of directories.
4482 In that case, giving a prefix to this command will allow you to choose
4483 between the various sites.  @code{ange-ftp} (or @code{efs}) will be
4484 used for fetching the file.
4485
4486 If fetching from the first site is unsuccessful, Gnus will attempt to go
4487 through @code{gnus-group-faq-directory} and try to open them one by one.
4488
4489 @item H d
4490 @itemx C-c C-d
4491 @c @icon{gnus-group-describe-group}
4492 @kindex H d (Group)
4493 @kindex C-c C-d (Group)
4494 @cindex describing groups
4495 @cindex group description
4496 @findex gnus-group-describe-group
4497 Describe the current group (@code{gnus-group-describe-group}).  If given
4498 a prefix, force Gnus to re-read the description from the server.
4499
4500 @item M-d
4501 @kindex M-d (Group)
4502 @findex gnus-group-describe-all-groups
4503 Describe all groups (@code{gnus-group-describe-all-groups}).  If given a
4504 prefix, force Gnus to re-read the description file from the server.
4505
4506 @item H v
4507 @itemx V
4508 @kindex V (Group)
4509 @kindex H v (Group)
4510 @cindex version
4511 @findex gnus-version
4512 Display current Gnus version numbers (@code{gnus-version}).
4513
4514 @item ?
4515 @kindex ? (Group)
4516 @findex gnus-group-describe-briefly
4517 Give a very short help message (@code{gnus-group-describe-briefly}).
4518
4519 @item C-c C-i
4520 @kindex C-c C-i (Group)
4521 @cindex info
4522 @cindex manual
4523 @findex gnus-info-find-node
4524 Go to the Gnus info node (@code{gnus-info-find-node}).
4525 @end table
4526
4527
4528 @node Group Timestamp
4529 @subsection Group Timestamp
4530 @cindex timestamps
4531 @cindex group timestamps
4532
4533 It can be convenient to let Gnus keep track of when you last read a
4534 group.  To set the ball rolling, you should add
4535 @code{gnus-group-set-timestamp} to @code{gnus-select-group-hook}:
4536
4537 @lisp
4538 (add-hook 'gnus-select-group-hook 'gnus-group-set-timestamp)
4539 @end lisp
4540
4541 After doing this, each time you enter a group, it'll be recorded.
4542
4543 This information can be displayed in various ways---the easiest is to
4544 use the @samp{%d} spec in the group line format:
4545
4546 @lisp
4547 (setq gnus-group-line-format
4548       "%M\%S\%p\%P\%5y: %(%-40,40g%) %d\n")
4549 @end lisp
4550
4551 This will result in lines looking like:
4552
4553 @example
4554 *        0: mail.ding                                19961002T012943
4555          0: custom                                   19961002T012713
4556 @end example
4557
4558 As you can see, the date is displayed in compact ISO 8601 format.  This
4559 may be a bit too much, so to just display the date, you could say
4560 something like:
4561
4562 @lisp
4563 (setq gnus-group-line-format
4564       "%M\%S\%p\%P\%5y: %(%-40,40g%) %6,6~(cut 2)d\n")
4565 @end lisp
4566
4567 If you would like greater control of the time format, you can use a
4568 user-defined format spec.  Something like the following should do the
4569 trick:
4570
4571 @lisp
4572 (setq gnus-group-line-format
4573       "%M\%S\%p\%P\%5y: %(%-40,40g%) %ud\n")
4574 (defun gnus-user-format-function-d (headers)
4575   (let ((time (gnus-group-timestamp gnus-tmp-group)))
4576     (if time
4577         (format-time-string "%b %d  %H:%M" time)
4578       "")))
4579 @end lisp
4580
4581
4582 @node File Commands
4583 @subsection File Commands
4584 @cindex file commands
4585
4586 @table @kbd
4587
4588 @item r
4589 @kindex r (Group)
4590 @findex gnus-group-read-init-file
4591 @vindex gnus-init-file
4592 @cindex reading init file
4593 Re-read the init file (@code{gnus-init-file}, which defaults to
4594 @file{~/.gnus.el}) (@code{gnus-group-read-init-file}).
4595
4596 @item s
4597 @kindex s (Group)
4598 @findex gnus-group-save-newsrc
4599 @cindex saving .newsrc
4600 Save the @file{.newsrc.eld} file (and @file{.newsrc} if wanted)
4601 (@code{gnus-group-save-newsrc}).  If given a prefix, force saving the
4602 file(s) whether Gnus thinks it is necessary or not.
4603
4604 @c @item Z
4605 @c @kindex Z (Group)
4606 @c @findex gnus-group-clear-dribble
4607 @c Clear the dribble buffer (@code{gnus-group-clear-dribble}).
4608
4609 @end table
4610
4611
4612 @node Sieve Commands
4613 @subsection Sieve Commands
4614 @cindex group sieve commands
4615
4616 Sieve is a server-side mail filtering language.  In Gnus you can use
4617 the @code{sieve} group parameter (@pxref{Group Parameters}) to specify
4618 sieve rules that should apply to each group.  Gnus provides two
4619 commands to translate all these group parameters into a proper Sieve
4620 script that can be transfered to the server somehow.
4621
4622 @vindex gnus-sieve-file
4623 @vindex gnus-sieve-region-start
4624 @vindex gnus-sieve-region-end
4625 The generated Sieve script is placed in @code{gnus-sieve-file} (by
4626 default @file{~/.sieve}).  The Sieve code that Gnus generate is placed
4627 between two delimiters, @code{gnus-sieve-region-start} and
4628 @code{gnus-sieve-region-end}, so you may write additional Sieve code
4629 outside these delimiters that will not be removed the next time you
4630 regenerate the Sieve script.
4631
4632 @vindex gnus-sieve-crosspost
4633 The variable @code{gnus-sieve-crosspost} controls how the Sieve script
4634 is generated.  If it is non-@code{nil} (the default) articles is
4635 placed in all groups that have matching rules, otherwise the article
4636 is only placed in the group with the first matching rule.  For
4637 example, the group parameter @samp{(sieve address "sender"
4638 "owner-ding@@hpc.uh.edu")} will generate the following piece of Sieve
4639 code if @code{gnus-sieve-crosspost} is @code{nil}.  (When
4640 @code{gnus-sieve-crosspost} is non-@code{nil}, it looks the same
4641 except that the line containing the call to @code{stop} is removed.)
4642
4643 @example
4644 if address "sender" "owner-ding@@hpc.uh.edu" @{
4645         fileinto "INBOX.ding";
4646         stop;
4647 @}
4648 @end example
4649
4650 @xref{Top, Emacs Sieve, Top, sieve, Emacs Sieve}.
4651
4652 @table @kbd
4653
4654 @item D g
4655 @kindex D g (Group)
4656 @findex gnus-sieve-generate
4657 @vindex gnus-sieve-file
4658 @cindex generating sieve script
4659 Regenerate a Sieve script from the @code{sieve} group parameters and
4660 put you into the @code{gnus-sieve-file} without saving it.
4661
4662 @item D u
4663 @kindex D u (Group)
4664 @findex gnus-sieve-update
4665 @vindex gnus-sieve-file
4666 @cindex updating sieve script
4667 Regenerates the Gnus managed part of @code{gnus-sieve-file} using the
4668 @code{sieve} group parameters, save the file and upload it to the
4669 server using the @code{sieveshell} program.
4670
4671 @end table
4672
4673
4674 @node Summary Buffer
4675 @chapter Summary Buffer
4676 @cindex summary buffer
4677
4678 A line for each article is displayed in the summary buffer.  You can
4679 move around, read articles, post articles and reply to articles.
4680
4681 The most common way to a summary buffer is to select a group from the
4682 group buffer (@pxref{Selecting a Group}).
4683
4684 You can have as many summary buffers open as you wish.
4685
4686 You can customize the Summary Mode tool bar, see @kbd{M-x
4687 customize-apropos RET gnus-summary-tool-bar}.  This feature is only
4688 available in Emacs.
4689
4690 @kindex v (Summary)
4691 @cindex keys, reserved for users (Summary)
4692 The key @kbd{v} is reserved for users.  You can bind it to some
4693 command or better use it as a prefix key.  For example:
4694 @lisp
4695 (define-key gnus-summary-mode-map (kbd "v -") "LrS") ;; lower subthread
4696 @end lisp
4697
4698 @menu
4699 * Summary Buffer Format::       Deciding how the summary buffer is to look.
4700 * Summary Maneuvering::         Moving around the summary buffer.
4701 * Choosing Articles::           Reading articles.
4702 * Paging the Article::          Scrolling the current article.
4703 * Reply Followup and Post::     Posting articles.
4704 * Delayed Articles::            Send articles at a later time.
4705 * Marking Articles::            Marking articles as read, expirable, etc.
4706 * Limiting::                    You can limit the summary buffer.
4707 * Threading::                   How threads are made.
4708 * Sorting the Summary Buffer::  How articles and threads are sorted.
4709 * Asynchronous Fetching::       Gnus might be able to pre-fetch articles.
4710 * Article Caching::             You may store articles in a cache.
4711 * Persistent Articles::         Making articles expiry-resistant.
4712 * Sticky Articles::             Article buffers that are not reused.
4713 * Article Backlog::             Having already read articles hang around.
4714 * Saving Articles::             Ways of customizing article saving.
4715 * Decoding Articles::           Gnus can treat series of (uu)encoded articles.
4716 * Article Treatment::           The article buffer can be mangled at will.
4717 * MIME Commands::               Doing MIMEy things with the articles.
4718 * Charsets::                    Character set issues.
4719 * Article Commands::            Doing various things with the article buffer.
4720 * Summary Sorting::             Sorting the summary buffer in various ways.
4721 * Finding the Parent::          No child support? Get the parent.
4722 * Alternative Approaches::      Reading using non-default summaries.
4723 * Tree Display::                A more visual display of threads.
4724 * Mail Group Commands::         Some commands can only be used in mail groups.
4725 * Various Summary Stuff::       What didn't fit anywhere else.
4726 * Exiting the Summary Buffer::  Returning to the Group buffer,
4727                                 or reselecting the current group.
4728 * Crosspost Handling::          How crossposted articles are dealt with.
4729 * Duplicate Suppression::       An alternative when crosspost handling fails.
4730 * Security::                    Decrypt and Verify.
4731 * Mailing List::                Mailing list minor mode.
4732 @end menu
4733
4734
4735 @node Summary Buffer Format
4736 @section Summary Buffer Format
4737 @cindex summary buffer format
4738
4739 @iftex
4740 @iflatex
4741 \gnusfigure{The Summary Buffer}{180}{
4742 \put(0,0){\epsfig{figure=ps/summary,width=7.5cm}}
4743 \put(445,0){\makebox(0,0)[br]{\epsfig{figure=ps/summary-article,width=7.5cm}}}
4744 }
4745 @end iflatex
4746 @end iftex
4747
4748 @menu
4749 * Summary Buffer Lines::        You can specify how summary lines should look.
4750 * To From Newsgroups::          How to not display your own name.
4751 * Summary Buffer Mode Line::    You can say how the mode line should look.
4752 * Summary Highlighting::        Making the summary buffer all pretty and nice.
4753 @end menu
4754
4755 @findex mail-extract-address-components
4756 @findex gnus-extract-address-components
4757 @vindex gnus-extract-address-components
4758 Gnus will use the value of the @code{gnus-extract-address-components}
4759 variable as a function for getting the name and address parts of a
4760 @code{From} header.  Two pre-defined functions exist:
4761 @code{gnus-extract-address-components}, which is the default, quite
4762 fast, and too simplistic solution; and
4763 @code{mail-extract-address-components}, which works very nicely, but is
4764 slower.  The default function will return the wrong answer in 5% of the
4765 cases.  If this is unacceptable to you, use the other function instead:
4766
4767 @lisp
4768 (setq gnus-extract-address-components
4769       'mail-extract-address-components)
4770 @end lisp
4771
4772 @vindex gnus-summary-same-subject
4773 @code{gnus-summary-same-subject} is a string indicating that the current
4774 article has the same subject as the previous.  This string will be used
4775 with those specs that require it.  The default is @code{""}.
4776
4777
4778 @node Summary Buffer Lines
4779 @subsection Summary Buffer Lines
4780
4781 @vindex gnus-summary-line-format
4782 You can change the format of the lines in the summary buffer by changing
4783 the @code{gnus-summary-line-format} variable.  It works along the same
4784 lines as a normal @code{format} string, with some extensions
4785 (@pxref{Formatting Variables}).
4786
4787 There should always be a colon or a point position marker on the line;
4788 the cursor always moves to the point position marker or the colon after
4789 performing an operation.  (Of course, Gnus wouldn't be Gnus if it wasn't
4790 possible to change this.  Just write a new function
4791 @code{gnus-goto-colon} which does whatever you like with the cursor.)
4792 @xref{Positioning Point}.
4793
4794 The default string is @samp{%U%R%z%I%(%[%4L: %-23,23f%]%) %s\n}.
4795
4796 The following format specification characters and extended format
4797 specification(s) are understood:
4798
4799 @table @samp
4800 @item N
4801 Article number.
4802 @item S
4803 Subject string.  List identifiers stripped,
4804 @code{gnus-list-identifiers}.  @xref{Article Hiding}.
4805 @item s
4806 Subject if the article is the root of the thread or the previous article
4807 had a different subject, @code{gnus-summary-same-subject} otherwise.
4808 (@code{gnus-summary-same-subject} defaults to @code{""}.)
4809 @item F
4810 Full @code{From} header.
4811 @item n
4812 The name (from the @code{From} header).
4813 @item f
4814 The name, @code{To} header or the @code{Newsgroups} header (@pxref{To
4815 From Newsgroups}).
4816 @item a
4817 The name (from the @code{From} header).  This differs from the @code{n}
4818 spec in that it uses the function designated by the
4819 @code{gnus-extract-address-components} variable, which is slower, but
4820 may be more thorough.
4821 @item A
4822 The address (from the @code{From} header).  This works the same way as
4823 the @code{a} spec.
4824 @item L
4825 Number of lines in the article.
4826 @item c
4827 Number of characters in the article.  This specifier is not supported
4828 in some methods (like nnfolder).
4829 @item k
4830 Pretty-printed version of the number of characters in the article;
4831 for example, @samp{1.2k} or @samp{0.4M}.
4832 @item I
4833 Indentation based on thread level (@pxref{Customizing Threading}).
4834 @item B
4835 A complex trn-style thread tree, showing response-connecting trace
4836 lines.  A thread could be drawn like this:
4837
4838 @example
4839 >
4840 +->
4841 | +->
4842 | | \->
4843 | |   \->
4844 | \->
4845 +->
4846 \->
4847 @end example
4848
4849 You can customize the appearance with the following options.  Note
4850 that it is possible to make the thread display look really neat by
4851 replacing the default @acronym{ASCII} characters with graphic
4852 line-drawing glyphs.
4853 @table @code
4854 @item gnus-sum-thread-tree-root
4855 @vindex gnus-sum-thread-tree-root
4856 Used for the root of a thread.  If @code{nil}, use subject
4857 instead.  The default is @samp{> }.
4858
4859 @item gnus-sum-thread-tree-false-root
4860 @vindex gnus-sum-thread-tree-false-root
4861 Used for the false root of a thread (@pxref{Loose Threads}).  If
4862 @code{nil}, use subject instead.  The default is @samp{> }.
4863
4864 @item gnus-sum-thread-tree-single-indent
4865 @vindex gnus-sum-thread-tree-single-indent
4866 Used for a thread with just one message.  If @code{nil}, use subject
4867 instead.  The default is @samp{}.
4868
4869 @item gnus-sum-thread-tree-vertical
4870 @vindex gnus-sum-thread-tree-vertical
4871 Used for drawing a vertical line.  The default is @samp{| }.
4872
4873 @item gnus-sum-thread-tree-indent
4874 @vindex gnus-sum-thread-tree-indent
4875 Used for indenting.  The default is @samp{  }.
4876
4877 @item gnus-sum-thread-tree-leaf-with-other
4878 @vindex gnus-sum-thread-tree-leaf-with-other
4879 Used for a leaf with brothers.  The default is @samp{+-> }.
4880
4881 @item gnus-sum-thread-tree-single-leaf
4882 @vindex gnus-sum-thread-tree-single-leaf
4883 Used for a leaf without brothers.  The default is @samp{\-> }
4884
4885 @end table
4886
4887 @item T
4888 Nothing if the article is a root and lots of spaces if it isn't (it
4889 pushes everything after it off the screen).
4890 @item [
4891 Opening bracket, which is normally @samp{[}, but can also be @samp{<}
4892 for adopted articles (@pxref{Customizing Threading}).
4893 @item ]
4894 Closing bracket, which is normally @samp{]}, but can also be @samp{>}
4895 for adopted articles.
4896 @item >
4897 One space for each thread level.
4898 @item <
4899 Twenty minus thread level spaces.
4900 @item U
4901 Unread.  @xref{Read Articles}.
4902
4903 @item R
4904 This misleadingly named specifier is the @dfn{secondary mark}.  This
4905 mark will say whether the article has been replied to, has been cached,
4906 or has been saved.  @xref{Other Marks}.
4907
4908 @item i
4909 Score as a number (@pxref{Scoring}).
4910 @item z
4911 @vindex gnus-summary-zcore-fuzz
4912 Zcore, @samp{+} if above the default level and @samp{-} if below the
4913 default level.  If the difference between
4914 @code{gnus-summary-default-score} and the score is less than
4915 @code{gnus-summary-zcore-fuzz}, this spec will not be used.
4916 @item V
4917 Total thread score.
4918 @item x
4919 @code{Xref}.
4920 @item D
4921 @code{Date}.
4922 @item d
4923 The @code{Date} in @code{DD-MMM} format.
4924 @item o
4925 The @code{Date} in @var{YYYYMMDD}@code{T}@var{HHMMSS} format.
4926 @item M
4927 @code{Message-ID}.
4928 @item r
4929 @code{References}.
4930 @item t
4931 Number of articles in the current sub-thread.  Using this spec will slow
4932 down summary buffer generation somewhat.
4933 @item e
4934 An @samp{=} (@code{gnus-not-empty-thread-mark}) will be displayed if the
4935 article has any children.
4936 @item P
4937 The line number.
4938 @item O
4939 Download mark.
4940 @item *
4941 Desired cursor position (instead of after first colon).
4942 @item &user-date;
4943 Age sensitive date format.  Various date format is defined in