Reference the javadoc-parser submodule in spoon element's documentation

src/main/java/spoon/reflect/code/CtJavaDoc.java

@@ -18,7 +18,10 @@
 
 /**
  * This code element defines a javadoc comment
- *
+ * <p><br>
+ * Further utilities to parse javadoc comments to an AST with resolved references can be found in the
+ * <a href="https://spoon.gforge.inria.fr/spoon_javadoc.html">spoon-javadoc</a> submodule.
+ * <p><br>>
  * Example:
  * <pre>
  * &#x2F;**

src/main/java/spoon/reflect/declaration/CtElement.java

@@ -104,12 +104,16 @@ <A extends Annotation> CtAnnotation<A> getAnnotation(
 
 	/**
 	 * Returns the text of the documentation ("javadoc") comment of this
-	 * element. It contains the text of Javadoc together with the tags.
-	 *
-	 * If one only wants only the text without the tag, one can call `getComments().get(0).getContent()`
-	 *
-	 * If one wants to analyze the tags, one can call `getComments().get(0).asJavaDoc().getTags()`
-	 *
+	 * element. It contains the text of Javadoc together with the block tags.
+	 * <p>
+	 * To get only the text without block tags, use {@code getComments().get(0).getContent()}.
+	 * <p>
+	 * To instead extract block tags, use {@code getComments().get(0).asJavaDoc().getTags()}.
+	 * <p><br>
+	 * To obtain an <strong>AST representation of the comment with resolved references</strong>,
+	 * you can use the {@code JavadocParser} from
+	 * <a href="https://spoon.gforge.inria.fr/spoon_javadoc.html">spoon-javadoc</a>.
+	 * <p>
 	 * See also {@link #getComments()}.and {@link spoon.reflect.code.CtJavaDoc}
 	 */
 	@DerivedProperty