[Python-checkins] python/dist/src/Doc/lib libpyexpat.tex,1.18,1.19

fdrake@users.sourceforge.net fdrake@users.sourceforge.net
Wed, 17 Jul 2002 13:31:54 -0700


Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv10989

Modified Files:
	libpyexpat.tex 
Log Message:
Added documentation for the buffer_text and related attributes of the
xmlparser object provided by pyexpat, new in Python 2.3.


Index: libpyexpat.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libpyexpat.tex,v
retrieving revision 1.18
retrieving revision 1.19
diff -C2 -d -r1.18 -r1.19
*** libpyexpat.tex	20 Jun 2002 21:06:03 -0000	1.18
--- libpyexpat.tex	17 Jul 2002 20:31:52 -0000	1.19
***************
*** 160,163 ****
--- 160,186 ----
  \class{xmlparser} objects have the following attributes:
  
+ \begin{memberdesc}[xmlparser]{buffer_size}
+ The size of the buffer used when \member{buffer_text} is true.  This
+ value cannot be changed at this time.
+ \versionadded{2.3}
+ \end{memberdesc}
+ 
+ \begin{memberdesc}[xmlparser]{buffer_text}
+ Setting this to true causes the \class{xmlparser} object to buffer
+ textual content returned by Expat to avoid multiple calls to the
+ \method{CharacterDataHandler()} callback whenever possible.  This can
+ improve performance substantially since Expat normally breaks
+ character data into chunks at every line ending.  This attribute is
+ false by default, and may be changed at any time.
+ \versionadded{2.3}
+ \end{memberdesc}
+ 
+ \begin{memberdesc}[xmlparser]{buffer_used}
+ If \member{buffer_text} is enabled, the number of bytes stored in the
+ buffer.  These bytes represent UTF-8 encoded text.  This attribute has
+ no meaningful interpretation when \member{buffer_text} is false.
+ \versionadded{2.3}
+ \end{memberdesc}
+ 
  \begin{memberdesc}[xmlparser]{ordered_attributes}
  Setting this attribute to a non-zero integer causes the attributes to