-
Bug
-
Resolution: Duplicate
-
P4
-
16
-
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
{
"""
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
{
"""
- duplicates
-
JDK-8250766 javadoc adds redundant spaces when @see program element is wrapped
-
- Closed
-