Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8303766

Support /// for documentation comments

    XMLWordPrintable

Details

    • Enhancement
    • Resolution: Delivered
    • P4
    • None
    • None
    • tools
    • None

    Description

      We should consider supporting `///` for use in documentation comments.

      Approximate spec:

      A doc comment is extended to support a series of adjacent lines each beginning with optional whitespace followed by exactly `///` ... with the rest of the line being comment content.

      See also the spec in Elements.getDocComment.

      We should also consider a new method alongside Elements.getDocComment to provide the "style" of the comment (`/**` or `///`)

      As with `/**` comments, `DocSourcePositions` should be able to map positions within a `///` comment to positions in the enclosing source file.

      Attachments

        Issue Links

          Activity

            People

              jlaskey Jim Laskey
              jjg Jonathan Gibbons
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: