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