--- old/src/java.base/share/classes/javax/net/ssl/SSLSession.java Fri May 29 00:47:33 2015 +++ new/src/java.base/share/classes/javax/net/ssl/SSLSession.java Fri May 29 00:47:33 2015 @@ -35,7 +35,7 @@ * also be replaced by a different session. Sessions are created, or * rejoined, as part of the SSL handshaking protocol. Sessions may be * invalidated due to policies affecting security or resource usage, - * or by an application explicitly calling invalidate. + * or by an application explicitly calling {@code invalidate}. * Session management policies are typically used to tune performance. * *

In addition to the standard session attributes, SSL sessions expose @@ -82,8 +82,8 @@ * security manager installed, the caller may require * permission to access it or a security exception may be thrown. * In a Java environment, the security manager's - * checkPermission method is called with a - * SSLPermission("getSSLSessionContext") permission. + * {@code checkPermission} method is called with a + * {@code SSLPermission("getSSLSessionContext")} permission. * * @throws SecurityException if the calling thread does not have * permission to get SSL session context. @@ -148,14 +148,14 @@ /** * - * Binds the specified value object into the + * Binds the specified {@code value} object into the * session's application layer data - * with the given name. + * with the given {@code name}. *

- * Any existing binding using the same name is - * replaced. If the new (or existing) value implements the - * SSLSessionBindingListener interface, the object - * represented by value is notified appropriately. + * Any existing binding using the same {@code name} is + * replaced. If the new (or existing) {@code value} implements the + * {@code SSLSessionBindingListener} interface, the object + * represented by {@code value} is notified appropriately. *

* For security reasons, the same named values may not be * visible across different access control contexts. @@ -187,7 +187,7 @@ * Removes the object bound to the given name in the session's * application layer data. Does nothing if there is no object * bound to the given name. If the bound existing object - * implements the SessionBindingListener interface, + * implements the {@code SessionBindingListener} interface, * it is notified appropriately. *

* For security reasons, the same named values may not be @@ -349,7 +349,7 @@ * by this method. *

* This value is not authenticated and should not be relied upon. - * It is mainly used as a hint for SSLSession caching + * It is mainly used as a hint for {@code SSLSession} caching * strategies. * * @return the host name of the peer host, or null if no information @@ -364,7 +364,7 @@ * the client, it is the server's port number. *

* This value is not authenticated and should not be relied upon. - * It is mainly used as a hint for SSLSession caching + * It is mainly used as a hint for {@code SSLSession} caching * strategies. * * @return the port number of the peer host, or -1 if no information @@ -375,14 +375,14 @@ public int getPeerPort(); /** - * Gets the current size of the largest SSL/TLS packet that is expected - * when using this session. + * Gets the current size of the largest SSL/TLS/DTLS packet that is + * expected when using this session. *

- * A SSLEngine using this session may generate SSL/TLS + * An {@code SSLEngine} using this session may generate SSL/TLS/DTLS * packets of any size up to and including the value returned by this - * method. All SSLEngine network buffers should be sized + * method. All {@code SSLEngine} network buffers should be sized * at least this large to avoid insufficient space problems when - * performing wrap and unwrap calls. + * performing {@code wrap} and {@code unwrap} calls. * * @return the current maximum expected network packet size * @@ -398,7 +398,7 @@ * Gets the current size of the largest application data that is * expected when using this session. *

- * SSLEngine application data buffers must be large + * {@code SSLEngine} application data buffers must be large * enough to hold the application data from any inbound network * application data packet received. Typically, outbound * application data buffers can be of any size.