-
Enhancement
-
Resolution: Fixed
-
P3
-
23
-
None
-
b24
JEP 467 introduces the use of `///` for documentation comments using Markdown syntax.
javax.lang.model.util.Elements.getDocComment(Element) specifies how to obtain the "raw" content of a documentation comment, removing any decorative markers and leading whitespace, to yield a simple string.
As such, it should be updated to cover the new `///` form of documentation comments.
In addition, a new method should be added to return the "style" of the comment.
Note: the method does not mandate any particular interpretation of the content of a documentation comment. It is up to the consumer of the comment to choose how to interpret the contents.
javax.lang.model.util.Elements.getDocComment(Element) specifies how to obtain the "raw" content of a documentation comment, removing any decorative markers and leading whitespace, to yield a simple string.
As such, it should be updated to cover the new `///` form of documentation comments.
In addition, a new method should be added to return the "style" of the comment.
Note: the method does not mandate any particular interpretation of the content of a documentation comment. It is up to the consumer of the comment to choose how to interpret the contents.
- csr for
-
JDK-8329632 Update Elements for '///' documentation comments
-
- Closed
-
- relates to
-
JDK-8298405 Implement JEP 467: Markdown Documentation Comments
-
- Resolved
-