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 77acc3e..bd72fd7 100644
--- a/Doc/lib/xmlsaxhandler.tex
+++ b/Doc/lib/xmlsaxhandler.tex
@@ -255,6 +255,14 @@
\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}{}