diff --git a/src/main/java/spoon/reflect/code/CtJavaDoc.java b/src/main/java/spoon/reflect/code/CtJavaDoc.java index f1987438dc3..dff532c8e7a 100644 --- a/src/main/java/spoon/reflect/code/CtJavaDoc.java +++ b/src/main/java/spoon/reflect/code/CtJavaDoc.java @@ -18,10 +18,7 @@ /** * This code element defines a javadoc comment - *


- * Further utilities to parse javadoc comments to an AST with resolved references can be found in the - * spoon-javadoc submodule. - *


> + * * Example: *

  * /**
diff --git a/src/main/java/spoon/reflect/declaration/CtElement.java b/src/main/java/spoon/reflect/declaration/CtElement.java
index 161e9c78da0..85097f22d62 100644
--- a/src/main/java/spoon/reflect/declaration/CtElement.java
+++ b/src/main/java/spoon/reflect/declaration/CtElement.java
@@ -104,16 +104,12 @@  CtAnnotation getAnnotation(
 
 	/**
 	 * Returns the text of the documentation ("javadoc") comment of this
-	 * element. It contains the text of Javadoc together with the block tags.
-	 * 

- * To get only the text without block tags, use {@code getComments().get(0).getContent()}. - *

- * To instead extract block tags, use {@code getComments().get(0).asJavaDoc().getTags()}. - *


- * To obtain an AST representation of the comment with resolved references, - * you can use the {@code JavadocParser} from - *
spoon-javadoc. - *

+ * 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()` + * * See also {@link #getComments()}.and {@link spoon.reflect.code.CtJavaDoc} */ @DerivedProperty