]> granicus.if.org Git - python/commitdiff
Fix/improve markup in whatsnew/2.7.
authorEzio Melotti <ezio.melotti@gmail.com>
Sun, 9 Oct 2011 21:25:47 +0000 (00:25 +0300)
committerEzio Melotti <ezio.melotti@gmail.com>
Sun, 9 Oct 2011 21:25:47 +0000 (00:25 +0300)
Doc/whatsnew/2.7.rst

index 6870da171cb49ce305d70f6b254aa1aab220f5b5..43b859d6ba62d1aeda13c1d7d54bfe6ff70949dc 100644 (file)
@@ -1946,7 +1946,7 @@ The version of the ElementTree library included with Python was updated to
 version 1.3.  Some of the new features are:
 
 * The various parsing functions now take a *parser* keyword argument
-  giving an :class:`XMLParser` instance that will
+  giving an :class:`~xml.etree.ElementTree.XMLParser` instance that will
   be used.  This makes it possible to override the file's internal encoding::
 
     p = ET.XMLParser(encoding='utf-8')
@@ -1958,8 +1958,8 @@ version 1.3.  Some of the new features are:
 
 * ElementTree's code for converting trees to a string has been
   significantly reworked, making it roughly twice as fast in many
-  cases.  The :class:`ElementTree` :meth:`write` and :class:`Element`
-  :meth:`write` methods now have a *method* parameter that can be
+  cases.  The :meth:`ElementTree.write() <xml.etree.ElementTree.ElementTree.write>`
+  and :meth:`Element.write` methods now have a *method* parameter that can be
   "xml" (the default), "html", or "text".  HTML mode will output empty
   elements as ``<empty></empty>`` instead of ``<empty/>``, and text
   mode will skip over elements and only output the text chunks.  If
@@ -1972,11 +1972,12 @@ version 1.3.  Some of the new features are:
   declarations are now output on the root element, not scattered throughout
   the resulting XML.  You can set the default namespace for a tree
   by setting the :attr:`default_namespace` attribute and can
-  register new prefixes with :meth:`register_namespace`.  In XML mode,
+  register new prefixes with :meth:`~xml.etree.ElementTree.register_namespace`.  In XML mode,
   you can use the true/false *xml_declaration* parameter to suppress the
   XML declaration.
 
-* New :class:`Element` method: :meth:`extend` appends the items from a
+* New :class:`~xml.etree.ElementTree.Element` method:
+  :meth:`~xml.etree.ElementTree.Element.extend` appends the items from a
   sequence to the element's children.  Elements themselves behave like
   sequences, so it's easy to move children from one element to
   another::
@@ -1992,13 +1993,15 @@ version 1.3.  Some of the new features are:
     # Outputs <root><item>1</item>...</root>
     print ET.tostring(new)
 
-* New :class:`Element` method: :meth:`iter` yields the children of the
+* New :class:`Element` method:
+  :meth:`~xml.etree.ElementTree.Element.iter` yields the children of the
   element as a generator.  It's also possible to write ``for child in
   elem:`` to loop over an element's children.  The existing method
   :meth:`getiterator` is now deprecated, as is :meth:`getchildren`
   which constructs and returns a list of children.
 
-* New :class:`Element` method: :meth:`itertext` yields all chunks of
+* New :class:`Element` method:
+  :meth:`~xml.etree.ElementTree.Element.itertext` yields all chunks of
   text that are descendants of the element.  For example::
 
     t = ET.XML("""<list>