Added a comment for ContentHandler.characters() explaining how to migrate

SAX1 code to SAX2, based on bug #123695.

1 files changed, 8 insertions, 0 deletions

diff --git a/Doc/lib/xmlsaxhandler.tex b/Doc/lib/xmlsaxhandler.tex
index 77acc3e..bd72fd7 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}{}