tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bugzi...@apache.org
Subject DO NOT REPLY [Bug 4156] - javadoc errors
Date Mon, 15 Oct 2001 02:07:15 GMT
DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG 
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://nagoya.apache.org/bugzilla/show_bug.cgi?id=4156>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND 
INSERTED IN THE BUG DATABASE.

http://nagoya.apache.org/bugzilla/show_bug.cgi?id=4156

javadoc errors

jon@latchkey.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|RESOLVED                    |REOPENED
         Resolution|WONTFIX                     |



------- Additional Comments From jon@latchkey.com  2001-10-14 19:07 -------
------ Forwarded Message
From: Dmitri Colebatch <dim@bigpond.net.au>
Reply-To: tomcat-dev@jakarta.apache.org
Date: Mon, 15 Oct 2001 09:17:05 +1000
To: tomcat-dev <tomcat-dev@jakarta.apache.org>
Subject: Re: DO NOT REPLY [Bug 4157]  -  javadoc errors

I've missed the lead up to this, so excuse me if this has already been
discussed/discarded.

The resolution of this bug (4157) is:

"This is a deficiency in Javadoc, which is unable to resolve, or ignore,
links to the JDK base classes."

which is not strictly true.  At the command line, javadoc has the the
"-linkoffline" flag, which allows tags like @see to link to existing
javadoc.  In the command line version one could use something like:

javadoc -linkoffline http://java.sun.com/j2se/1.3/docs/api . -d docs/
src/Test.java

where in the current directory there is a file called package-list with
one line "java.lang".  Any links to java.lang packages would then go to
sun's site.  Obviously this is not idea, but may be an improvement on not
having them resolved, and it would at least remove the build errors.  

I'm assuming the functionality is also easily acheivable through ant's
javadoc task.  People could then configure the offline link to their own
copy of the javadoc to save bandwidth (o:

I'm not familiar with the build system atm, but imagine this would be easy
to do.  If someone considers it worthwhile I'll happily do it and submit
the patch.

cheers
dim

Mime
View raw message