Describe the default_namespace parameter of ElemetTree.write.
authorSerhiy Storchaka <storchaka@gmail.com>
Sun, 13 Jan 2013 19:58:04 +0000 (21:58 +0200)
committerSerhiy Storchaka <storchaka@gmail.com>
Sun, 13 Jan 2013 19:58:04 +0000 (21:58 +0200)
Doc/library/xml.etree.elementtree.rst
Lib/xml/etree/ElementTree.py

index c5c880290c8dacc2fdc0cf3652b1b1c92603aab6..d9b0a520ef3a6ce5a8c1e82a05c0e1d364fc027e 100644 (file)
@@ -468,16 +468,18 @@ ElementTree Objects
       root element.
 
 
-   .. method:: write(file, encoding="us-ascii", xml_declaration=None, method="xml")
+   .. method:: write(file, encoding="us-ascii", xml_declaration=None, \
+                     default_namespace=None, method="xml")
 
       Writes the element tree to a file, as XML.  *file* is a file name, or a
-      :term:`file object` opened for writing.  *encoding* [1]_ is the output encoding
-      (default is US-ASCII).  Use ``encoding="unicode"`` to write a Unicode string.
-      *xml_declaration* controls if an XML declaration
+      :term:`file object` opened for writing.  *encoding* [1]_ is the output
+      encoding (default is US-ASCII).  Use ``encoding="unicode"`` to write a
+      Unicode string.  *xml_declaration* controls if an XML declaration
       should be added to the file.  Use False for never, True for always, None
-      for only if not US-ASCII or UTF-8 or Unicode (default is None).  *method* is
-      either ``"xml"``, ``"html"`` or ``"text"`` (default is ``"xml"``).
-      Returns an (optionally) encoded string.
+      for only if not US-ASCII or UTF-8 or Unicode (default is None).
+      *default_namespace* sets the default XML namespace (for "xmlns").
+      *method* is either ``"xml"``, ``"html"`` or ``"text"`` (default is
+      ``"xml"``).  Returns an (optionally) encoded string.
 
 This is the XML file that is going to be manipulated::
 
index 9742f32f38101486d7690edfe8c7f94a47067f08..ff8ff7d78f4e241e7987869a886f96b74904e692 100644 (file)
@@ -802,11 +802,12 @@ class ElementTree:
     # @param **options Options, given as keyword arguments.
     # @keyparam encoding Optional output encoding (default is US-ASCII).
     #     Use "unicode" to return a Unicode string.
-    # @keyparam method Optional output method ("xml", "html", "text" or
-    #     "c14n"; default is "xml").
     # @keyparam xml_declaration Controls if an XML declaration should
     #     be added to the file.  Use False for never, True for always,
     #     None for only if not US-ASCII or UTF-8 or Unicode.  None is default.
+    # @keyparam default_namespace Sets the default XML namespace (for "xmlns").
+    # @keyparam method Optional output method ("xml", "html", "text" or
+    #     "c14n"; default is "xml").
 
     def write(self, file_or_filename,
               # keyword arguments