Commit 03530b98 authored by Serhiy Storchaka's avatar Serhiy Storchaka

Describe the default_namespace parameter of ElemetTree.write.

parent b09b1674
...@@ -468,16 +468,18 @@ ElementTree Objects ...@@ -468,16 +468,18 @@ ElementTree Objects
root element. 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 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 :term:`file object` opened for writing. *encoding* [1]_ is the output
(default is US-ASCII). Use ``encoding="unicode"`` to write a Unicode string. encoding (default is US-ASCII). Use ``encoding="unicode"`` to write a
*xml_declaration* controls if an XML declaration Unicode string. *xml_declaration* controls if an XML declaration
should be added to the file. Use False for never, True for always, None 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 for only if not US-ASCII or UTF-8 or Unicode (default is None).
either ``"xml"``, ``"html"`` or ``"text"`` (default is ``"xml"``). *default_namespace* sets the default XML namespace (for "xmlns").
Returns an (optionally) encoded string. *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:: This is the XML file that is going to be manipulated::
......
...@@ -802,11 +802,12 @@ class ElementTree: ...@@ -802,11 +802,12 @@ class ElementTree:
# @param **options Options, given as keyword arguments. # @param **options Options, given as keyword arguments.
# @keyparam encoding Optional output encoding (default is US-ASCII). # @keyparam encoding Optional output encoding (default is US-ASCII).
# Use "unicode" to return a Unicode string. # 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 # @keyparam xml_declaration Controls if an XML declaration should
# be added to the file. Use False for never, True for always, # 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. # 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, def write(self, file_or_filename,
# keyword arguments # keyword arguments
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment