W3C home > Mailing lists > Public > www-dom@w3.org > April to June 2007

Re: get/setDocumentURI in org.w3c.dom.Document

From: Bjoern Hoehrmann <derhoermi@gmx.net>
Date: Thu, 07 Jun 2007 23:25:12 +0200
To: Norman Walsh <ndw@nwalsh.com>
Cc: www-dom@w3.org
Message-ID: <aatg63d3vh3adbql7jkc3lduhbtccjfphc@hive.bjoern.hoehrmann.de>

* Norman Walsh wrote:
>As far as I can tell, something about the process that generated those
>API files caused the documentation for each get* method to be
>textually identical to each set* method. Is that not a bug?

No, the Java bindings are automatically generated from the specification
source code, which only documents attributes as attributes, not as indi-
vidual methods. For attributes that are read/write you inevitably get in
some cases odd documentation. I don't think it is feasible to write two
versions of the text for all such attributes, and I don't see an easy
way to automatically generate more suitable text.

>[*] Although I put up considerable resistance, I was eventually
>persuaded to make very small changes to the APIs in order to fix
>broken JavaDoc coding and the occasional typo. I believe that I have
>also reported each of those errors, though I don't have pointers
>handy.

There are indeed two mails from you in the archive, expect them to be
addressed as the specification is being revised.
-- 
Björn Höhrmann · mailto:bjoern@hoehrmann.de · http://bjoern.hoehrmann.de
Weinh. Str. 22 · Telefon: +49(0)621/4309674 · http://www.bjoernsworld.de
68309 Mannheim · PGP Pub. KeyID: 0xA4357E78 · http://www.websitedev.de/ 
Received on Thursday, 7 June 2007 21:25:19 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 22 June 2012 06:13:58 GMT