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.16}
  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 \newcommand{\gnusacronym}[1]{\textit{#1}}
  72 \newcommand{\gnusemail}[1]{\textit{#1}}
  73
  74 \newcommand{\gnusbullet}{{${\bullet}$}}
  75 \newcommand{\gnusdollar}{\$}
  76 \newcommand{\gnusampersand}{\&}
  77 \newcommand{\gnuspercent}{\%}
  78 \newcommand{\gnushash}{\#}
  79 \newcommand{\gnushat}{\symbol{"5E}}
  80 \newcommand{\gnusunderline}{\symbol{"5F}}
  81 \newcommand{\gnusnot}{$\neg$}
  82 \newcommand{\gnustilde}{\symbol{"7E}}
  83 \newcommand{\gnusless}{{$<$}}
  84 \newcommand{\gnusgreater}{{$>$}}
  85 \newcommand{\gnusbraceleft}{{$>$}}
  86 \newcommand{\gnusbraceright}{{$>$}}
  87
  88 \newcommand{\gnushead}{\raisebox{-1cm}{\epsfig{figure=ps/gnus-head,height=1cm}}}
  89 \newcommand{\gnusinteresting}{
  90 \marginpar[\mbox{}\hfill\gnushead]{\gnushead}
  91 }
  92
  93 \newcommand{\gnuscleardoublepage}{\ifodd\count0\mbox{}\clearpage\thispagestyle{empty}\mbox{}\clearpage\else\clearpage\fi}
  94
  95 \newcommand{\gnuspagechapter}[1]{
  96 {\mbox{}}
  97 }
  98
  99 \newdimen{\gnusdimen}
 100 \gnusdimen 0pt
 101
 102 \newcommand{\gnuschapter}[2]{
 103 \gnuscleardoublepage
 104 \ifdim \gnusdimen = 0pt\setcounter{page}{1}\pagestyle{gnus}\pagenumbering{arabic} \gnusdimen 1pt\fi
 105 \chapter{#2}
 106 \renewcommand{\gnussectionname}{}
 107 \renewcommand{\gnuschaptername}{#2}
 108 \thispagestyle{empty}
 109 \hspace*{-2cm}
 110 \begin{picture}(500,500)(0,0)
 111 \put(480,350){\makebox(0,0)[tr]{#1}}
 112 \put(40,300){\makebox(500,50)[bl]{{\Huge\bf{#2}}}}
 113 \end{picture}
 114 \clearpage
 115 }
 116
 117 \newcommand{\gnusfigure}[3]{
 118 \begin{figure}
 119 \mbox{}\ifodd\count0\hspace*{-0.8cm}\else\hspace*{-3cm}\fi\begin{picture}(440,#2)
 120 #3
 121 \end{picture}
 122 \caption{#1}
 123 \end{figure}
 124 }
 125
 126 \newcommand{\gnusicon}[1]{
 127 \marginpar[\mbox{}\hfill\raisebox{-1.5cm}{\epsfig{figure=ps/#1-up,height=1.5cm}}]{\raisebox{-1cm}{\epsfig{figure=ps/#1-up,height=1cm}}}
 128 }
 129
 130 \newcommand{\gnuspicon}[1]{
 131 \margindex{\epsfig{figure=#1,width=2cm}}
 132 }
 133
 134 \newcommand{\gnusxface}[2]{
 135 \margindex{\epsfig{figure=#1,width=1cm}\epsfig{figure=#2,width=1cm}}
 136 }
 137
 138 \newcommand{\gnussmiley}[2]{
 139 \margindex{\makebox[2cm]{\hfill\epsfig{figure=#1,width=0.5cm}\hfill\epsfig{figure=#2,width=0.5cm}\hfill}}
 140 }
 141
 142 \newcommand{\gnusitemx}[1]{\mbox{}\vspace*{-\itemsep}\vspace*{-\parsep}\item#1}
 143
 144 \newcommand{\gnussection}[1]{
 145 \renewcommand{\gnussectionname}{#1}
 146 \section{#1}
 147 }
 148
 149 \newenvironment{codelist}%
 150 {\begin{list}{}{
 151 }
 152 }{\end{list}}
 153
 154 \newenvironment{kbdlist}%
 155 {\begin{list}{}{
 156 \labelwidth=0cm
 157 }
 158 }{\end{list}}
 159
 160 \newenvironment{dfnlist}%
 161 {\begin{list}{}{
 162 }
 163 }{\end{list}}
 164
 165 \newenvironment{stronglist}%
 166 {\begin{list}{}{
 167 }
 168 }{\end{list}}
 169
 170 \newenvironment{samplist}%
 171 {\begin{list}{}{
 172 }
 173 }{\end{list}}
 174
 175 \newenvironment{varlist}%
 176 {\begin{list}{}{
 177 }
 178 }{\end{list}}
 179
 180 \newenvironment{emphlist}%
 181 {\begin{list}{}{
 182 }
 183 }{\end{list}}
 184
 185 \newlength\gnusheadtextwidth
 186 \setlength{\gnusheadtextwidth}{\headtextwidth}
 187 \addtolength{\gnusheadtextwidth}{1cm}
 188
 189 \newpagestyle{gnuspreamble}%
 190 {
 191 {
 192 \ifodd\count0
 193 {
 194 \hspace*{-0.23cm}\underline{\makebox[\gnusheadtextwidth]{\mbox{}}\textbf{\hfill\roman{page}}}
 195 }
 196 \else
 197 {
 198 \hspace*{-3.25cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\roman{page}\hfill\mbox{}}}
 199 }
 200 }
 201 \fi
 202 }
 203 }
 204 {
 205 \ifodd\count0
 206 \mbox{} \hfill
 207 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo,height=1cm}}
 208 \else
 209 \raisebox{-0.5cm}{\epsfig{figure=ps/gnus-big-logo,height=1cm}}
 210 \hfill \mbox{}
 211 \fi
 212 }
 213
 214 \newpagestyle{gnusindex}%
 215 {
 216 {
 217 \ifodd\count0
 218 {
 219 \hspace*{-0.23cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\gnuschaptername\hfill\arabic{page}}}}
 220 }
 221 \else
 222 {
 223 \hspace*{-3.25cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\arabic{page}\hfill\gnuschaptername}}}
 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{gnus}%
 239 {
 240 {
 241 \ifodd\count0
 242 {
 243 \makebox[12cm]{\hspace*{3.1cm}\underline{\makebox[\gnusheadtextwidth]{\textbf{\arabic{chapter}.\arabic{section}} \textbf{\gnussectionname\hfill\arabic{page}}}}}
 244 }
 245 \else
 246 {
 247 \makebox[12cm]{\hspace*{-2.95cm}\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 \pagenumbering{roman}
 263 \pagestyle{gnuspreamble}
 264
 265 @end iflatex
 266 @end iftex
 267
 268 @iftex
 269 @iflatex
 270 \begin{titlepage}
 271 {
 272
 273 %\addtolength{\oddsidemargin}{-5cm}
 274 %\addtolength{\evensidemargin}{-5cm}
 275 \parindent=0cm
 276 \addtolength{\textheight}{2cm}
 277
 278 \gnustitle{\gnustitlename}\hfill\gnusversion{\gnusversionname}\\
 279 \rule{15cm}{1mm}\\
 280 \vfill
 281 \hspace*{0cm}\epsfig{figure=ps/gnus-big-logo,height=15cm}
 282 \vfill
 283 \rule{15cm}{1mm}\\
 284 \gnusauthor{by Lars Magne Ingebrigtsen}
 285 \newpage
 286 }
 287
 288 \mbox{}
 289 \vfill
 290
 291 \thispagestyle{empty}
 292
 293 Copyright \copyright{} 1995, 1996, 1997, 1998, 1999, 2000, 2001,
 294 2002, 2003
 295 Free Software Foundation, Inc.
 296
 297
 298 Permission is granted to copy, distribute and/or modify this document
 299 under the terms of the GNU Free Documentation License, Version 1.1 or
 300 any later version published by the Free Software Foundation; with no
 301 Invariant Sections, with the Front-Cover texts being ``A GNU
 302 Manual'', and with the Back-Cover Texts as in (a) below.  A copy of the
 303 license is included in the section entitled ``GNU Free Documentation
 304 License'' in the Emacs manual.
 305
 306 (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
 307 this GNU Manual, like GNU software.  Copies published by the Free
 308 Software Foundation raise funds for GNU development.''
 309
 310 This document is part of a collection distributed under the GNU Free
 311 Documentation License.  If you want to distribute this document
 312 separately from the collection, you can do so by adding a copy of the
 313 license to the document, as described in section 6 of the license.
 314 \newpage
 315 \end{titlepage}
 316 @end iflatex
 317 @end iftex
 318
 319 @ifnottex
 320
 321 This file documents Gnus, the GNU Emacs newsreader.
 322
 323 Copyright (C) 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
 324         Free Software Foundation, Inc.
 325
 326 Permission is granted to copy, distribute and/or modify this document
 327 under the terms of the GNU Free Documentation License, Version 1.1 or
 328 any later version published by the Free Software Foundation; with the
 329 Invariant Sections being none, with the Front-Cover texts being ``A GNU
 330 Manual'', and with the Back-Cover Texts as in (a) below.  A copy of the
 331 license is included in the section entitled ``GNU Free Documentation
 332 License'' in the Emacs manual.
 333
 334 (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
 335 this GNU Manual, like GNU software.  Copies published by the Free
 336 Software Foundation raise funds for GNU development.''
 337
 338 This document is part of a collection distributed under the GNU Free
 339 Documentation License.  If you want to distribute this document
 340 separately from the collection, you can do so by adding a copy of the
 341 license to the document, as described in section 6 of the license.
 342 @end ifnottex
 343
 344 @tex
 345
 346 @titlepage
 347 @title Gnus Manual
 348
 349 @author by Lars Magne Ingebrigtsen
 350 @page
 351
 352 @vskip 0pt plus 1filll
 353 Copyright @copyright{} 1995, 1996, 1997, 1998, 1999, 2000, 2001,
 354 2002, 2003
 355         Free Software Foundation, Inc.
 356
 357 Permission is granted to copy, distribute and/or modify this document