cgit.sxemacs.org Git - gnus/blob - texi/gnus.texi

   1 \input texinfo
   2
   3 @setfilename gnus
   4 @settitle Gnus Manual
   5 @synindex fn cp
   6 @synindex vr cp
   7 @synindex pg cp
   8 @dircategory Emacs
   9 @direntry
  10 * Gnus: (gnus).         The newsreader Gnus.
  11 @end direntry
  12 @iftex
  13 @finalout
  14 @end iftex
  15 @setchapternewpage odd
  16
  17 @iftex
  18 @iflatex
  19 \documentclass[twoside,a4paper,openright,11pt]{book}
  20 \usepackage[latin1]{inputenc}
  21 \usepackage{pagestyle}
  22 \usepackage{epsfig}
  23 \usepackage{pixidx}
  24 \input{gnusconfig.tex}
  25
  26 \ifx\pdfoutput\undefined
  27 \else
  28 \usepackage[pdftex,bookmarks,colorlinks=true]{hyperref}
  29 \usepackage{thumbpdf}
  30 \pdfcompresslevel=9
  31 \fi
  32
  33 \makeindex
  34 \begin{document}
  35
  36 \newcommand{\gnusversionname}{Oort Gnus v0.07}
  37 \newcommand{\gnuschaptername}{}
  38 \newcommand{\gnussectionname}{}
  39
  40 \newcommand{\gnusbackslash}{/}
  41
  42 \newcommand{\gnusref}[1]{``#1'' on page \pageref{#1}}
  43 \ifx\pdfoutput\undefined
  44 \newcommand{\gnusuref}[1]{\gnustt{#1}}
  45 \else
  46 \newcommand{\gnusuref}[1]{\href{#1}{\gnustt{#1}}}
  47 \fi
  48 \newcommand{\gnusxref}[1]{See ``#1'' on page \pageref{#1}}
  49 \newcommand{\gnuspxref}[1]{see ``#1'' on page \pageref{#1}}
  50
  51 \newcommand{\gnuskindex}[1]{\index{#1}}
  52 \newcommand{\gnusindex}[1]{\index{#1}}
  53
  54 \newcommand{\gnustt}[1]{{\gnusselectttfont{}#1}}
  55 \newcommand{\gnuscode}[1]{\gnustt{#1}}
  56 \newcommand{\gnussamp}[1]{``{\fontencoding{OT1}\gnusselectttfont{}#1}''}
  57 \newcommand{\gnuslisp}[1]{\gnustt{#1}}
  58 \newcommand{\gnuskbd}[1]{`\gnustt{#1}'}
  59 \newcommand{\gnuskey}[1]{`\gnustt{#1}'}
  60 \newcommand{\gnusfile}[1]{`\gnustt{#1}'}
  61 \newcommand{\gnusdfn}[1]{\textit{#1}}
  62 \newcommand{\gnusi}[1]{\textit{#1}}
  63 \newcommand{\gnusstrong}[1]{\textbf{#1}}
  64 \newcommand{\gnusemph}[1]{\textit{#1}}
  65 \newcommand{\gnusvar}[1]{{\fontsize{10pt}{10}\selectfont\textsl{\textsf{#1}}}}
  66 \newcommand{\gnussc}[1]{\textsc{#1}}
  67 \newcommand{\gnustitle}[1]{{\huge\textbf{#1}}}
  68 \newcommand{\gnusversion}[1]{{\small\textit{#1}}}
  69 \newcommand{\gnusauthor}[1]{{\large\textbf{#1}}}
  70 \newcommand{\gnusresult}[1]{\gnustt{=> #1}}
  71
  72 \newcommand{\gnusbullet}{{${\bullet}$}}
  73 \newcommand{\gnusdollar}{\$}
  74 \newcommand{\gnusampersand}{\&}
  75 \newcommand{\gnuspercent}{\%}
  76 \newcommand{\gnushash}{\#}
  77 \newcommand{\gnushat}{\symbol{"5E}}
  78 \newcommand{\gnusunderline}{\symbol{"5F}}
  79 \newcommand{\gnusnot}{$\neg$}
  80 \newcommand{\gnustilde}{\symbol{"7E}}
  81 \newcommand{\gnusless}{{$<$}}
  82 \newcommand{\gnusgreater}{{$>$}}
  83 \newcommand{\gnusbraceleft}{{$>$}}
  84 \newcommand{\gnusbraceright}{{$>$}}
  85
  86 \newcommand{\gnushead}{\raisebox{-1cm}{\epsfig{figure=ps/gnus-head,height=1cm}}}
  87 \newcommand{\gnusinteresting}{
  88 \marginpar[\mbox{}\hfill\gnushead]{\gnushead}
  89 }
  90
  91 \newcommand{\gnuscleardoublepage}{\ifodd\count0\mbox{}\clearpage\thispagestyle{empty}\mbox{}\clearpage\else\clearpage\fi}
  92
  93 \newcommand{\gnuspagechapter}[1]{
  94 {\mbox{}}
  95 }
  96
  97 \newdimen{\gnusdimen}
  98 \gnusdimen 0pt
  99
 100 \newcommand{\gnuschapter}[2]{
 101 \gnuscleardoublepage
 102 \ifdim \gnusdimen = 0pt\setcounter{page}{1}\pagestyle{gnus}\pagenumbering{arabic} \gnusdimen 1pt\fi
 103 \chapter{#2}
 104 \renewcommand{\gnussectionname}{}
 105 \renewcommand{\gnuschaptername}{#2}
 106 \thispagestyle{empty}
 107 \hspace*{-2cm}
 108 \begin{picture}(500,500)(0,0)
 109 \put(480,350){\makebox(0,0)[tr]{#1}}
 110 \put(40,300){\makebox(500,50)[bl]{{\Huge\bf{#2}}}}
 111 \end{picture}
 112 \clearpage
 113 }
 114
 115 \newcommand{\gnusfigure}[3]{
 116 \begin{figure}
 117 \mbox{}\ifodd\count0\hspace*{-0.8cm}\else\hspace*{-3cm}\fi\begin{picture}(440,#2)
 118 #3
 119 \end{picture}
 120 \caption{#1}
 121 \end{figure}
 122 }
 123
 124 \newcommand{\gnusicon}[1]{
 125 \marginpar[\mbox{}\hfill\raisebox{-1.5cm}{\epsfig{figure=ps/#1-up,height=1.5cm}}]{\raisebox{-1cm}{\epsfig{figure=ps/#1-up,height=1cm}}}
 126 }
 127
 128 \newcommand{\gnuspicon}[1]{
 129 \margindex{\epsfig{figure=#1,width=2cm}}
 130 }
 131
 132 \newcommand{\gnusxface}[2]{
 133 \margindex{\epsfig{figure=#1,width=1cm}\epsfig{figure=#2,width=1cm}}
 134 }
 135
 136 \newcommand{\gnussmiley}[2]{
 137 \margindex{\makebox[2cm]{\hfill\epsfig{figure=#1,width=0.5cm}\hfill\epsfig{figure=#2,width=0.5cm}\hfill}}
 138 }
 139
 140 \newcommand{\gnusitemx}[1]{\mbox{}\vspace*{-\itemsep}\vspace*{-\parsep}\item#1}
 141
 142 \newcommand{\gnussection}[1]{
 143 \renewcommand{\gnussectionname}{#1}
 144 \section{#1}
 145 }
 146
 147 \newenvironment{codelist}%
 148 {\begin{list}{}{
 149 }
 150 }{\end{list}}
 151
 152 \newenvironment{kbdlist}%
 153 {\begin{list}{}{
 154 \labelwidth=0cm
 155 }
 156 }{\end{list}}
 157
 158 \newenvironment{dfnlist}%
 159 {\begin{list}{}{
 160 }
 161 }{\end{list}}
 162
 163 \newenvironment{stronglist}%
 164 {\begin{list}{}{
 165 }
 166 }{\end{list}}
 167
 168 \newenvironment{samplist}%
 169 {\begin{list}{}{
 170 }
 171 }{\end{list}}
 172
 173 \newenvironment{varlist}%
 174 {\begin{list}{}{
 175 }
 176 }{\end{list}}
 177
 178 \newenvironment{emphlist}%
 179 {\begin{list}{}{
 180 }
 181 }{\end{list}}
 182
 183 \newlength\gnusheadtextwidth
 184 \setlength{\gnusheadtextwidth}{\headtextwidth}
 185 \addtolength{\gnusheadtextwidth}{1cm}
 186
 187 \newpagestyle{gnuspreamble}%
 188 {
 189 {
 190 \ifodd\count0
 191 {
 192 \hspace*{-0.23cm}\underline{\makebox[\gnusheadtextwidth]{\mbox{}}\textbf{\hfill\roman{page}}}
 193 }
 194 \else
 195 {
 196 \hspace*{-3.25cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\roman{page}\hfill\mbox{}}}
 197 }
 198 }
 199 \fi
 200 }
 201 }
 202 {
 203 \ifodd\count0
 204 \mbox{} \hfill
 205 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo,height=1cm}}
 206 \else
 207 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo,height=1cm}}
 208 \hfill \mbox{}
 209 \fi
 210 }
 211
 212 \newpagestyle{gnusindex}%
 213 {
 214 {
 215 \ifodd\count0
 216 {
 217 \hspace*{-0.23cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\gnuschaptername\hfill\arabic{page}}}}
 218 }
 219 \else
 220 {
 221 \hspace*{-3.25cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\arabic{page}\hfill\gnuschaptername}}}
 222 }
 223 \fi
 224 }
 225 }
 226 {
 227 \ifodd\count0
 228 \mbox{} \hfill
 229 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo,height=1cm}}
 230 \else
 231 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo,height=1cm}}
 232 \hfill \mbox{}
 233 \fi
 234 }
 235
 236 \newpagestyle{gnus}%
 237 {
 238 {
 239 \ifodd\count0
 240 {
 241 \makebox[12cm]{\hspace*{3.1cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\arabic{chapter}.\arabic{section}} \textbf{\gnussectionname\hfill\arabic{page}}}}}
 242 }
 243 \else
 244 {
 245 \makebox[12cm]{\hspace*{-2.95cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\arabic{page}\hfill\gnuschaptername}}}}
 246 }
 247 \fi
 248 }
 249 }
 250 {
 251 \ifodd\count0
 252 \mbox{} \hfill
 253 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo,height=1cm}}
 254 \else
 255 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo,height=1cm}}
 256 \hfill \mbox{}
 257 \fi
 258 }
 259
 260 \pagenumbering{roman}
 261 \pagestyle{gnuspreamble}
 262
 263 @end iflatex
 264 @end iftex
 265
 266 @iftex
 267 @iflatex
 268 \begin{titlepage}
 269 {
 270
 271 %\addtolength{\oddsidemargin}{-5cm}
 272 %\addtolength{\evensidemargin}{-5cm}
 273 \parindent=0cm
 274 \addtolength{\textheight}{2cm}
 275
 276 \gnustitle{\gnustitlename}\hfill\gnusversion{\gnusversionname}\\
 277 \rule{15cm}{1mm}\\
 278 \vfill
 279 \hspace*{0cm}\epsfig{figure=ps/gnus-big-logo,height=15cm}
 280 \vfill
 281 \rule{15cm}{1mm}\\
 282 \gnusauthor{by Lars Magne Ingebrigtsen}
 283 \newpage
 284 }
 285
 286 \mbox{}
 287 \vfill
 288
 289 \thispagestyle{empty}
 290
 291 Copyright \copyright{} 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002
 292 Free Software Foundation, Inc.
 293
 294
 295 Permission is granted to copy, distribute and/or modify this document
 296 under the terms of the GNU Free Documentation License, Version 1.1 or
 297 any later version published by the Free Software Foundation; with no
 298 Invariant Sections, with the Front-Cover texts being ``A GNU
 299 Manual'', and with the Back-Cover Texts as in (a) below.  A copy of the
 300 license is included in the section entitled ``GNU Free Documentation
 301 License'' in the Emacs manual.
 302
 303 (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
 304 this GNU Manual, like GNU software.  Copies published by the Free
 305 Software Foundation raise funds for GNU development.''
 306
 307 This document is part of a collection distributed under the GNU Free
 308 Documentation License.  If you want to distribute this document
 309 separately from the collection, you can do so by adding a copy of the
 310 license to the document, as described in section 6 of the license.
 311 \newpage
 312 \end{titlepage}
 313 @end iflatex
 314 @end iftex
 315
 316 @ifnottex
 317
 318 This file documents Gnus, the GNU Emacs newsreader.
 319
 320 Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002
 321         Free Software Foundation, Inc.
 322
 323 Permission is granted to copy, distribute and/or modify this document
 324 under the terms of the GNU Free Documentation License, Version 1.1 or
 325 any later version published by the Free Software Foundation; with the
 326 Invariant Sections being none, with the Front-Cover texts being ``A GNU
 327 Manual'', and with the Back-Cover Texts as in (a) below.  A copy of the
 328 license is included in the section entitled ``GNU Free Documentation
 329 License'' in the Emacs manual.
 330
 331 (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
 332 this GNU Manual, like GNU software.  Copies published by the Free
 333 Software Foundation raise funds for GNU development.''
 334
 335 This document is part of a collection distributed under the GNU Free
 336 Documentation License.  If you want to distribute this document
 337 separately from the collection, you can do so by adding a copy of the
 338 license to the document, as described in section 6 of the license.
 339 @end ifnottex
 340
 341 @tex
 342
 343 @titlepage
 344 @title Gnus Manual
 345
 346 @author by Lars Magne Ingebrigtsen
 347 @page
 348
 349 @vskip 0pt plus 1filll
 350 Copyright @copyright{} 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002
 351         Free Software Foundation, Inc.
 352
 353 Permission is granted to copy, distribute and/or modify this document
 354 under the terms of the GNU Free Documentation License, Version 1.1 or
 355 any later version published by the Free Software Foundation; with no
 356 Invariant Sections, with the Front-Cover texts being ``A GNU
 357 Manual'', and with the Back-Cover Texts as in (a) below.  A copy of the
 358 license is included in the section entitled ``GNU Free Documentation
 359 License'' in the Emacs manual.
 360
 361 (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
 362 this GNU Manual, like GNU software.  Copies published by the Free
 363 Software Foundation raise funds for GNU development.''
 364
 365 This document is part of a collection distributed under the GNU Free
 366 Documentation License.  If you want to distribute this document
 367 separately from the collection, you can do so by adding a copy of the
 368 license to the document, as described in section 6 of the license.
 369
 370 @end titlepage
 371 @page
 372
 373 @end tex
 374
 375
 376 @node Top
 377 @top The Gnus Newsreader
 378
 379 @ifinfo
 380
 381 You can read news (and mail) from within Emacs by using Gnus.  The news
 382 can be gotten by any nefarious means you can think of---@sc{nntp}, local
 383 spool or your mbox file.  All at the same time, if you want to push your
 384 luck.
 385
 386 This manual corresponds to Oort Gnus v0.07.
 387
 388 @end ifinfo
 389
 390 @iftex
 391
 392 @iflatex
 393 \tableofcontents
 394 \gnuscleardoublepage
 395 @end iflatex
 396
 397 Gnus is the advanced, self-documenting, customizable, extensible
 398 unreal-time newsreader for GNU Emacs.
 399
 400 Oops.  That sounds oddly familiar, so let's start over again to avoid
 401 being accused of plagiarism:
 402
 403 Gnus is a message-reading laboratory.  It will let you look at just
 404 about anything as if it were a newsgroup.  You can read mail with it,
 405 you can browse directories with it, you can @code{ftp} with it---you
 406 can even read news with it!
 407
 408 Gnus tries to empower people who read news the same way Emacs empowers
 409 people who edit text.  Gnus sets no limits to what the user should be
 410 allowed to do.  Users are encouraged to extend Gnus to make it behave
 411 like they want it to behave.  A program should not control people;
 412 people should be empowered to do what they want by using (or abusing)
 413 the program.
 414
 415 @end iftex
 416
 417 @menu
 418 * Starting Up::                 Finding news can be a pain.
 419 * Group Buffer::                Selecting, subscribing and killing groups.
 420 * Summary Buffer::              Reading, saving and posting articles.
 421 * Article Buffer::              Displaying and handling articles.
 422 * Composing Messages::          Information on sending mail and news.
 423 * Select Methods::              Gnus reads all messages from various select methods.