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

JShell API: Fix position of @jls tag

    XMLWordPrintable

Details

    • Bug
    • Resolution: Fixed
    • P3
    • 13
    • 10
    • tools
    • 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

                rfield Robert Field (Inactive)
                rfield Robert Field (Inactive)
                Votes:
                0 Vote for this issue
                Watchers:
                1 Start watching this issue

                Dates

                  Created:
                  Updated:
                  Resolved: