[jdom-commits] Javadoc generation warnings

[Elliotte Rusty Harold]

At 2:55 PM +0400 5/16/02, Eugene Karpov wrote:
>   [javadoc] javadoc: warning - Method 
>org.jdom.adapters.DOMAdapter.createDocument
>   [javadoc]     documents that it throws java.lang.Exception,
>   [javadoc]     but does not declare it.
>   [javadoc] javadoc: warning - Method 
>org.jdom.adapters.DOMAdapter.createDocument
>   [javadoc]     documents that it throws java.lang.Exception,
>   [javadoc]     but does not declare it.
>

Good catch. I wonder why I don't see that warning. I did write a 
patch for this and other JavaDoc problems in that class, but I'm not 
sure it's correct or complete yet. In particular, is it possible for 
the implementations of these methods in the concrete subclasses to 
throw any runtime exceptions we haven't explicitly declared? 
DOMException comes to mind as one likely candidate.

There are also some other issues with this class I notice now that 
I'm looking at it, but I'm going to address them in a separate thread.
-- 

+-----------------------+------------------------+-------------------+
| Elliotte Rusty Harold | elharo at metalab.unc.edu | Writer/Programmer |
+-----------------------+------------------------+-------------------+
|          The XML Bible, 2nd Edition (Hungry Minds, 2001)           |
|             http://www.cafeconleche.org/books/bible2/              |
|   http://www.amazon.com/exec/obidos/ISBN=0764547607/cafeaulaitA/   |
+----------------------------------+---------------------------------+
|  Read Cafe au Lait for Java News:  http://www.cafeaulait.org/      |
|  Read Cafe con Leche for XML News: http://www.cafeconleche.org/    |
+----------------------------------+---------------------------------+