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

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