How to add reference to a method parameter in javadoc?

Question

Is there a way to add references to one or more of a method's parameters from the method documentation body? Something like:

/**

 * When {@paramref a} is null, we rely on b for the discombobulation.

 *

 * @param a this is one of the parameters

 * @param b another param

 */

void foo(String a, int b)

{...}

Answer 1

As considerably as I can show after seeing the docs for Javadoc there is no so highlight.

Don't apply <code>foo</code> ; you can apply {@code foo}. This is particularly useful to understand when you apply to a general type so as {@code Iterator<String>} -- sure seems nicer than <code>Iterator&lt;String&gt;</code>, doesn't it!