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

Problems with inline tags in HTML attribute values

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Unresolved
    • Icon: P4 P4
    • None
    • None
    • tools
    • None

      There are multiple problems related to JavaDoc inline tags embedded in HTML attribute values. Inline tags are parsed in HTML attribute values because we support the `{@docRoot}` tag to insert the relative URL of the documentation root. However, other usages of `{@` inside attribute values yield strange or buggy behaviour.

       - Escaped inline tag sequences starting with `{@@` cause `{@` to be added to the parsed string, but further characters are not added to the parsed attribute value.
       - Unknown inline tags are accepted and ignored without warning or error.
       - Known inline tags are accepted and processed, even if they produce output that is invalid in the context of an HTML attribute value (such as `{@index}` or `{@link}` tags generating HTML flow content).

      Items 1 and 2 only occur with traditional doc comments, while item 3 also affects Markdown doc comments.

            Unassigned Unassigned
            hannesw Hannes Wallnoefer
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated: