[jdom-interest] hyperlinks to referenced classes in JDOM javadocs

[Jason Hunter]

Nice!  I just integrated both patches.

-jh-

"Taylor, Patrick" wrote:
> 
> The following patch to build.xml causes all javadoc references to external
> classes to be generated as hyperlinks to the J2SE1.4 javadocs for those
> classes.  This is done simply by using the -link option to the javadoc tool.
> See the following page for details:
> 
> http://java.sun.com/j2se/1.4/docs/tooldocs/win32/javadoc.html#link
> 
> Using the 1.4 doc (rather than an earlier version of the J2SE) allows all
> links
> to be resolved, as the DOM/SAX/etc packages are now included in the J2SE.
> 
> ===================================================================
> *** build.xml   2001/05/15 23:22:48     1.19
> --- build.xml   2001/06/14 20:47:56
> *************** For instructions on how to build JDOM, p
> *** 198,203 ****
> --- 198,204 ----
>                noindex="false"
>                windowtitle="${Name} API"
>                doctitle="${Name}"
> +              link="http://java.sun.com/j2se/1.4/docs/api"
>                bottom="Copyright © ${year} Brett McLaughlin, Jason
> Hunter. All Rights Reserved."
>       />
>     </target>
> 
> The following patches resolve several warnings about @link tags which
> reference TransformerFactory.  See the following page for details:
> 
> http://java.sun.com/j2se/1.4/docs/tooldocs/win32/javadoc.html#howaclassmustb
> ereferenced
> 
> ===================================================================
> *** src/java/org/jdom/transform/JDOMResult.java 2001/06/10 22:01:05     1.2
> --- src/java/org/jdom/transform/JDOMResult.java 2001/06/14 20:47:57
> *************** import org.jdom.input.*;
> *** 68,73 ****
> --- 68,74 ----
>   import org.jdom.output.*;
> 
>   import javax.xml.transform.sax.SAXResult;
> + import javax.xml.transform.TransformerFactory; // workaround for @link bug
> 
>   /**
>    * Acts as a holder for a transformation result tree, in the form
> 
> ===================================================================
> *** src/java/org/jdom/transform/JDOMSource.java 2001/06/10 22:01:05     1.2
> --- src/java/org/jdom/transform/JDOMSource.java 2001/06/14 20:48:00
> *************** import org.jdom.*;
> *** 66,71 ****
> --- 66,72 ----
>   import org.jdom.output.*;
> 
>   import javax.xml.transform.sax.SAXSource;
> + import javax.xml.transform.TransformerFactory; // workaround for @link bug
> 
>   /**
>    * Acts as an holder for JDOM document sources.
> _______________________________________________
> To control your jdom-interest membership:
> http://lists.denveronline.net/mailman/options/jdom-interest/youraddr@yourhost.com