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

JShell API: Fix position of @jls tag

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: P3
    • Resolution: Fixed
    • Affects Version/s: 10
    • Fix Version/s: 13
    • Component/s: tools
    • Labels:
    • Subcomponent:
    • Resolved In Build:
      b24

      Backports

        Description

        Some of the @jls tgas are not in tag position at the end of the comment.

        Jon wrote --

        We recently changed the support for the @jls tag, and I note that it conflicts with a style of usage that we did not detect previously with line-based tools (i.e. grep.)

        This is one of a few similar occurrences in Snippet.java


                 * @jls 8.3 Field Declarations
                 * <P>
                 * A variable declaration is {@linkplain Kind#isPersistent() persistent}.

        The problem is that as it currently stands, the @jls tag will detect the 8.3 and then attempt to put a`<a href=...>` ... `</a>` aound the rest of the content. That's bad in this case, because you can't have `<P>` inside `<a>`.

          Attachments

            Issue Links

              Activity

                People

                • Assignee:
                  rfield Robert Field
                  Reporter:
                  rfield Robert Field
                • Votes:
                  0 Vote for this issue
                  Watchers:
                  1 Start watching this issue

                  Dates

                  • Created:
                    Updated:
                    Resolved: