[Patches] [ python-Patches-1051321 ] xml.dom missing API docs (bugs 1010196, 1013525)

[SourceForge.net]

Patches item #1051321, was opened at 2004-10-21 10:38
Message generated for change (Settings changed) made by jlgijsbers
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=305470&aid=1051321&group_id=5470

Category: Documentation
Group: Python 2.4
>Status: Closed
>Resolution: Accepted
Priority: 5
Submitted By: Mike Brown (mike_j_brown)
>Assigned to: Johannes Gijsbers (jlgijsbers)
Summary: xml.dom missing API docs (bugs 1010196, 1013525)

Initial Comment:
This patch addresses bugs 1013525
("xml.dom documentation omits createDocument,
...DocumentType")
and 1010196
("xml.dom documentation omits hasAttribute,
hasAttributeNS")

In the documentation for createDocument(), it is now stated
that the Python DOM API allows implementations to forego
creation of the document element child node, if no
namespace
and local name arguments are given. (This possibility
is left
open and unaddressed in the W3C spec).

The patch also fixes a broken reference to an external
document,
and adds a mention that the Python DOM API does not require
enforcement of W3C DOM requirements that are not accounted
for in the IDL definitions upon which the Python mapping is
based.

The patch was developed against Python 2.4b1's
/python/dist/src/Doc/lib/xmldom.tex and is untested.


----------------------------------------------------------------------

>Comment By: Johannes Gijsbers (jlgijsbers)
Date: 2005-01-09 01:39

Message:
Logged In: YES 
user_id=469548

Documentation is correct as far as I can see. Checked in on
HEAD and maint24. Thanks for the patch!

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=305470&aid=1051321&group_id=5470