JDK-8001751 : Javadoc warnings in JSSE code
  • Type: Bug
  • Component: security-libs
  • Sub-Component: javax.net.ssl
  • Priority: P2
  • Status: Closed
  • Resolution: Fixed
  • Submitted: 2012-10-28
  • Updated: 2013-04-15
  • Resolved: 2012-11-24
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 8
8 b68Fixed
Related Reports
Relates :  
JDK-7068321 - Support TLS Server Name Indication (SNI) Extension in JSSE Server
Description
Our javadoc builds were clean up until JDK-7068321 was pushed, see:

../../src/share/classes/javax/net/ssl/SNIHostName.java:161: warning - Tag @link: missing '#': "SNIHostName(String)"
../../src/share/classes/javax/net/ssl/SNIMatcher.java:51: warning - Tag @see:illegal character: "60" in "SSLParameters#setSNIMatchers(Collection<SNIMatcher>)"
../../src/share/classes/javax/net/ssl/SNIMatcher.java:51: warning - Tag @see:illegal character: "62" in "SSLParameters#setSNIMatchers(Collection<SNIMatcher>)"
../../src/share/classes/javax/net/ssl/SNIMatcher.java:51: warning - Tag @see: can't find setSNIMatchers(Collection<SNIMatcher>) in javax.net.ssl.SSLParameters
../../src/share/classes/javax/net/ssl/SNIServerName.java:47: warning - Tag @see:illegal character: "60" in "SSLParameters#setServerNames(List<SNIServerName>)"
../../src/share/classes/javax/net/ssl/SNIServerName.java:47: warning - Tag @see:illegal character: "62" in "SSLParameters#setServerNames(List<SNIServerName>)"
../../src/share/classes/javax/net/ssl/SNIServerName.java:47: warning - Tag @see: can't find setServerNames(List<SNIServerName>) in javax.net.ssl.SSLParameters
../../src/share/classes/javax/net/ssl/SSLParameters.java:352: warning - Tag @see:illegal character: "60" in "#setServerNames(List<SNIServerName>)"
../../src/share/classes/javax/net/ssl/SSLParameters.java:352: warning - Tag @see:illegal character: "62" in "#setServerNames(List<SNIServerName>)"
../../src/share/classes/javax/net/ssl/SSLParameters.java:352: warning - Tag @see: can't find setServerNames(List<SNIServerName>) in javax.net.ssl.SSLParameters
../../src/share/classes/javax/net/ssl/SSLParameters.java:427: warning - Tag @see:illegal character: "60" in "#setSNIMatchers(Collection<SNIMatcher>)"
../../src/share/classes/javax/net/ssl/SSLParameters.java:427: warning - Tag @see:illegal character: "62" in "#setSNIMatchers(Collection<SNIMatcher>)"
../../src/share/classes/javax/net/ssl/SSLParameters.java:427: warning - Tag @see: can't find setSNIMatchers(Collection<SNIMatcher>) in javax.net.ssl.SSLParameters
../../src/share/classes/javax/net/ssl/SSLSocketFactory.java:229: warning - Tag @link: reference not found: ByteArrayInputStream
Comments
I have run javadoc command with openjdk-8-ea-src-b68-13_dec_2012 build. there is no warning message about SNIHostName,SNIMatcher,SNIServerName,SSLParamters and SSLSocketFactory classes. the javadoc command result are following: C: \ Users \ zailiu \ Downloads \ openjdk-8-ea-src-b68-13_dec_2012 \ openjdk \ jdk \ src> cd s are C: \ Users \ zailiu \ Downloads \ openjdk-8-ea-src-b68-13_dec_2012 \ openjdk \ jdk \ src \ shar > Javadoc-d.-Sourcepath. \ Classes-subpackages javax.net.ssl Loading the program the package javax.net.ssl ������the source file ... Being constructed Javadoc information ... The. \ Classes \ sun \ util \ resources \ LocaleData.java: 51: error: can not find symbol import sun.util.locale.provider.LocaleDataMetaInfo; ��������������������������������������������������������������^����Symbol: class LocaleDataMetaInfo ����Location: package sun.util.locale.provider Standard the Doclet version 1.7.0_17 Are building a tree for all the packages and classes ... Is being generated. \ Javax \ net \ ssl \ CertPathTrustManagerParameters.html ... Being generated. \ Javax \ net \ ssl \ ExtendedSSLSession.html ... Is being generated. \ Javax \ net \ ssl \ HandshakeCompletedEvent.html ... Is being generated. \ Javax \ net \ ssl \ HandshakeCompletedListener.html ... Is being generated. \ Javax \ net \ ssl \ HostnameVerifier.html ... Is being generated. \ Javax \ net \ ssl \ HttpsURLConnection.html ... \ Classes \ java \ net \ AbstractPlainSocketImpl.java: 34: warning: NetHooks internal dedicated AP May be deleted in future releases import sun.net.NetHooks; ����������������������������^ Is being generated. \ Javax \ net \ ssl \ KeyManager.html ... Is being generated. \ Javax \ net \ ssl \ KeyManagerFactory.html ... Is being generated. \ Javax \ net \ ssl \ KeyManagerFactorySpi.html ... Is being generated. \ Javax \ net \ ssl \ KeyStoreBuilderParameters.html ... Is being generated. \ Javax \ net \ ssl \ ManagerFactoryParameters.html ... Is being generated. \ Javax \ net \ ssl \ SNIHostName.html ... Is being generated. \ Javax \ net \ ssl \ SNIMatcher.html ... Is being generated. \ Javax \ net \ ssl \ SNIServerName.html ... Is being generated. \ Javax \ net \ ssl \ SSLContext.html ... Is being generated. \ Javax \ net \ ssl \ SSLContextSpi.html ... Is being generated. \ Javax \ net \ ssl \ SSLEngine.html ... Is being generated. \ Javax \ net \ ssl \ SSLEngineResult.html ... Is being generated. \ Javax \ net \ ssl \ SSLEngineResult.HandshakeStatus.html ... . \ Classes \ javax \ net \ ssl \ SSLEngineResult.java: 160: warning - @ in accordance with the statement of the enumerated type often The order of the amount of the unknown tags. . \ Classes \ javax \ net \ ssl \ SSLEngineResult.java: 160: warning - @ return with the specified name enumeration The constant is unknown tag. . \ Classes \ javax \ net \ ssl \ SSLEngineResult.java: 160: warning - @ If the enumerated type did not with Specify the name of the constant is unknown tag. . \ Classes \ javax \ net \ ssl \ SSLEngineResult.java: 160: warning - @ If the parameter is null value is unknown Mark. Is being generated. \ Javax \ net \ ssl \ SSLEngineResult.Status.html ... . \ Classes \ javax \ net \ ssl \ SSLEngineResult.java: 160: warning - @ in accordance with the statement of the enumerated type often The order of the amount of the unknown tags. . \ Classes \ javax \ net \ ssl \ SSLEngineResult.java: 160: warning - @ return with the specified name enumeration The constant is unknown tag. . \ Classes \ javax \ net \ ssl \ SSLEngineResult.java: 160: warning - @ If the enumerated type did not with Specify the name of the constant is unknown tag. . \ Classes \ javax \ net \ ssl \ SSLEngineResult.java: 160: warning - @ If the parameter is null value is unknown Mark. Is being generated. \ Javax \ net \ ssl \ SSLException.html ... Is being generated. \ Javax \ net \ ssl \ SSLHandshakeException.html ... Is being generated. \ Javax \ net \ ssl \ SSLKeyException.html ... Is being generated. \ Javax \ net \ ssl \ SSLParameters.html ... Is being generated. \ Javax \ net \ ssl \ SSLPeerUnverifiedException.html ... Is being generated. \ Javax \ net \ ssl \ SSLPermission.html ... Is being generated. \ Javax \ net \ ssl \ SSLProtocolException.html ... Is being generated. \ Javax \ net \ ssl \ SSLServerSocket.html ... Is being generated. \ Javax \ net \ ssl \ SSLServerSocketFactory.html ... Is being generated. \ Javax \ net \ ssl \ SSLSession.html ... Is being generated. \ Javax \ net \ ssl \ SSLSessionBindingEvent.html ... Is being generated. \ Javax \ net \ ssl \ SSLSessionBindingListener.html ... Is being generated. \ Javax \ net \ ssl \ SSLSessionContext.html ... Is being generated. \ Javax \ net \ ssl \ SSLSocket.html ... Is being generated. \ Javax \ net \ ssl \ SSLSocketFactory.html ... Is being generated. \ Javax \ net \ ssl \ StandardConstants.html ... Being generated. \ Javax \ net \ ssl \ TrustManager.html ... Being generated. \ Javax \ net \ ssl \ TrustManagerFactory.html ... Being generated. \ Javax \ net \ ssl \ TrustManagerFactorySpi.html ... Is being generated. \ Javax \ net \ ssl \ X509ExtendedKeyManager.html ... Being generated \ javax \ net \ ssl \ X509ExtendedTrustManager.html ... Is being generated. \ Javax \ net \ ssl \ X509KeyManager.html ... Is being generated. \ Javax \ net \ ssl \ X509TrustManager.html ... Is being generated. \ Javax \ net \ ssl \ package-frame.html ... Is being generated. \ Javax \ net \ ssl \ package-summary.html ... Is being generated. \ Javax \ net \ ssl \ package-tree.html ... Being generated. \ Constant-values.html ... Being generated. \ Serialized-form.html ... Being built index of all the packages and classes ... Being generated. \ Overview-tree.html ... Being generated. \ Index-all.html ... Being generated. \ Deprecated-list.html ... 're Building all classes of index ... Being generated. \ Allclasses-frame.html ... Being generated. \ Allclasses-noframe.html ... Being generated. \ Index.html ... Being generated. \ Help-doc.html ... 10 warnings
15-04-2013
no new regression test, docs update only
24-11-2012
There javadoc warnings are embarrassing as we had the javadoc build has been otherwise clean before these changes were pushed.
22-11-2012