-
Task
-
Resolution: Unresolved
-
P4
-
None
It is not clear in the specification that tags like // @start is inclusive of the line it is defined on.
https://docs.oracle.com/en/java/javase/18/docs/specs/javadoc/doc-comment-spec.html
e.g.
public void myMethod() // @start region="my-region"
...
Would include "public void myMethod()" in the "my-region" region. Intuitively the tag must be placed on the line before, which can also lead to some confusing issues, like extra lines when using hybrid-snippets.
https://docs.oracle.com/en/java/javase/18/docs/specs/javadoc/doc-comment-spec.html
e.g.
public void myMethod() // @start region="my-region"
...
Would include "public void myMethod()" in the "my-region" region. Intuitively the tag must be placed on the line before, which can also lead to some confusing issues, like extra lines when using hybrid-snippets.