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

2002年7月17日 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