that would be helpful, if jAutoDoc could add @Link or Code (configurable) to known classes mentioned in javadoc, like this example:
/**
* <p>
* Instantiate a JavaBean.
* </p>
*
* @param cls the class-loader from which we should create
* the bean. If this is null, then the system
* class-loader is used.
* @param beanName the name of the bean within the class-loader.
* For example "sun.beanbox.foobah"
* @param beanContext The <Code>BeanContext</Code> in which to nest the new bean
*
* @exception {@link java.lang.ClassNotFoundException} if the class of a serialized
* object could not be found.
* @exception {@link java.io.IOException} if an I/O error occurs.
*/
public static Object instantiate(ClassLoader cls, String beanName, BeanContext beanContext) throws java.io.IOException, ClassNotFoundException {
return Beans.instantiate(cls, beanName, beanContext, null);
}
The Javadoc tool automatically adds cross-reference links. See http://download.oracle.com/javase/1.5.0/docs/tooldocs/windows/javadoc.html#processingofsourcefiles
and
http://download.oracle.com/javase/1.5.0/docs/tooldocs/windows/javadoc.html#link
E.g. to link to Java API Specification use
javadoc -link http://download.oracle.com/javase/1.5.0/docs/api/ -d docdir -sourcepath src com.mypackage