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

freddrake · freddrake · commit e119c8fc614b · 2000-12-04T22:04:15.000Z
SAX1 code to SAX2, based on bug #123695.
diff --git a/Doc/lib/xmlsaxhandler.tex b/Doc/lib/xmlsaxhandler.tex
@@ -255,6 +255,14 @@ \subsection{ContentHandler Objects \label{content-handler-objects}}
 
   \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}{}
