summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libsgmllib.tex
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>1999-04-22 18:25:47 (GMT)
committerFred Drake <fdrake@acm.org>1999-04-22 18:25:47 (GMT)
commit4e28c593ade542efc6877a1e0e05f3ee965fd58b (patch)
tree28f85c1e51c9b7a210831dde73bb3d9a829cfb79 /Doc/lib/libsgmllib.tex
parentb7168c3a07e910c33238a3c17671c92c10146817 (diff)
downloadcpython-4e28c593ade542efc6877a1e0e05f3ee965fd58b.zip
cpython-4e28c593ade542efc6877a1e0e05f3ee965fd58b.tar.gz
cpython-4e28c593ade542efc6877a1e0e05f3ee965fd58b.tar.bz2
Markup nits.
Make module references hyperlinks.
Diffstat (limited to 'Doc/lib/libsgmllib.tex')
-rw-r--r--Doc/lib/libsgmllib.tex60
1 files changed, 30 insertions, 30 deletions
diff --git a/Doc/lib/libsgmllib.tex b/Doc/lib/libsgmllib.tex
index a8dfa0b..e441c12 100644
--- a/Doc/lib/libsgmllib.tex
+++ b/Doc/lib/libsgmllib.tex
@@ -1,7 +1,7 @@
\section{\module{sgmllib} ---
- Simple SGML parser.}
-\declaremodule{standard}{sgmllib}
+ Simple SGML parser}
+\declaremodule{standard}{sgmllib}
\modulesynopsis{Only as much of an SGML parser as needed to parse HTML.}
\index{SGML}
@@ -10,7 +10,7 @@ This module defines a class \class{SGMLParser} which serves as the
basis for parsing text files formatted in SGML (Standard Generalized
Mark-up Language). In fact, it does not provide a full SGML parser
--- it only parses SGML insofar as it is used by HTML, and the module
-only exists as a base for the \module{htmllib}\refstmodindex{htmllib}
+only exists as a base for the \refmodule{htmllib}\refstmodindex{htmllib}
module.
@@ -49,8 +49,8 @@ implicitly at instantiation time.
\begin{methoddesc}{setnomoretags}{}
Stop processing tags. Treat all following input as literal input
-(CDATA). (This is only provided so the HTML tag \code{<PLAINTEXT>}
-can be implemented.)
+(CDATA). (This is only provided so the HTML tag
+\code{<PLAINTEXT>} can be implemented.)
\end{methoddesc}
\begin{methoddesc}{setliteral}{}
@@ -72,15 +72,15 @@ redefined version should always call \method{close()}.
\begin{methoddesc}{handle_starttag}{tag, method, attributes}
This method is called to handle start tags for which either a
-\code{start_\var{tag}()} or \code{do_\var{tag}()} method has been
+\method{start_\var{tag}()} or \method{do_\var{tag}()} method has been
defined. The \var{tag} argument is the name of the tag converted to
lower case, and the \var{method} argument is the bound method which
should be used to support semantic interpretation of the start tag.
-The \var{attributes} argument is a list of \code{(\var{name}, \var{value})}
-pairs containing the attributes found inside the tag's \code{<>}
-brackets. The \var{name} has been translated to lower case and double
-quotes and backslashes in the \var{value} have been interpreted. For
-instance, for the tag \code{<A HREF="http://www.cwi.nl/">}, this
+The \var{attributes} argument is a list of \code{(\var{name},
+\var{value})} pairs containing the attributes found inside the tag's
+\code{<>} brackets. The \var{name} has been translated to lower case
+and double quotes and backslashes in the \var{value} have been interpreted.
+For instance, for the tag \code{<A HREF="http://www.cwi.nl/">}, this
method would be called as \samp{unknown_starttag('a', [('href',
'http://www.cwi.nl/')])}. The base implementation simply calls
\var{method} with \var{attributes} as the only argument.
@@ -88,11 +88,11 @@ method would be called as \samp{unknown_starttag('a', [('href',
\begin{methoddesc}{handle_endtag}{tag, method}
This method is called to handle endtags for which an
-\code{end_\var{tag}()} method has been defined. The \var{tag}
-argument is the name of the tag converted to lower case, and the
-\var{method} argument is the bound method which should be used to
+\method{end_\var{tag}()} method has been defined. The
+\var{tag} argument is the name of the tag converted to lower case, and
+the \var{method} argument is the bound method which should be used to
support semantic interpretation of the end tag. If no
-\code{end_\var{tag}()} method is defined for the closing element,
+\method{end_\var{tag}()} method is defined for the closing element,
this handler is not called. The base implementation simply calls
\var{method}.
\end{methoddesc}
@@ -120,12 +120,12 @@ This method is called to process a general entity reference of the
form \samp{\&\var{ref};} where \var{ref} is an general entity
reference. It looks for \var{ref} in the instance (or class)
variable \member{entitydefs} which should be a mapping from entity
-names to corresponding translations.
-If a translation is found, it calls the method \method{handle_data()}
-with the translation; otherwise, it calls the method
-\code{unknown_entityref(\var{ref})}. The default \member{entitydefs}
-defines translations for \code{\&amp;}, \code{\&apos}, \code{\&gt;},
-\code{\&lt;}, and \code{\&quot;}.
+names to corresponding translations. If a translation is found, it
+calls the method \method{handle_data()} with the translation;
+otherwise, it calls the method \code{unknown_entityref(\var{ref})}.
+The default \member{entitydefs} defines translations for
+\code{\&amp;}, \code{\&apos}, \code{\&gt;}, \code{\&lt;}, and
+\code{\&quot;}.
\end{methoddesc}
\begin{methoddesc}{handle_comment}{comment}
@@ -175,8 +175,8 @@ case:
\begin{methoddescni}{start_\var{tag}}{attributes}
This method is called to process an opening tag \var{tag}. It has
-preference over \code{do_\var{tag}()}. The \var{attributes}
-argument has the same meaning as described for
+preference over \method{do_\var{tag}()}. The
+\var{attributes} argument has the same meaning as described for
\method{handle_starttag()} above.
\end{methoddescni}
@@ -192,10 +192,10 @@ This method is called to process a closing tag \var{tag}.
Note that the parser maintains a stack of open elements for which no
end tag has been found yet. Only tags processed by
-\code{start_\var{tag}()} are pushed on this stack. Definition of an
-\code{end_\var{tag}()} method is optional for these tags. For tags
-processed by \code{do_\var{tag}()} or by \method{unknown_tag()}, no
-\code{end_\var{tag}()} method must be defined; if defined, it will not
-be used. If both \code{start_\var{tag}()} and \code{do_\var{tag}()}
-methods exist for a tag, the \code{start_\var{tag}()} method takes
-precedence.
+\method{start_\var{tag}()} are pushed on this stack. Definition of an
+\method{end_\var{tag}()} method is optional for these tags. For tags
+processed by \method{do_\var{tag}()} or by \method{unknown_tag()}, no
+\method{end_\var{tag}()} method must be defined; if defined, it will
+not be used. If both \method{start_\var{tag}()} and
+\method{do_\var{tag}()} methods exist for a tag, the
+\method{start_\var{tag}()} method takes precedence.