From: Fred Drake <fdrake@acm.org>
Date: Mon, 4 Dec 2000 22:04:15 +0000 (+0000)
Subject: Added a comment for ContentHandler.characters() explaining how to migrate
X-Git-Tag: v2.1a1~664
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=e119c8fc614b25034ae45e876d5075597a7e2b67;p=python

Added a comment for ContentHandler.characters() explaining how to migrate
SAX1 code to SAX2, based on bug #123695.
---

diff --git a/Doc/lib/xmlsaxhandler.tex b/Doc/lib/xmlsaxhandler.tex
index 77acc3e502..bd72fd7709 100644
--- a/Doc/lib/xmlsaxhandler.tex
+++ b/Doc/lib/xmlsaxhandler.tex
@@ -255,6 +255,14 @@ appropriate events in the input document:
 
   \var{content} may be a Unicode string or a byte string; the
   \code{expat} reader module produces always Unicode strings.
+
+  \strong{Note:}  The earlier SAX 1 interface provided by the Python
+  XML Special Interest Group used a more Java-like interface for this
+  method.  Since most parsers used from Python did not take advatage
+  of the older interface, the simpler signature was chosen to replace
+  it.  To convert old code to the new interface, use \var{content}
+  instead of slicing content with the old \var{offset} and
+  \var{lenght} parameters.
 \end{methoddesc}
 
 \begin{methoddesc}[ContentHandler]{ignorableWhitespace}{}