Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

How do I @link to a JSP file in javadoc?

Tags:

java

jsp

javadoc

I get the following warning from javadoc:

warning - Tag @link:illegal character: "47"

when I have something like

/** 
 *  {@link /WebRoot/WEB-INF/tiles/templates/bob.jsp} for the template responsible
 */

in my code.

What is the best way to link to the jsp file in my javadoc comments?

like image 444
brendangibson Avatar asked Oct 11 '11 18:10

brendangibson


People also ask

How do you reference another class in Javadoc?

Javadoc provides the @link inline tag for referencing the members in the Java classes. We can think of the @link tag as similar to the anchor tag in HTML, which is used to link one page to another via hyperlinks.

When to use@ link in Javadoc?

This inserts an inline link with a visible text label. The text label points to the documentation for the specified package, class, or member name. This tag can be used everywhere, including an overview, package, class, method, field, etc.

What is@ link in Javadoc?

The @link tag is specifically used to link to the Javadoc of other classes and methods.

How do you mention a method in Javadoc?

Using Tags. For example, most Javadoc comments for methods include " @param " and " @return " tags when applicable, to describe the method's parameters and return value. The " @param " tag should be followed by the parameter's name, and then a description of that parameter.


1 Answers

have you tried using html-links in your JavaDoc? They do not need a @-Tag annotation.

/**
 *  <a href="./WebRoot/WEB-INF/tiles/templates/bob.jsp">click me</a>  
 */
like image 180
Simulant Avatar answered Nov 12 '22 13:11

Simulant