]> granicus.if.org Git - python/commitdiff
Add documentation for SGMLParser.handle_decl().
authorFred Drake <fdrake@acm.org>
Fri, 16 Mar 2001 20:39:41 +0000 (20:39 +0000)
committerFred Drake <fdrake@acm.org>
Fri, 16 Mar 2001 20:39:41 +0000 (20:39 +0000)
Doc/lib/libsgmllib.tex

index 9907caafb9054847d7293679ba9240eba9e33312..5fe0c8d4dd8af991210744160819ada5d6b51f28 100644 (file)
@@ -145,6 +145,16 @@ cause this method to be called with the argument \code{'text'}.  The
 default method does nothing.
 \end{methoddesc}
 
+\begin{methoddesc}{handle_decl}{data}
+Method called when an SGML declaration is read by the parser.  In
+practice, the \code{DOCTYPE} declaration is the only thing observed in
+HTML, but the parser does not discriminate among different (or broken)
+declarations.  Internal subsets in a \code{DOCTYPE} declaration are
+not supported.  The \var{data} parameter will be the entire contents
+of the declaration inside the \code{<!}...\code{>} markup.  The
+default implementation does nothing.
+\end{methoddesc}
+
 \begin{methoddesc}{report_unbalanced}{tag}
 This method is called when an end tag is found which does not
 correspond to any open element.