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

Strip formatting of a reference from output of @see

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Duplicate
    • Icon: P4 P4
    • 17
    • 16
    • tools
    • None

      It seems that formatting of the reference part of an @see tag is carried over from source code into HTML output.

      For example, consider this URL constructor: https://download.java.net/java/early_access/jdk15/docs/api/java.base/java/net/URL.html#%3Cinit%3E(java.lang.String,java.lang.String,int,java.lang.String)
      [That link is now obsolete, although the problem persists in recent GA builds; see also the attached screenshot]

      Note stray whitespace characters after some of the "(" characters in the "See Also:" section. Those whitespace characters correspond to newlines in the below excerpt from the source code:

      """
           * @throws MalformedURLException if an unknown protocol or the port
           * is a negative number other than -1
           * @see java.lang.System#getProperty(java.lang.String)
           * @see java.net.URL#setURLStreamHandlerFactory(
           * java.net.URLStreamHandlerFactory)
           * @see java.net.URLStreamHandler
           * @see java.net.URLStreamHandlerFactory#createURLStreamHandler(
           * java.lang.String)
           */
          public URL(String protocol, String host, int port, String file)
              throws MalformedURLException
          {
      """

            hannesw Hannes Wallnoefer
            prappo Pavel Rappo (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: