- 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
* 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 UTC