Strip formatting of a reference from output of @see

XMLWordPrintable

    • Type: Bug
    • Resolution: Duplicate
    • Priority: P4
    • 17
    • Affects Version/s: 16
    • Component/s: 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
          {
      """

            Assignee:
            Hannes Wallnoefer
            Reporter:
            Pavel Rappo
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: