sphinx / sphinx / texinputs / manual.cls

Full commit
% manual.cls for Sphinx

\ProvidesClass{manual}[1998/03/03 Document class (Python manual)]


% Pass all given class options to the parent class.


% Optional packages:
% If processing of these documents fails at your TeX installation,
% these may be commented out (independently) to make things work.
% These are both supplied with the current version of the teTeX
% distribution.
% The "fancyhdr" package makes nicer page footers reasonable to
% implement, and is used to put the chapter and section information in 
% the footers.

% Required packages:
% The "fncychap" package is used to get the nice chapter headers.  The
% .sty file is distributed with Sphinx, so you should not need to disable
% it.  You'd also end up with a mixed page style; uglier than stock LaTeX!
% Do horizontal rules it this way to match:

% This gives us all the Sphinx-specific markup that we really want.
% This should come last.  Do not change this.

% This comes after sphinx.sty because it otherwise defines its own
% "seealso" command.

% Support for module synopsis sections:

% Change the title page to look a bit better, and fit in with the
% fncychap ``Bjarne'' style a bit better.
      % This \def is required to deal with multi-line authors; it
      % changes \\ to ', ' (comma-space), making it pass muster for
      % generating document info in the PDF file.
      \def\\{, }
        /Author (\@author)
        /Title (\@title)
      {\rm\Huge\py@HeaderFamily \@title \par}%
      {\em\LARGE\py@HeaderFamily \py@release\releaseinfo \par}
      {\LARGE\py@HeaderFamily \@author \par}
       \@date \par
       \py@authoraddress \par

% Catch the end of the {abstract} environment, but here make sure the
% abstract is followed by a blank page if the 'openright' option is used.
      \typeout{Adding blank page after the abstract.}

% This wraps the \tableofcontents macro with all the magic to get the
% spacing right and have the right number of pages if the 'openright'
% option has been used.  This eliminates a fair amount of crud in the
% individual document files.
    \parskip = 0mm%
        \typeout{Adding blank page after the table of contents.}%
% This is needed to get the width of the section # area wide enough in the
% library reference.  Doing it here keeps it the same for all the manuals.

% Fix the theindex environment to add an entry to the Table of
% Contents; this is much nicer than just having to jump to the end of
% the book and flip around, especially with multiple indexes.