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

@index does not work with <a href=...> and @extLink

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Unresolved
    • Icon: P3 P3
    • tbd
    • 9
    • tools
    • None

      {@extLink foo {@index "Foo Description"}}

      "{@index "Foo Description"}" is parsed as the description for the external link instead of "Foo Description".

      <a href="foo.html">{@index "Foo Description"}</a>

      The link is lost and the output generated is
      <a href="foo.html"><a id="FooDescription" class="searchTagResult">Foo Description</a></a>

      The following shows an example patch to a package summary.

      $ hg diff src/java.base/share/classes/java/security/package-info.java
      diff --git a/src/java.base/share/classes/java/security/package-info.java b/src/java.base/share/classes/java/security/package-info.java
      --- a/src/java.base/share/classes/java/security/package-info.java
      +++ b/src/java.base/share/classes/java/security/package-info.java
      @@ -47,13 +47,13 @@
        *
        * <ul>
        * <li> {@extLink security_guide_jca
      - * Java Cryptography Architecture (JCA) Reference Guide}</li>
      + * {@index "Java Cryptography Architecture (JCA) Reference Guide"}}</li>
        *
        * <li>PKCS #8: Private-Key Information Syntax Standard, Version 1.2,
        * November 1993</li>
        *
        * <li><a href="{@docRoot}/../specs/security/standard-names.html">
      - * Java Security Standard Algorithm Names Specification
      + * {@index "Java Security Standard Algorithm Names Specification"}
        * </a></li>
        * </ul>
        *

            Unassigned Unassigned
            mchung Mandy Chung (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated: