Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

- fix module name in links in formatted documentation 

- minor markup cleanup
This commit is contained in:
Fred Drake 2006-09-15 14:14:55 +00:00
parent 77aad9a09b
commit 2e63dbe9ac
1 changed files with 14 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
Doc/lib/libetree.tex
View File

@ -1,45 +1,34 @@
\section{\module{elementtree} --- The xml.etree.ElementTree Module} \section{\module{xml.etree.ElementTree} --- The ElementTree XML API}
\declaremodule{standard}{xml.etree.elementtree} \declaremodule{standard}{xml.etree.ElementTree}
\moduleauthor{Fredrik Lundh}{fredrik@pythonware.com} \moduleauthor{Fredrik Lundh}{fredrik@pythonware.com}
\modulesynopsis{This module provides implementations \modulesynopsis{Implementation of the ElementTree API.}
of the Element and ElementTree types, plus support classes.
A C version of this API is available as xml.etree.cElementTree.}
\versionadded{2.5} \versionadded{2.5}
\subsection{Overview\label{elementtree-overview}}
The Element type is a flexible container object, designed to store The Element type is a flexible container object, designed to store
hierarchical data structures in memory. The type can be described as a hierarchical data structures in memory. The type can be described as a
cross between a list and a dictionary. cross between a list and a dictionary.
Each element has a number of properties associated with it: Each element has a number of properties associated with it:
\begin{itemize} \begin{itemize}
\item {} \item a tag which is a string identifying what kind of data
a tag which is a string identifying what kind of data this element represents (the element type, in other words).
this element represents (the element type, in other words). \item a number of attributes, stored in a Python dictionary.
\item a text string.
\item {} \item an optional tail string.
a number of attributes, stored in a Python dictionary. \item a number of child elements, stored in a Python sequence
\item {}
a text string.
\item {}
an optional tail string.
\item {}
a number of child elements, stored in a Python sequence
\end{itemize} \end{itemize}
To create an element instance, use the Element or SubElement factory To create an element instance, use the Element or SubElement factory
functions. functions.
The ElementTree class can be used to wrap an element The \class{ElementTree} class can be used to wrap an element
structure, and convert it from and to XML. structure, and convert it from and to XML.
A C implementation of this API is available as
\module{xml.etree.cElementTree}.
\subsection{Functions\label{elementtree-functions}} \subsection{Functions\label{elementtree-functions}}