summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1996-07-21 02:21:31 (GMT)
committerGuido van Rossum <guido@python.org>1996-07-21 02:21:31 (GMT)
commited43073e0073be0c12634f17499a6fe5e48742aa (patch)
tree67daf0d83c77f33de6afa4445473709fe4105a75 /Doc
parent66774a973babca294045b3e8162db1f13c2d50de (diff)
downloadcpython-ed43073e0073be0c12634f17499a6fe5e48742aa.zip
cpython-ed43073e0073be0c12634f17499a6fe5e48742aa.tar.gz
cpython-ed43073e0073be0c12634f17499a6fe5e48742aa.tar.bz2
Minute changes by Fred Drake
Diffstat (limited to 'Doc')
-rw-r--r--Doc/lib/libparser.tex42
-rw-r--r--Doc/libparser.tex42
2 files changed, 4 insertions, 80 deletions
diff --git a/Doc/lib/libparser.tex b/Doc/lib/libparser.tex
index 1f5d4fd..130ae95 100644
--- a/Doc/lib/libparser.tex
+++ b/Doc/lib/libparser.tex
@@ -72,38 +72,14 @@ application to amortize the cost of processing complex parse trees, to
provide a parse tree representation which conserves memory space when
compared to the Python tuple representation, and to ease the creation
of additional modules in C which manipulate parse trees. A simple
-``wrapper'' module may be created in Python if desired to hide the use
-of AST objects.
+``wrapper'' module may be created in Python to hide the use of AST
+objects.
-% ==== 3. ====
-% List the public functions defined by the module. Begin with a
-% standard phrase. You may also list the exceptions and other data
-% items defined in the module, insofar as they are important for the
-% user.
-
The \code{parser} module defines the following functions:
-% ---- 3.1. ----
-% Redefine the ``indexsubitem'' macro to point to this module
-% (alternatively, you can put this at the top of the file):
-
\renewcommand{\indexsubitem}{(in module parser)}
-% ---- 3.2. ----
-% For each function, use a ``funcdesc'' block. This has exactly two
-% parameters (each parameters is contained in a set of curly braces):
-% the first parameter is the function name (this automatically
-% generates an index entry); the second parameter is the function's
-% argument list. If there are no arguments, use an empty pair of
-% curly braces. If there is more than one argument, separate the
-% arguments with backslash-comma. Optional parts of the parameter
-% list are contained in \optional{...} (this generates a set of square
-% brackets around its parameter). Arguments are automatically set in
-% italics in the parameter list. Each argument should be mentioned at
-% least once in the description; each usage (even inside \code{...})
-% should be enclosed in \var{...}.
-
\begin{funcdesc}{ast2tuple}{ast}
This function accepts an AST object from the caller in
\code{\var{ast}} and returns a Python tuple representing the
@@ -178,10 +154,6 @@ exception).
\end{funcdesc}
-% --- 3.4. ---
-% Exceptions are described using a ``excdesc'' block. This has only
-% one parameter: the exception name.
-
\subsection{Exceptions and Error Handling}
The parser module defines a single exception, but may also pass other
@@ -209,16 +181,6 @@ exceptions \code{MemoryError}, \code{OverflowError},
exceptions carry all the meaning normally associated with them. Refer
to the descriptions of each function for detailed information.
-% ---- 3.5. ----
-% There is no standard block type for classes. I generally use
-% ``funcdesc'' blocks, since class instantiation looks very much like
-% a function call.
-
-
-% ==== 4. ====
-% Now is probably a good time for a complete example. (Alternatively,
-% an example giving the flavor of the module may be given before the
-% detailed list of functions.)
\subsection{Example}
diff --git a/Doc/libparser.tex b/Doc/libparser.tex
index 1f5d4fd..130ae95 100644
--- a/Doc/libparser.tex
+++ b/Doc/libparser.tex
@@ -72,38 +72,14 @@ application to amortize the cost of processing complex parse trees, to
provide a parse tree representation which conserves memory space when
compared to the Python tuple representation, and to ease the creation
of additional modules in C which manipulate parse trees. A simple
-``wrapper'' module may be created in Python if desired to hide the use
-of AST objects.
+``wrapper'' module may be created in Python to hide the use of AST
+objects.
-% ==== 3. ====
-% List the public functions defined by the module. Begin with a
-% standard phrase. You may also list the exceptions and other data
-% items defined in the module, insofar as they are important for the
-% user.
-
The \code{parser} module defines the following functions:
-% ---- 3.1. ----
-% Redefine the ``indexsubitem'' macro to point to this module
-% (alternatively, you can put this at the top of the file):
-
\renewcommand{\indexsubitem}{(in module parser)}
-% ---- 3.2. ----
-% For each function, use a ``funcdesc'' block. This has exactly two
-% parameters (each parameters is contained in a set of curly braces):
-% the first parameter is the function name (this automatically
-% generates an index entry); the second parameter is the function's
-% argument list. If there are no arguments, use an empty pair of
-% curly braces. If there is more than one argument, separate the
-% arguments with backslash-comma. Optional parts of the parameter
-% list are contained in \optional{...} (this generates a set of square
-% brackets around its parameter). Arguments are automatically set in
-% italics in the parameter list. Each argument should be mentioned at
-% least once in the description; each usage (even inside \code{...})
-% should be enclosed in \var{...}.
-
\begin{funcdesc}{ast2tuple}{ast}
This function accepts an AST object from the caller in
\code{\var{ast}} and returns a Python tuple representing the
@@ -178,10 +154,6 @@ exception).
\end{funcdesc}
-% --- 3.4. ---
-% Exceptions are described using a ``excdesc'' block. This has only
-% one parameter: the exception name.
-
\subsection{Exceptions and Error Handling}
The parser module defines a single exception, but may also pass other
@@ -209,16 +181,6 @@ exceptions \code{MemoryError}, \code{OverflowError},
exceptions carry all the meaning normally associated with them. Refer
to the descriptions of each function for detailed information.
-% ---- 3.5. ----
-% There is no standard block type for classes. I generally use
-% ``funcdesc'' blocks, since class instantiation looks very much like
-% a function call.
-
-
-% ==== 4. ====
-% Now is probably a good time for a complete example. (Alternatively,
-% an example giving the flavor of the module may be given before the
-% detailed list of functions.)
\subsection{Example}