1 \input texinfo @c -*-texinfo-*- -*- coding: iso-latin-1 -*-
10 * Gnus: (gnus). The newsreader Gnus.
15 @setchapternewpage odd
19 \documentclass[twoside,a4paper,openright,11pt]{book}
20 \usepackage[latin1]{inputenc}
21 \usepackage{pagestyle}
29 \newcommand{\gnuschaptername}{}
30 \newcommand{\gnussectionname}{}
32 \newcommand{\gnusbackslash}{/}
34 \newcommand{\gnusxref}[1]{See ``#1'' on page \pageref{#1}}
35 \newcommand{\gnuspxref}[1]{see ``#1'' on page \pageref{#1}}
37 \newcommand{\gnuskindex}[1]{\index{#1}}
38 \newcommand{\gnusindex}[1]{\index{#1}}
40 \newcommand{\gnustt}[1]{{\fontfamily{pfu}\fontsize{10pt}{10}\selectfont #1}}
41 \newcommand{\gnuscode}[1]{\gnustt{#1}}
42 \newcommand{\gnussamp}[1]{``{\fontencoding{OT1}\fontfamily{pfu}\fontsize{10pt}{10}\selectfont #1}''}
43 \newcommand{\gnuslisp}[1]{\gnustt{#1}}
44 \newcommand{\gnuskbd}[1]{`\gnustt{#1}'}
45 \newcommand{\gnusfile}[1]{`\gnustt{#1}'}
46 \newcommand{\gnusdfn}[1]{\textit{#1}}
47 \newcommand{\gnusi}[1]{\textit{#1}}
48 \newcommand{\gnusstrong}[1]{\textbf{#1}}
49 \newcommand{\gnusemph}[1]{\textit{#1}}
50 \newcommand{\gnusvar}[1]{{\fontsize{10pt}{10}\selectfont\textsl{\textsf{#1}}}}
51 \newcommand{\gnussc}[1]{\textsc{#1}}
52 \newcommand{\gnustitle}[1]{{\huge\textbf{#1}}}
53 \newcommand{\gnusauthor}[1]{{\large\textbf{#1}}}
54 \newcommand{\gnusresult}[1]{\gnustt{=> #1}}
56 \newcommand{\gnusbullet}{{${\bullet}$}}
57 \newcommand{\gnusdollar}{\$}
58 \newcommand{\gnusampersand}{\&}
59 \newcommand{\gnuspercent}{\%}
60 \newcommand{\gnushash}{\#}
61 \newcommand{\gnushat}{\symbol{"5E}}
62 \newcommand{\gnusunderline}{\symbol{"5F}}
63 \newcommand{\gnusnot}{$\neg$}
64 \newcommand{\gnustilde}{\symbol{"7E}}
65 \newcommand{\gnusless}{{$<$}}
66 \newcommand{\gnusgreater}{{$>$}}
67 \newcommand{\gnusbraceleft}{{$>$}}
68 \newcommand{\gnusbraceright}{{$>$}}
70 \newcommand{\gnushead}{\raisebox{-1cm}{\epsfig{figure=ps/gnus-head.eps,height=1cm}}}
71 \newcommand{\gnusinteresting}{
72 \marginpar[\mbox{}\hfill\gnushead]{\gnushead}
75 \newcommand{\gnuscleardoublepage}{\ifodd\count0\mbox{}\clearpage\thispagestyle{empty}\mbox{}\clearpage\else\clearpage\fi}
77 \newcommand{\gnuspagechapter}[1]{
84 \newcommand{\gnuschapter}[2]{
86 \ifdim \gnusdimen = 0pt\setcounter{page}{1}\pagestyle{gnus}\pagenumbering{arabic} \gnusdimen 1pt\fi
88 \renewcommand{\gnussectionname}{}
89 \renewcommand{\gnuschaptername}{#2}
92 \begin{picture}(500,500)(0,0)
93 \put(480,350){\makebox(0,0)[tr]{#1}}
94 \put(40,300){\makebox(500,50)[bl]{{\Huge\bf{#2}}}}
99 \newcommand{\gnusfigure}[3]{
101 \mbox{}\ifodd\count0\hspace*{-0.8cm}\else\hspace*{-3cm}\fi\begin{picture}(440,#2)
108 \newcommand{\gnusicon}[1]{
109 \marginpar[\mbox{}\hfill\raisebox{-1.5cm}{\epsfig{figure=tmp/#1-up.ps,height=1.5cm}}]{\raisebox{-1cm}{\epsfig{figure=tmp/#1-up.ps,height=1cm}}}
112 \newcommand{\gnuspicon}[1]{
113 \margindex{\epsfig{figure=#1,width=2cm}}
116 \newcommand{\gnusxface}[2]{
117 \margindex{\epsfig{figure=#1,width=1cm}\epsfig{figure=#2,width=1cm}}
120 \newcommand{\gnussmiley}[2]{
121 \margindex{\makebox[2cm]{\hfill\epsfig{figure=#1,width=0.5cm}\hfill\epsfig{figure=#2,width=0.5cm}\hfill}}
124 \newcommand{\gnusitemx}[1]{\mbox{}\vspace*{-\itemsep}\vspace*{-\parsep}\item#1}
126 \newcommand{\gnussection}[1]{
127 \renewcommand{\gnussectionname}{#1}
131 \newenvironment{codelist}%
136 \newenvironment{kbdlist}%
142 \newenvironment{dfnlist}%
147 \newenvironment{stronglist}%
152 \newenvironment{samplist}%
157 \newenvironment{varlist}%
162 \newenvironment{emphlist}%
167 \newlength\gnusheadtextwidth
168 \setlength{\gnusheadtextwidth}{\headtextwidth}
169 \addtolength{\gnusheadtextwidth}{1cm}
171 \newpagestyle{gnuspreamble}%
176 \hspace*{-0.23cm}\underline{\makebox[\gnusheadtextwidth]{\mbox{}}\textbf{\hfill\roman{page}}}
180 \hspace*{-3.25cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\roman{page}\hfill\mbox{}}}
189 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo.eps,height=1cm}}
191 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo.eps,height=1cm}}
196 \newpagestyle{gnusindex}%
201 \hspace*{-0.23cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\gnuschaptername\hfill\arabic{page}}}}
205 \hspace*{-3.25cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\arabic{page}\hfill\gnuschaptername}}}
213 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo.eps,height=1cm}}
215 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo.eps,height=1cm}}
225 \makebox[12cm]{\hspace*{3.1cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\arabic{chapter}.\arabic{section}} \textbf{\gnussectionname\hfill\arabic{page}}}}}
229 \makebox[12cm]{\hspace*{-2.95cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\arabic{page}\hfill\gnuschaptername}}}}
237 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo.eps,height=1cm}}
239 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo.eps,height=1cm}}
244 \pagenumbering{roman}
245 \pagestyle{gnuspreamble}
255 %\addtolength{\oddsidemargin}{-5cm}
256 %\addtolength{\evensidemargin}{-5cm}
258 \addtolength{\textheight}{2cm}
260 \gnustitle{\gnustitlename}\\
263 \hspace*{0cm}\epsfig{figure=ps/gnus-big-logo.eps,height=15cm}
266 \gnusauthor{by Lars Magne Ingebrigtsen}
273 \thispagestyle{empty}
275 Copyright \copyright{} 1995, 1996, 1997, 1998, 1999, 2000
276 Free Software Foundation, Inc.
279 Permission is granted to copy, distribute and/or modify this document
280 under the terms of the GNU Free Documentation License, Version 1.1 or
281 any later version published by the Free Software Foundation; with no
282 Invariant Sections, with the Front-Cover texts being ``A GNU
283 Manual'', and with the Back-Cover Texts as in (a) below. A copy of the
284 license is included in the section entitled ``GNU Free Documentation
285 License'' in the Emacs manual.
287 (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
288 this GNU Manual, like GNU software. Copies published by the Free
289 Software Foundation raise funds for GNU development.''
291 This document is part of a collection distributed under the GNU Free
292 Documentation License. If you want to distribute this document
293 separately from the collection, you can do so by adding a copy of the
294 license to the document, as described in section 6 of the license.
302 This file documents Gnus, the GNU Emacs newsreader.
304 Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000 Free Software Foundation, Inc.
306 Permission is granted to copy, distribute and/or modify this document
307 under the terms of the GNU Free Documentation License, Version 1.1 or
308 any later version published by the Free Software Foundation; with the
309 Invariant Sections being none, with the Front-Cover texts being ``A GNU
310 Manual'', and with the Back-Cover Texts as in (a) below. A copy of the
311 license is included in the section entitled ``GNU Free Documentation
312 License'' in the Emacs manual.
314 (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
315 this GNU Manual, like GNU software. Copies published by the Free
316 Software Foundation raise funds for GNU development.''
318 This document is part of a collection distributed under the GNU Free
319 Documentation License. If you want to distribute this document
320 separately from the collection, you can do so by adding a copy of the
321 license to the document, as described in section 6 of the license.
329 @author by Lars Magne Ingebrigtsen
332 @vskip 0pt plus 1filll
333 Copyright @copyright{} 1995, 1996, 1997, 1998, 1999, 2000 Free Software Foundation, Inc.
335 Permission is granted to copy, distribute and/or modify this document
336 under the terms of the GNU Free Documentation License, Version 1.1 or
337 any later version published by the Free Software Foundation; with no
338 Invariant Sections, with the Front-Cover texts being ``A GNU
339 Manual'', and with the Back-Cover Texts as in (a) below. A copy of the
340 license is included in the section entitled ``GNU Free Documentation
341 License'' in the Emacs manual.
343 (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
344 this GNU Manual, like GNU software. Copies published by the Free
345 Software Foundation raise funds for GNU development.''
347 This document is part of a collection distributed under the GNU Free
348 Documentation License. If you want to distribute this document
349 separately from the collection, you can do so by adding a copy of the
350 license to the document, as described in section 6 of the license.
359 @top The Gnus Newsreader
363 You can read news (and mail) from within Emacs by using Gnus. The news
364 can be gotten by any nefarious means you can think of---@sc{nntp}, local
365 spool or your mbox file. All at the same time, if you want to push your
368 This manual corresponds to Oort Gnus v0.01.
379 Gnus is the advanced, self-documenting, customizable, extensible
380 unreal-time newsreader for GNU Emacs.
382 Oops. That sounds oddly familiar, so let's start over again to avoid
383 being accused of plagiarism:
385 Gnus is a message-reading laboratory. It will let you look at just
386 about anything as if it were a newsgroup. You can read mail with it,
387 you can browse directories with it, you can @code{ftp} with it---you
388 can even read news with it!
390 Gnus tries to empower people who read news the same way Emacs empowers
391 people who edit text. Gnus sets no limits to what the user should be
392 allowed to do. Users are encouraged to extend Gnus to make it behave
393 like they want it to behave. A program should not control people;
394 people should be empowered to do what they want by using (or abusing)
400 * Starting Up:: Finding news can be a pain.
401 * The Group Buffer:: Selecting, subscribing and killing groups.
402 * The Summary Buffer:: Reading, saving and posting articles.
403 * The Article Buffer:: Displaying and handling articles.
404 * Composing Messages:: Information on sending mail and news.
405 * Select Methods:: Gnus reads all messages from various select methods.
406 * Scoring:: Assigning values to articles.
407 * Various:: General purpose settings.
408 * The End:: Farewell and goodbye.
409 * Appendices:: Terminology, Emacs intro, FAQ, History, Internals.
410 * Index:: Variable, function and concept index.
411 * Key Index:: Key Index.
414 --- The Detailed Node Listing ---
418 * Finding the News:: Choosing a method for getting news.
419 * The First Time:: What does Gnus do the first time you start it?
420 * The Server is Down:: How can I read my mail then?
421 * Slave Gnusae:: You can have more than one Gnus active at a time.
422 * Fetching a Group:: Starting Gnus just to read a group.
423 * New Groups:: What is Gnus supposed to do with new groups?
424 * Startup Files:: Those pesky startup files---@file{.newsrc}.
425 * Auto Save:: Recovering from a crash.
426 * The Active File:: Reading the active file over a slow line Takes Time.
427 * Changing Servers:: You may want to move from one server to another.
428 * Startup Variables:: Other variables you might change.
432 * Checking New Groups:: Determining what groups are new.
433 * Subscription Methods:: What Gnus should do with new groups.
434 * Filtering New Groups:: Making Gnus ignore certain new groups.
438 * Group Buffer Format:: Information listed and how you can change it.
439 * Group Maneuvering:: Commands for moving in the group buffer.
440 * Selecting a Group:: Actually reading news.
441 * Group Data:: Changing the info for a group.
442 * Subscription Commands:: Unsubscribing, killing, subscribing.
443 * Group Levels:: Levels? What are those, then?
444 * Group Score:: A mechanism for finding out what groups you like.
445 * Marking Groups:: You can mark groups for later processing.
446 * Foreign Groups:: Creating and editing groups.
447 * Group Parameters:: Each group may have different parameters set.
448 * Listing Groups:: Gnus can list various subsets of the groups.
449 * Sorting Groups:: Re-arrange the group order.
450 * Group Maintenance:: Maintaining a tidy @file{.newsrc} file.
451 * Browse Foreign Server:: You can browse a server. See what it has to offer.
452 * Exiting Gnus:: Stop reading news and get some work done.
453 * Group Topics:: A folding gr