Update Elements for '///' documentation comments

XMLWordPrintable

    • Type: Enhancement
    • Resolution: Fixed
    • Priority: P3
    • 23
    • Affects Version/s: 23
    • Component/s: core-libs
    • None

      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.

            Assignee:
            Jonathan Gibbons
            Reporter:
            Jonathan Gibbons
            Votes:
            0 Vote for this issue
            Watchers:
            4 Start watching this issue

              Created:
              Updated:
              Resolved: