Commit bbe6068d authored by Fred Drake's avatar Fred Drake

Added \label{} to allow module references.

Added some seealso sections.
parent aa5dba02
...@@ -10,6 +10,7 @@ ...@@ -10,6 +10,7 @@
% %
\section{Built-in Module \sectcode{parser}} \section{Built-in Module \sectcode{parser}}
\label{module-parser}
\bimodindex{parser} \bimodindex{parser}
The \code{parser} module provides an interface to Python's internal The \code{parser} module provides an interface to Python's internal
...@@ -609,9 +610,9 @@ the ``short form'' or the ``long form.'' The short form is used when ...@@ -609,9 +610,9 @@ the ``short form'' or the ``long form.'' The short form is used when
the code block is on the same line as the definition of the code the code block is on the same line as the definition of the code
block, as in block, as in
\bcode\begin{verbatim} \begin{verbatim}
def square(x): "Square an argument."; return x ** 2 def square(x): "Square an argument."; return x ** 2
\end{verbatim}\ecode \end{verbatim}
% %
while the long form uses an indented block and allows nested while the long form uses an indented block and allows nested
definitions: definitions:
...@@ -674,8 +675,20 @@ module. If information is required which is not extracted by the code ...@@ -674,8 +675,20 @@ module. If information is required which is not extracted by the code
of this example, the code may be extended at clearly defined points to of this example, the code may be extended at clearly defined points to
provide additional capabilities. provide additional capabilities.
\begin{seealso}
\seemodule{symbol}%
{useful constants representing internal nodes of the parse tree}
\seemodule{token}%
{useful constants representing leaf nodes of the parse tree and
functions for testing node values}
\end{seealso}
\section{Standard Module \sectcode{symbol}} \section{Standard Module \sectcode{symbol}}
\label{module-symbol}
\stmodindex{symbol} \stmodindex{symbol}
This module provides constants which represent the numeric values of This module provides constants which represent the numeric values of
...@@ -696,8 +709,13 @@ module back to name strings, allowing more human-readable ...@@ -696,8 +709,13 @@ module back to name strings, allowing more human-readable
representation of parse trees to be generated. representation of parse trees to be generated.
\end{datadesc} \end{datadesc}
\begin{seealso}
\seemodule{parser}{second example uses this module}
\end{seealso}
\section{Standard Module \sectcode{token}} \section{Standard Module \sectcode{token}}
\label{module-token}
\stmodindex{token} \stmodindex{token}
This module provides constants which represent the numeric values of This module provides constants which represent the numeric values of
...@@ -731,5 +749,6 @@ Return true for non-terminal token values. ...@@ -731,5 +749,6 @@ Return true for non-terminal token values.
Return true if \var{x} is the marker indicating the end of input. Return true if \var{x} is the marker indicating the end of input.
\end{funcdesc} \end{funcdesc}
%% \begin{seealso}
%% end of file \seemodule{parser}{second example uses this module}
\end{seealso}
...@@ -10,6 +10,7 @@ ...@@ -10,6 +10,7 @@
% %
\section{Built-in Module \sectcode{parser}} \section{Built-in Module \sectcode{parser}}
\label{module-parser}
\bimodindex{parser} \bimodindex{parser}
The \code{parser} module provides an interface to Python's internal The \code{parser} module provides an interface to Python's internal
...@@ -609,9 +610,9 @@ the ``short form'' or the ``long form.'' The short form is used when ...@@ -609,9 +610,9 @@ the ``short form'' or the ``long form.'' The short form is used when
the code block is on the same line as the definition of the code the code block is on the same line as the definition of the code
block, as in block, as in
\bcode\begin{verbatim} \begin{verbatim}
def square(x): "Square an argument."; return x ** 2 def square(x): "Square an argument."; return x ** 2
\end{verbatim}\ecode \end{verbatim}
% %
while the long form uses an indented block and allows nested while the long form uses an indented block and allows nested
definitions: definitions:
...@@ -674,8 +675,20 @@ module. If information is required which is not extracted by the code ...@@ -674,8 +675,20 @@ module. If information is required which is not extracted by the code
of this example, the code may be extended at clearly defined points to of this example, the code may be extended at clearly defined points to
provide additional capabilities. provide additional capabilities.
\begin{seealso}
\seemodule{symbol}%
{useful constants representing internal nodes of the parse tree}
\seemodule{token}%
{useful constants representing leaf nodes of the parse tree and
functions for testing node values}
\end{seealso}
\section{Standard Module \sectcode{symbol}} \section{Standard Module \sectcode{symbol}}
\label{module-symbol}
\stmodindex{symbol} \stmodindex{symbol}
This module provides constants which represent the numeric values of This module provides constants which represent the numeric values of
...@@ -696,8 +709,13 @@ module back to name strings, allowing more human-readable ...@@ -696,8 +709,13 @@ module back to name strings, allowing more human-readable
representation of parse trees to be generated. representation of parse trees to be generated.
\end{datadesc} \end{datadesc}
\begin{seealso}
\seemodule{parser}{second example uses this module}
\end{seealso}
\section{Standard Module \sectcode{token}} \section{Standard Module \sectcode{token}}
\label{module-token}
\stmodindex{token} \stmodindex{token}
This module provides constants which represent the numeric values of This module provides constants which represent the numeric values of
...@@ -731,5 +749,6 @@ Return true for non-terminal token values. ...@@ -731,5 +749,6 @@ Return true for non-terminal token values.
Return true if \var{x} is the marker indicating the end of input. Return true if \var{x} is the marker indicating the end of input.
\end{funcdesc} \end{funcdesc}
%% \begin{seealso}
%% end of file \seemodule{parser}{second example uses this module}
\end{seealso}
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