[Python-checkins] python/dist/src/Doc/lib xmldomminidom.tex, 1.8, 1.8.12.1

Wed Mar 31 23:06:55 EST 2004

Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv12534
Modified Files:
 Tag: release23-maint
	xmldomminidom.tex 
Log Message:
- make sure the methods minidom adds to the basic DOM are attributed
 to Node objects in the index (closes SF bug #832251)
- fix a variety of markup nits
Backported from trunk revision 1.9.
Index: xmldomminidom.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/xmldomminidom.tex,v
retrieving revision 1.8
retrieving revision 1.8.12.1
diff -C2 -d -r1.8 -r1.8.12.1
*** xmldomminidom.tex	18 Apr 2003 22:04:34 -0000	1.8
--- xmldomminidom.tex	1 Apr 2004 04:06:52 -0000	1.8.12.1
***************
*** 128,132 ****

! \begin{methoddesc}{unlink}{}
 Break internal references within the DOM so that it will be garbage
 collected on versions of Python without cyclic GC. Even when cyclic
--- 128,132 ----

! \begin{methoddesc}[Node]{unlink}{}
 Break internal references within the DOM so that it will be garbage
 collected on versions of Python without cyclic GC. Even when cyclic
***************
*** 138,160 ****
 \end{methoddesc}

! \begin{methoddesc}{writexml}{writer}
 Write XML to the writer object. The writer should have a
 \method{write()} method which matches that of the file object
 interface.

! \versionadded[To support pretty output, new keyword parameters indent,
! addindent, and newl have been added]{2.1}

! \versionadded[For the \class{Document} node, an additional keyword
 argument encoding can be used to specify the encoding field of the XML
 header]{2.3}
- 
 \end{methoddesc}

! \begin{methoddesc}{toxml}{\optional{encoding}}
 Return the XML that the DOM represents as a string.

- \versionadded[the \var{encoding} argument]{2.3}
- 
 With no argument, the XML header does not specify an encoding, and the
 result is Unicode string if the default encoding cannot represent all
--- 138,157 ----
 \end{methoddesc}

! \begin{methoddesc}[Node]{writexml}{writer}
 Write XML to the writer object. The writer should have a
 \method{write()} method which matches that of the file object
 interface.

! \versionchanged[To support pretty output, new keyword parameters
! \var{indent}, \var{addindent}, and \var{newl} have been added]{2.1}

! \versionchanged[For the \class{Document} node, an additional keyword
 argument encoding can be used to specify the encoding field of the XML
 header]{2.3}
 \end{methoddesc}

! \begin{methoddesc}[Node]{toxml}{\optional{encoding}}
 Return the XML that the DOM represents as a string.

 With no argument, the XML header does not specify an encoding, and the
 result is Unicode string if the default encoding cannot represent all
***************
*** 169,176 ****
 as "utf-8".

 \end{methoddesc}

! \begin{methoddesc}{toprettyxml}{\optional{indent\optional{, newl}}}
! 
 Return a pretty-printed version of the document. \var{indent} specifies
 the indentation string and defaults to a tabulator; \var{newl} specifies
--- 166,173 ----
 as "utf-8".

+ \versionchanged[the \var{encoding} argument was introduced]{2.3}
 \end{methoddesc}

! \begin{methoddesc}[Node]{toprettyxml}{\optional{indent\optional{, newl}}}
 Return a pretty-printed version of the document. \var{indent} specifies
 the indentation string and defaults to a tabulator; \var{newl} specifies
***************
*** 178,184 ****

 \versionadded{2.1}
! 
! \versionadded[the encoding argument; see \method{toxml}]{2.3}
! 
 \end{methoddesc}

--- 175,179 ----

 \versionadded{2.1}
! \versionchanged[the encoding argument; see \method{toxml()}]{2.3}
 \end{methoddesc}

***************
*** 186,190 ****
 \refmodule{xml.dom.minidom}:

! \begin{methoddesc}{cloneNode}{deep}
 Although this method was present in the version of
 \refmodule{xml.dom.minidom} packaged with Python 2.0, it was seriously
--- 181,185 ----
 \refmodule{xml.dom.minidom}:

! \begin{methoddesc}[Node]{cloneNode}{deep}
 Although this method was present in the version of
 \refmodule{xml.dom.minidom} packaged with Python 2.0, it was seriously