Commit 437333a5 authored by Fred Drake's avatar Fred Drake

Add labels to all \section and \subsection headings for use in references.

parent b38b064a
...@@ -38,7 +38,7 @@ distribution, to create or maintain whole documents or sections. ...@@ -38,7 +38,7 @@ distribution, to create or maintain whole documents or sections.
\tableofcontents \tableofcontents
\section{Introduction} \section{Introduction \label{intro}}
Python's documentation has long been considered to be good for a Python's documentation has long been considered to be good for a
free programming language. There are a number of reasons for this, free programming language. There are a number of reasons for this,
...@@ -71,7 +71,7 @@ distribution, to create or maintain whole documents or sections. ...@@ -71,7 +71,7 @@ distribution, to create or maintain whole documents or sections.
discussing future directions for the Python documentation and where discussing future directions for the Python documentation and where
to turn for more information. to turn for more information.
\section{Directory Structure} \section{Directory Structure \label{directories}}
The source distribution for the standard Python documentation The source distribution for the standard Python documentation
contains a large number of directories. While third-party documents contains a large number of directories. While third-party documents
...@@ -153,7 +153,7 @@ distribution, to create or maintain whole documents or sections. ...@@ -153,7 +153,7 @@ distribution, to create or maintain whole documents or sections.
\end{definitions} \end{definitions}
\section{Style Guide} \section{Style Guide \label{style-guide}}
The Python documentation should follow the \citetitle The Python documentation should follow the \citetitle
[http://developer.apple.com/techpubs/macos8/pdf/apple_styleguide00.pdf] [http://developer.apple.com/techpubs/macos8/pdf/apple_styleguide00.pdf]
...@@ -249,7 +249,7 @@ distribution, to create or maintain whole documents or sections. ...@@ -249,7 +249,7 @@ distribution, to create or maintain whole documents or sections.
bulleted lists, and special structures for the document abstract and bulleted lists, and special structures for the document abstract and
indexes. indexes.
\subsection{Syntax} \subsection{Syntax \label{latex-syntax}}
There are some things that an author of Python documentation needs There are some things that an author of Python documentation needs
to know about \LaTeX{} syntax. to know about \LaTeX{} syntax.
...@@ -403,7 +403,7 @@ This \UNIX\ is also followed by a space. ...@@ -403,7 +403,7 @@ This \UNIX\ is also followed by a space.
\end{tableii} \end{tableii}
\subsection{Hierarchical Structure} \subsection{Hierarchical Structure \label{latex-syntax}}
\LaTeX{} expects documents to be arranged in a conventional, \LaTeX{} expects documents to be arranged in a conventional,
hierarchical way, with chapters, sections, sub-sections, hierarchical way, with chapters, sections, sub-sections,
...@@ -470,7 +470,7 @@ This \UNIX\ is also followed by a space. ...@@ -470,7 +470,7 @@ This \UNIX\ is also followed by a space.
single chapter from a larger work. single chapter from a larger work.
\section{Special Markup Constructs} \section{Special Markup Constructs \label{special-constructs}}
The Python document classes define a lot of new environments and The Python document classes define a lot of new environments and
macros. This section contains the reference material for these macros. This section contains the reference material for these
...@@ -637,7 +637,7 @@ This \UNIX\ is also followed by a space. ...@@ -637,7 +637,7 @@ This \UNIX\ is also followed by a space.
\end{envdesc} \end{envdesc}
\subsection{Showing Code Examples} \subsection{Showing Code Examples \label{showing-examples}}
Examples of Python source code or interactive sessions are Examples of Python source code or interactive sessions are
represented as \env{verbatim} environments. This environment represented as \env{verbatim} environments. This environment
...@@ -685,7 +685,7 @@ This \UNIX\ is also followed by a space. ...@@ -685,7 +685,7 @@ This \UNIX\ is also followed by a space.
for more information on this topic. for more information on this topic.
\subsection{Inline Markup} \subsection{Inline Markup \label{inline-markup}}
The macros described in this section are used to mark just about The macros described in this section are used to mark just about
anything interesting in the document text. They may be used in anything interesting in the document text. They may be used in
...@@ -978,7 +978,7 @@ This \UNIX\ is also followed by a space. ...@@ -978,7 +978,7 @@ This \UNIX\ is also followed by a space.
\end{macrodesc} \end{macrodesc}
\subsection{Module-specific Markup} \subsection{Module-specific Markup \label{module-markup}}
The markup described in this section is used to provide information The markup described in this section is used to provide information
about a module being documented. A typical use of this markup about a module being documented. A typical use of this markup
...@@ -1056,7 +1056,7 @@ This \UNIX\ is also followed by a space. ...@@ -1056,7 +1056,7 @@ This \UNIX\ is also followed by a space.
\end{macrodesc} \end{macrodesc}
\subsection{Library-level Markup} \subsection{Library-level Markup \label{library-markup}}
This markup is used when describing a selection of modules. For This markup is used when describing a selection of modules. For
example, the \citetitle[../mac/mac.html]{Macintosh Library example, the \citetitle[../mac/mac.html]{Macintosh Library
...@@ -1073,7 +1073,7 @@ This \UNIX\ is also followed by a space. ...@@ -1073,7 +1073,7 @@ This \UNIX\ is also followed by a space.
\end{macrodesc} \end{macrodesc}
\subsection{Table Markup} \subsection{Table Markup \label{table-markup}}
There are three general-purpose table environments defined which There are three general-purpose table environments defined which
should be used whenever possible. These environments are defined should be used whenever possible. These environments are defined
...@@ -1460,15 +1460,15 @@ This \UNIX\ is also followed by a space. ...@@ -1460,15 +1460,15 @@ This \UNIX\ is also followed by a space.
\end{verbatim} \end{verbatim}
\section{Graphical Interface Components} \section{Graphical Interface Components \label{gui-markup}}
The components of graphical interfaces will be assigned markup, but The components of graphical interfaces will be assigned markup, but
the specifics have not been determined. the specifics have not been determined.
\section{Processing Tools} \section{Processing Tools \label{tools}}
\subsection{External Tools} \subsection{External Tools \label{tools-external}}
Many tools are needed to be able to process the Python Many tools are needed to be able to process the Python
documentation if all supported formats are required. This documentation if all supported formats are required. This
...@@ -1548,7 +1548,7 @@ This \UNIX\ is also followed by a space. ...@@ -1548,7 +1548,7 @@ This \UNIX\ is also followed by a space.
\end{description} \end{description}
\subsection{Internal Tools} \subsection{Internal Tools \label{tools-internal}}
This section describes the various scripts that are used to This section describes the various scripts that are used to
implement various stages of document processing or to orchestrate implement various stages of document processing or to orchestrate
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment