--- 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.