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