Doc/texinputs/manual.cls

   1 %
   2 % manual.cls for the Python documentation
   3 %
   4
   5 \NeedsTeXFormat{LaTeX2e}[1995/12/01]
   6 \ProvidesClass{manual}
   7              [1998/03/03 Document class (Python manual)]
   8
   9 \RequirePackage{pypaper}
  10
  11 % Change the options here to get a different set of basic options, but only
  12 % if you have to.  Paper and font size should be adjusted in pypaper.sty.
  13 %
  14 \LoadClass[\py@paper,\py@ptsize,twoside,openright]{report}
  15
  16 \setcounter{secnumdepth}{2}
  17
  18 % Optional packages:
  19 %
  20 % If processing of these documents fails at your TeX installation,
  21 % these may be commented out (independently) to make things work.
  22 % These are both supplied with the current version of the teTeX
  23 % distribution.
  24 %
  25 % The "fancyhdr" package makes nicer page footers reasonable to
  26 % implement, and is used to put the chapter and section information in
  27 % the footers.
  28 %
  29 \RequirePackage{fancyhdr}\typeout{Using fancier footers than usual.}
  30
  31
  32 % Required packages:
  33 %
  34 % The "fncychap" package is used to get the nice chapter headers.  The
  35 % .sty file is distributed with Python, so you should not need to disable
  36 % it.  You'd also end up with a mixed page style; uglier than stock LaTeX!
  37 %
  38 \RequirePackage[Bjarne]{fncychap}\typeout{Using fancy chapter headings.}
  39 % Do horizontal rules it this way to match:
  40 \newcommand{\py@doHorizontalRule}{\mghrulefill{\RW}}
  41 %
  42 %
  43 % This gives us all the Python-specific markup that we really want.
  44 % This should come last.  Do not change this.
  45 %
  46 \RequirePackage{python}
  47
  48 % support for module synopsis sections:
  49 \newcommand{\py@ModSynopsisFilename}{\jobname\thechapter.syn}
  50 \let\py@OldChapter=\chapter
  51 \renewcommand{\chapter}{
  52   \py@ProcessModSynopsis
  53   \py@closeModSynopsisFile
  54   \py@OldChapter
  55 }
  56
  57
  58 % Change the title page to look a bit better, and fit in with the
  59 % fncychap ``Bjarne'' style a bit better.
  60 %
  61 \renewcommand{\maketitle}{%
  62   \begin{titlepage}%
  63     \let\footnotesize\small
  64     \let\footnoterule\relax
  65     \py@doHorizontalRule%
  66     \@ifundefined{pdfinfo}{}{
  67       \pdfinfo{
  68         /Author (\@author)
  69         /Title (\@title)
  70       }
  71     }
  72     \begin{flushright}%
  73       {\rm\Huge\py@HeaderFamily \@title \par}%
  74       {\em\LARGE\py@HeaderFamily \py@release \par}
  75       \vfill
  76       {\LARGE\py@HeaderFamily \@author \par}
  77       \vfill\vfill
  78       {\large
  79        \@date \par
  80        \vfill
  81        \py@authoraddress \par
  82       }%
  83     \end{flushright}%\par
  84     \@thanks
  85   \end{titlepage}%
  86   \setcounter{footnote}{0}%
  87   \let\thanks\relax\let\maketitle\relax
  88   \gdef\@thanks{}\gdef\@author{}\gdef\@title{}
  89 }
  90
  91
  92 % Catch the end of the {abstract} environment, but here make sure the
  93 % abstract is followed by a blank page if the 'openright' option is used.
  94 %
  95 \let\py@OldEndAbstract=\endabstract
  96 \renewcommand{\endabstract}{
  97   \if@openright
  98     \ifodd\value{page}
  99       \typeout{Adding blank page after the abstract.}
 100       \vfil\pagebreak
 101     \fi
 102   \fi
 103   \py@OldEndAbstract
 104 }
 105
 106 % This wraps the \tableofcontents macro with all the magic to get the
 107 % spacing right and have the right number of pages if the 'openright'
 108 % option has been used.  This eliminates a fair amount of crud in the
 109 % individual document files.
 110 %
 111 \let\py@OldTableofcontents=\tableofcontents
 112 \renewcommand{\tableofcontents}{%
 113   \setcounter{page}{1}%
 114   \pagebreak%
 115   \pagestyle{plain}%
 116   {%
 117     \parskip = 0mm%
 118     \py@OldTableofcontents%
 119     \if@openright%
 120       \ifodd\value{page}%
 121         \typeout{Adding blank page after the table of contents.}%
 122         \pagebreak\hspace{0pt}%
 123       \fi%
 124     \fi%
 125     \cleardoublepage%
 126   }%
 127   \pagenumbering{arabic}%
 128   \@ifundefined{fancyhf}{}{\pagestyle{normal}}%
 129   \py@doing@page@targetstrue%
 130 }
 131 % This is needed to get the width of the section # area wide enough in the
 132 % library reference.  Doing it here keeps it the same for all the manuals.
 133 %
 134 \renewcommand*\l@section{\@dottedtocline{1}{1.5em}{2.6em}}
 135 \renewcommand*\l@subsection{\@dottedtocline{2}{4.1em}{3.5em}}
 136 \setcounter{tocdepth}{1}
 137
 138
 139 % Fix the theindex environment to add an entry to the Table of
 140 % Contents; this is much nicer than just having to jump to the end of
 141 % the book and flip around, especially with multiple indexes.
 142 %
 143 \let\py@OldTheindex=\theindex
 144 \renewcommand{\theindex}{
 145   \cleardoublepage
 146   \py@OldTheindex
 147   \addcontentsline{toc}{chapter}{\indexname}
 148 }