Use of Javadoc annotations such as @link or @see

[mattadamson]

Hi

How do others use previous JavaDoc annotation such as @link and @see in the Ascii doc formatted documentation? e.g. if we want to reference another class from a class definition we'd use

{@link classwithpackageidentifier}

Many thanks

Matt

[johncarl81]

Asciidoclet will just enhance the tag's text, the annotation tags should work as they did before. For me, @see referencing a class within the same project will create a link to that class.

[Myllyenko]

@johncarl81 Is it possible to use @link inside a [source] block? The most straightforward approach:

 /**
  * [source,java]
  * --
  * {@link MyClass}
  * --
  */

doesn't work.

[johncarl81]

Unfortunately, I don't have an answer for this use case @Myllyenko. Closest thing we support is a @see or @link tag outside of the source block.