From: Georg Brandl <georg@python.org>
Date: Sun, 1 Aug 2010 21:09:54 +0000 (+0000)
Subject: Merged revisions 83223 via svnmerge from
X-Git-Tag: v3.1.3rc1~427
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=feb4c880143e5478d73356e827b32ec973b10f07;p=thirdparty%2FPython%2Fcpython.git

Merged revisions 83223 via svnmerge from
svn+ssh://svn.python.org/python/branches/py3k

........
  r83223 | georg.brandl | 2010-07-29 15:38:37 +0200 (Do, 29 Jul 2010) | 1 line

  #3874: document HTMLParser.unknown_decl().
........
---

diff --git a/Doc/library/html.parser.rst b/Doc/library/html.parser.rst
index ef0ae83acfc3..c38cf2a9dfb6 100644
--- a/Doc/library/html.parser.rst
+++ b/Doc/library/html.parser.rst
@@ -134,10 +134,18 @@ An exception is defined as well:
 
 .. method:: HTMLParser.handle_decl(decl)
 
-   Method called when an SGML declaration is read by the parser.  The *decl*
-   parameter will be the entire contents of the declaration inside the ``<!``...\
-   ``>`` markup.  It is intended to be overridden by a derived class; the base
-   class implementation does nothing.
+   Method called when an SGML ``doctype`` declaration is read by the parser.
+   The *decl* parameter will be the entire contents of the declaration inside
+   the ``<!...>`` markup.  It is intended to be overridden by a derived class;
+   the base class implementation does nothing.
+
+
+.. method:: HTMLParser.unknown_decl(data)
+
+   Method called when an unrecognized SGML declaration is read by the parser.
+   The *data* parameter will be the entire contents of the declaration inside
+   the ``<!...>`` markup.  It is sometimes useful to be be overridden by a
+   derived class; the base class implementation throws an :exc:`HTMLParseError`.
 
 
 .. method:: HTMLParser.handle_pi(data)