+ *
* A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
* '\u00C0' '\u00C1' '\u00C2' '\u00C3' '\u00C4' '\u00C5' '\u00C6' '\u00C7'
* '\u00C8' '\u00C9' '\u00CA' '\u00CB' '\u00CC' '\u00CD' '\u00CE' '\u00CF'
* '\u00D0' '\u00D1' '\u00D2' '\u00D3' '\u00D4' '\u00D5' '\u00D6' '\u00D8'
* '\u00D9' '\u00DA' '\u00DB' '\u00DC' '\u00DD' '\u00DE'
*
- * Many other Unicode characters are uppercase too.
+ *
Many other Unicode characters are uppercase too.
*
*
Note: This method cannot handle supplementary characters. To support
@@ -5496,7 +5496,7 @@ class Character implements java.io.Serializable, Comparable {
* or it has contributory property Other_Uppercase as defined by the Unicode Standard.
*
* The following are examples of uppercase characters:
- *
+ *
* A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
* '\u00C0' '\u00C1' '\u00C2' '\u00C3' '\u00C4' '\u00C5' '\u00C6' '\u00C7'
* '\u00C8' '\u00C9' '\u00CA' '\u00CB' '\u00CC' '\u00CD' '\u00CE' '\u00CF'
@@ -5540,7 +5540,7 @@ class Character implements java.io.Serializable, Comparable {
* {@code LATIN CAPITAL LETTER N WITH SMALL LETTER J}
* {@code LATIN CAPITAL LETTER D WITH SMALL LETTER Z}
*
- * Many other Unicode characters are titlecase too.
+ *
Many other Unicode characters are titlecase too.
*
*
Note: This method cannot handle supplementary characters. To support
diff --git a/src/share/classes/java/lang/Class.java b/src/share/classes/java/lang/Class.java
index 64376970a97a2bfd5f70ebe8dd5b9c6e8aac70ad..e11ee1e65e8bd1e240ac0b59cab954f26d143b23 100644
--- a/src/share/classes/java/lang/Class.java
+++ b/src/share/classes/java/lang/Class.java
@@ -91,7 +91,7 @@ import sun.reflect.misc.ReflectUtil;
*
The following example uses a {@code Class} object to print the
* class name of an object:
*
- *
+ *
* void printClassName(Object obj) {
* System.out.println("The class of " + obj +
* " is " + obj.getClass().getName());
@@ -103,7 +103,7 @@ import sun.reflect.misc.ReflectUtil;
* The Java™ Language Specification.
* For example:
*
- *
+ *
* {@code System.out.println("The name of class Foo is: "+Foo.class.getName());}
*
*
diff --git a/src/share/classes/java/lang/ClassCastException.java b/src/share/classes/java/lang/ClassCastException.java
index fc9b2616effc8e5913936033a7c23084627b3aa1..93b61630d21d38c798a60c47fcc541d4b1095c31 100644
--- a/src/share/classes/java/lang/ClassCastException.java
+++ b/src/share/classes/java/lang/ClassCastException.java
@@ -29,7 +29,7 @@ package java.lang;
* Thrown to indicate that the code has attempted to cast an object
* to a subclass of which it is not an instance. For example, the
* following code generates a ClassCastException:
- *
+ *
* Object x = new Integer(0);
* System.out.println((String)x);
*
diff --git a/src/share/classes/java/lang/Double.java b/src/share/classes/java/lang/Double.java
index 1b1aece8122321617cd8a0d1a0f794ef0517c1a6..690ca6a8dc3ffd5a544cafad015a34baaf63a88d 100644
--- a/src/share/classes/java/lang/Double.java
+++ b/src/share/classes/java/lang/Double.java
@@ -361,15 +361,11 @@ public final class Double extends Number implements Comparable {
* SignedInteger
*
*
- *
- *
*
* - HexFloatingPointLiteral:
*
- HexSignificand BinaryExponent FloatTypeSuffixopt
*
*
- *
- *
*
* - HexSignificand:
*
- HexNumeral
@@ -380,15 +376,11 @@ public final class Double extends Number implements Comparable {
* {@code .} HexDigits
*
*
- *
- *
*
* - BinaryExponent:
*
- BinaryExponentIndicator SignedInteger
*
*
- *
- *
*
* - BinaryExponentIndicator:
*
- {@code p}
diff --git a/src/share/classes/java/lang/Float.java b/src/share/classes/java/lang/Float.java
index e130e92314e43f4d73d0a696df9b0132a7183b6c..5cc28f99bff4ae68d13f8aaf1fd3b5951173ef8f 100644
--- a/src/share/classes/java/lang/Float.java
+++ b/src/share/classes/java/lang/Float.java
@@ -321,15 +321,11 @@ public final class Float extends Number implements Comparable {
*
- SignedInteger
*
*
- *
- *
*
* - HexFloatingPointLiteral:
*
- HexSignificand BinaryExponent FloatTypeSuffixopt
*
*
- *
- *
*
* - HexSignificand:
*
- HexNumeral
@@ -340,15 +336,11 @@ public final class Float extends Number implements Comparable {
* {@code .} HexDigits
*
*
- *
- *
*
* - BinaryExponent:
*
- BinaryExponentIndicator SignedInteger
*
*
- *
- *
*
* - BinaryExponentIndicator:
*
- {@code p}
diff --git a/src/share/classes/java/lang/Integer.java b/src/share/classes/java/lang/Integer.java
index 7ee4b48855e0adf084c2e1e65ff563c616ef90f3..c5d971a54ae37a80619f82ba2f5f2296d583f652 100644
--- a/src/share/classes/java/lang/Integer.java
+++ b/src/share/classes/java/lang/Integer.java
@@ -1123,7 +1123,7 @@ public final class Integer extends Number implements Comparable {
*
- Signopt {@code 0X} HexDigits
*
- Signopt {@code #} HexDigits
*
- Signopt {@code 0} OctalDigits
- *
+ *
*
- Sign:
*
- {@code -}
*
- {@code +}
diff --git a/src/share/classes/java/lang/Iterable.java b/src/share/classes/java/lang/Iterable.java
index 0a3ca82f5b4368b849552b5ca1d1a2900c17186c..eed39388a8f8148e016eaf0bf3b3530a7278e5ae 100644
--- a/src/share/classes/java/lang/Iterable.java
+++ b/src/share/classes/java/lang/Iterable.java
@@ -51,10 +51,12 @@ public interface Iterable {
Iterator iterator();
/**
- * Performs the given action on the contents of the {@code Iterable}, in the
- * order elements occur when iterating, until all elements have been
- * processed or the action throws an exception. Errors or runtime
- * exceptions thrown by the action are relayed to the caller.
+ * Performs the given action for each element of the {@code Iterable}
+ * until all elements have been processed or the action throws an
+ * exception. Unless otherwise specified by the implementing class,
+ * actions are performed in the order of iteration (if an iteration order
+ * is specified). Exceptions thrown by the action are relayed to the
+ * caller.
*
* @implSpec
*
The default implementation behaves as if:
@@ -99,4 +101,3 @@ public interface Iterable {
return Spliterators.spliteratorUnknownSize(iterator(), 0);
}
}
-
diff --git a/src/share/classes/java/lang/Long.java b/src/share/classes/java/lang/Long.java
index bfaf0c4412fe0555b20d6f20c73cb35b78148d59..fa43fa4d0b5cf0a2bde91c8be3a2a0ddd82fc717 100644
--- a/src/share/classes/java/lang/Long.java
+++ b/src/share/classes/java/lang/Long.java
@@ -853,7 +853,7 @@ public final class Long extends Number implements Comparable {
* - Signopt {@code 0X} HexDigits
*
- Signopt {@code #} HexDigits
*
- Signopt {@code 0} OctalDigits
- *
+ *
*
- Sign:
*
- {@code -}
*
- {@code +}
diff --git a/src/share/classes/java/lang/RuntimePermission.java b/src/share/classes/java/lang/RuntimePermission.java
index 6dcbc275e9e4f96631684499de52fa3138847247..9da131ba93833fc50ed350621db722de44d1663d 100644
--- a/src/share/classes/java/lang/RuntimePermission.java
+++ b/src/share/classes/java/lang/RuntimePermission.java
@@ -47,7 +47,6 @@ import java.util.StringTokenizer;
* The following table lists all the possible RuntimePermission target names,
* and for each provides a description of what the permission allows
* and a discussion of the risks of granting code the permission.
- *
*
*
diff --git a/src/share/classes/java/lang/Short.java b/src/share/classes/java/lang/Short.java
index c7641807c568528709b599bd1198aadfba86a576..9fb3913beaeef6314c0b39f6bc76ea3e6346510e 100644
--- a/src/share/classes/java/lang/Short.java
+++ b/src/share/classes/java/lang/Short.java
@@ -249,7 +249,7 @@ public final class Short extends Number implements Comparable {
* - Signopt {@code 0X} HexDigits
*
- Signopt {@code #} HexDigits
*
- Signopt {@code 0} OctalDigits
- *
+ *
*
- Sign:
*
- {@code -}
*
- {@code +}
diff --git a/src/share/classes/java/lang/String.java b/src/share/classes/java/lang/String.java
index 5c9a8017f140180253bcebb0a5f7862ab46ce3cc..9223c0ab54f93af8f2ffde71dc458f2155cd1c22 100644
--- a/src/share/classes/java/lang/String.java
+++ b/src/share/classes/java/lang/String.java
@@ -47,16 +47,16 @@ import java.util.regex.PatternSyntaxException;
* Strings are constant; their values cannot be changed after they
* are created. String buffers support mutable strings.
* Because String objects are immutable they can be shared. For example:
- *
+ *
* String str = "abc";
*
* is equivalent to:
- *
+ *
* char data[] = {'a', 'b', 'c'};
* String str = new String(data);
*
* Here are some more examples of how strings can be used:
- *
+ *
* System.out.println("abc");
* String cde = "cde";
* System.out.println("abc" + cde);
@@ -786,7 +786,7 @@ public final class String
* {@code srcEnd-srcBegin}). The characters are copied into the
* subarray of {@code dst} starting at index {@code dstBegin}
* and ending at index:
- *
+ *
* dstbegin + (srcEnd-srcBegin) - 1
*
*
@@ -2662,7 +2662,7 @@ public final class String
* {@code String} may be a different length than the original {@code String}.
*
* Examples of locale-sensitive and 1:M case mappings are in the following table.
- *
+ *
*
*
* | Language Code of Locale |
diff --git a/src/share/classes/java/lang/Thread.java b/src/share/classes/java/lang/Thread.java
index c2f5561bdf469527759be00ae5d3dd02c98bfdae..13d8ac26cad192ff98d8ca4d2f26830992e3de90 100644
--- a/src/share/classes/java/lang/Thread.java
+++ b/src/share/classes/java/lang/Thread.java
@@ -76,7 +76,7 @@ import sun.security.util.SecurityConstants;
* Thread. An instance of the subclass can then be
* allocated and started. For example, a thread that computes primes
* larger than a stated value could be written as follows:
- *
+ *
* class PrimeThread extends Thread {
* long minPrime;
* PrimeThread(long minPrime) {
@@ -91,7 +91,7 @@ import sun.security.util.SecurityConstants;
*
*
* The following code would then create a thread and start it running:
- *
+ *
* PrimeThread p = new PrimeThread(143);
* p.start();
*
@@ -102,7 +102,7 @@ import sun.security.util.SecurityConstants;
* then be allocated, passed as an argument when creating
* Thread, and started. The same example in this other
* style looks like the following:
- *
+ *
* class PrimeRun implements Runnable {
* long minPrime;
* PrimeRun(long minPrime) {
@@ -117,7 +117,7 @@ import sun.security.util.SecurityConstants;
*
*
* The following code would then create a thread and start it running:
- *
+ *
* PrimeRun p = new PrimeRun(143);
* new Thread(p).start();
*
diff --git a/src/share/classes/java/lang/invoke/LambdaMetafactory.java b/src/share/classes/java/lang/invoke/LambdaMetafactory.java
index 87c7923d9babc508a459f310312b32809e1eab35..a5d2afab40ebe5c481f4f5dffa4b84cb8271c12d 100644
--- a/src/share/classes/java/lang/invoke/LambdaMetafactory.java
+++ b/src/share/classes/java/lang/invoke/LambdaMetafactory.java
@@ -183,15 +183,15 @@ public class LambdaMetafactory {
* @param samMethodType MethodType of the method in the functional interface
* to which the lambda or method reference is being
* converted, represented as a MethodType.
- * @param implMethod The implementation method which should be called
- * (with suitable adaptation of argument types, return
- * types, and adjustment for captured arguments) when
- * methods of the resulting functional interface instance
- * are invoked.
+ * @param implMethod A direct method handle describing the implementation
+ * method which should be called (with suitable adaptation
+ * of argument types, return types, and adjustment for
+ * captured arguments) when methods of the resulting
+ * functional interface instance are invoked.
* @param instantiatedMethodType The signature of the primary functional
* interface method after type variables
* are substituted with their instantiation
- * from the capture site
+ * from the capture site.
* @return a CallSite, which, when invoked, will return an instance of the
* functional interface
* @throws ReflectiveOperationException if the caller is not able to
@@ -220,15 +220,21 @@ public class LambdaMetafactory {
* references to functional interfaces, which supports serialization and
* other uncommon options.
*
- * The declared argument list for this method is:
+ * The declared argument list for this method is:
*
+ *
{@code
* CallSite altMetafactory(MethodHandles.Lookup caller,
* String invokedName,
* MethodType invokedType,
* Object... args)
+ * }
*
- * but it behaves as if the argument list is:
+ * but it behaves as if the argument list is as follows, where names that
+ * appear in the argument list for
+ * {@link #metafactory(MethodHandles.Lookup, String, MethodType, MethodType, MethodHandle, MethodType)}
+ * have the same specification as in that method:
*
+ *
{@code
* CallSite altMetafactory(MethodHandles.Lookup caller,
* String invokedName,
* MethodType invokedType,
@@ -241,7 +247,15 @@ public class LambdaMetafactory {
* int bridgeCount, // IF flags has BRIDGES set
* MethodType... bridges // IF flags has BRIDGES set
* )
+ * }
*
+ * If the flags contains {@code FLAG_SERIALIZABLE}, or one of the marker
+ * interfaces extends {@link Serializable}, the metafactory will link the
+ * call site to one that produces a serializable lambda. In addition to
+ * the lambda instance implementing {@code Serializable}, it will have a
+ * {@code writeReplace} method that returns an appropriate {@link
+ * SerializedLambda}, and an appropriate {@code $deserializeLambda$}
+ * method.
*
* @param caller Stacked automatically by VM; represents a lookup context
* with the accessibility privileges of the caller.
@@ -257,7 +271,7 @@ public class LambdaMetafactory {
* In the event that the implementation method is an
* instance method, the first argument in the invocation
* signature will correspond to the receiver.
- * @param args flags and optional arguments, as described above
+ * @param args flags and optional arguments, as described above.
* @return a CallSite, which, when invoked, will return an instance of the
* functional interface
* @throws ReflectiveOperationException if the caller is not able to
diff --git a/src/share/classes/java/lang/invoke/SerializedLambda.java b/src/share/classes/java/lang/invoke/SerializedLambda.java
index 9be96ff685bdee8b2fcef7e914e540680f8f3ab4..e641201272155cf73f5ceecc8a2d0482baa3d8cc 100644
--- a/src/share/classes/java/lang/invoke/SerializedLambda.java
+++ b/src/share/classes/java/lang/invoke/SerializedLambda.java
@@ -32,9 +32,26 @@ import java.security.PrivilegedExceptionAction;
import java.util.Objects;
/**
- * Serialized form of a lambda expression. The properties of this class represent the information that is present
- * at the lambda factory site, including the identity of the primary functional interface method, the identity of the
- * implementation method, and any variables captured from the local environment at the time of lambda capture.
+ * Serialized form of a lambda expression. The properties of this class
+ * represent the information that is present at the lambda factory site, including
+ * static metafactory arguments such as the identity of the primary functional
+ * interface method and the identity of the implementation method, as well as
+ * dynamic metafactory arguments such as values captured from the lexical scope
+ * at the time of lambda capture.
+ *
+ *
Implementors of serializable lambdas, such as compilers or language
+ * runtime libraries, are expected to ensure that instances deserialize properly.
+ * One means to do so is to ensure that the {@code writeReplace} method returns
+ * an instance of {@code SerializedLambda}, rather than allowing default
+ * serialization to proceed.
+ *
+ *
{@code SerializedLambda} has a {@code readResolve} method that looks for
+ * a (possibly private) static method called
+ * {@code $deserializeLambda$(SerializedLambda)} in the capturing class, invokes
+ * that with itself as the first argument, and returns the result. Lambda classes
+ * implementing {@code $deserializeLambda$} are responsible for validating
+ * that the properties of the {@code SerializedLambda} are consistent with a
+ * lambda actually captured by that class.
*
* @see LambdaMetafactory
*/
diff --git a/src/share/classes/java/lang/management/ManagementFactory.java b/src/share/classes/java/lang/management/ManagementFactory.java
index 6e00706ccd04ed87a9cc440c439a0aa81540d07e..0c7297abe956d00027eab965baf466dc0bf09c27 100644
--- a/src/share/classes/java/lang/management/ManagementFactory.java
+++ b/src/share/classes/java/lang/management/ManagementFactory.java
@@ -60,7 +60,7 @@ import sun.management.ManagementFactoryHelper;
* one or more platform MXBeans representing
* the management interface of a component of the Java virtual
* machine.
- *
+ *
*
*
* A platform MXBean is a managed bean that
diff --git a/src/share/classes/java/lang/management/ManagementPermission.java b/src/share/classes/java/lang/management/ManagementPermission.java
index 7f62c5e396a6bd253fd1b3d182bed496d36e6c7a..ae3dc56451839a20e925d631e763e0ba77601bb6 100644
--- a/src/share/classes/java/lang/management/ManagementPermission.java
+++ b/src/share/classes/java/lang/management/ManagementPermission.java
@@ -33,10 +33,8 @@ package java.lang.management;
* The following table
* provides a summary description of what the permission allows,
* and discusses the risks of granting code the permission.
- *
*
- *
+ *
*
* | Permission Target Name |
* What the Permission Allows |
diff --git a/src/share/classes/java/lang/management/MemoryUsage.java b/src/share/classes/java/lang/management/MemoryUsage.java
index bbb75a2648451dc1e70e45bfd6a25b478c67165d..6d11e323f6dcecdce43b4b7b9933e15cad55e651 100644
--- a/src/share/classes/java/lang/management/MemoryUsage.java
+++ b/src/share/classes/java/lang/management/MemoryUsage.java
@@ -79,7 +79,7 @@ import sun.management.MemoryUsageCompositeData;
*
*
* Below is a picture showing an example of a memory pool:
- *
+ *
*
* +----------------------------------------------+
* +//////////////// | +
@@ -250,7 +250,7 @@ public class MemoryUsage {
* Returns a MemoryUsage object represented by the
* given CompositeData. The given CompositeData
* must contain the following attributes:
- *
+ *
*
*
*
diff --git a/src/share/classes/java/lang/management/package.html b/src/share/classes/java/lang/management/package.html
index 7d2fa99b737932c151e0149a7b97fbebc36efb1a..c2c74d0ccdd686b02ada1ad5631aa629198d47d1 100644
--- a/src/share/classes/java/lang/management/package.html
+++ b/src/share/classes/java/lang/management/package.html
@@ -82,7 +82,7 @@ Java virtual machine and the runtime in the following ways:
1. Direct access to an MXBean interface
-- Get an MXBean instance locally in the running Java virtual machine:
+
- Get an MXBean instance locally in the running Java virtual machine:
RuntimeMXBean mxbean = ManagementFactory.getRuntimeMXBean();
@@ -103,7 +103,7 @@ Java virtual machine and the runtime in the following ways:
- Construct an MXBean proxy instance that forwards the
- method calls to a given MBeanServer:
+ method calls to a given MBeanServer:
MBeanServerConnection mbs;
diff --git a/src/share/classes/java/lang/reflect/ReflectPermission.java b/src/share/classes/java/lang/reflect/ReflectPermission.java
index 6570e79224245a0e7e7737416b77ca1ad32ba5cc..2674de47caa69c8ca1dfab70e395f7c5e5881c27 100644
--- a/src/share/classes/java/lang/reflect/ReflectPermission.java
+++ b/src/share/classes/java/lang/reflect/ReflectPermission.java
@@ -31,7 +31,6 @@ package java.lang.reflect;
* The following table
* provides a summary description of what the permission allows,
* and discusses the risks of granting code the permission.
- *
*
*
*
diff --git a/src/share/classes/java/net/DatagramSocket.java b/src/share/classes/java/net/DatagramSocket.java
index ab60a263ac7479bdb4dad34fea89246d11cd8e5c..9f269ffd6600076d623f578c17086e05abbe0e1f 100644
--- a/src/share/classes/java/net/DatagramSocket.java
+++ b/src/share/classes/java/net/DatagramSocket.java
@@ -196,7 +196,7 @@ class DatagramSocket implements java.io.Closeable {
* socket address.
*
* If, if the address is {@code null}, creates an unbound socket.
- *
+ *
*
If there is a security manager,
* its {@code checkListen} method is first called
* with the port from the socket address
@@ -1109,7 +1109,7 @@ class DatagramSocket implements java.io.Closeable {
* represent the value of the TOS octet in IP packets sent by
* the socket.
* RFC 1349 defines the TOS values as follows:
- *
+ *
*
* IPTOS_LOWCOST (0x02)IPTOS_RELIABILITY (0x04)
*
- *
+ *
*
*
* The textual representation of IPv6 addresses as described above can be
@@ -150,11 +150,11 @@ import java.util.Arrays;
*
*
The general format for specifying the scope_id is the following:
*
- *
IPv6-address%scope_id
+ * IPv6-address%scope_id
* The IPv6-address is a literal IPv6 address as described above.
* The scope_id refers to an interface on the local system, and it can be
* specified in two ways.
- *
- As a numeric identifier. This must be a positive integer
+ *
- As a numeric identifier. This must be a positive integer
* that identifies the particular interface and scope as understood by the
* system. Usually, the numeric values can be determined through administration
* tools on the system. Each interface may have multiple values, one for each
diff --git a/src/share/classes/java/net/MulticastSocket.java b/src/share/classes/java/net/MulticastSocket.java
index 9c5cb05acbb9427168bb927705c53140ff45e1bc..1d42dfe6e87ebb3c4e6f6e64675ada1dca5fa862 100644
--- a/src/share/classes/java/net/MulticastSocket.java
+++ b/src/share/classes/java/net/MulticastSocket.java
@@ -140,7 +140,7 @@ class MulticastSocket extends DatagramSocket {
* Create a MulticastSocket bound to the specified socket address.
*
* Or, if the address is {@code null}, create an unbound socket.
- *
+ *
*
If there is a security manager,
* its {@code checkListen} method is first called
* with the SocketAddress port as its argument to ensure the operation is allowed.
diff --git a/src/share/classes/java/net/NetPermission.java b/src/share/classes/java/net/NetPermission.java
index cf7cbd2af67db617a19fb11a6b768f9186ced3f8..9178f3487232751f579f7ee735ec710431d8f486 100644
--- a/src/share/classes/java/net/NetPermission.java
+++ b/src/share/classes/java/net/NetPermission.java
@@ -46,7 +46,6 @@ import java.util.StringTokenizer;
* The following table lists all the possible NetPermission target names,
* and for each provides a description of what the permission allows
* and a discussion of the risks of granting code the permission.
- *
*
*
*
diff --git a/src/share/classes/java/net/Proxy.java b/src/share/classes/java/net/Proxy.java
index fe481fadfa2523ec9420eeba8a8ce32f0ef9121a..8ba020ef4846a8910ce661b1cdd02787c4d7ae49 100644
--- a/src/share/classes/java/net/Proxy.java
+++ b/src/share/classes/java/net/Proxy.java
@@ -66,8 +66,8 @@ public class Proxy {
* Used, for instance, to create sockets bypassing any other global
* proxy settings (like SOCKS):
*
- * {@code Socket s = new Socket(Proxy.NO_PROXY);}
- *
+ * {@code Socket s = new Socket(Proxy.NO_PROXY);}
+ *
*/
public final static Proxy NO_PROXY = new Proxy();
diff --git a/src/share/classes/java/net/Socket.java b/src/share/classes/java/net/Socket.java
index 361260351f581bb42a2d5b3c6d0629c34e2c4d60..21cf5aae1330e9f25fe0e2c70ffc6d07a4fc7f23 100644
--- a/src/share/classes/java/net/Socket.java
+++ b/src/share/classes/java/net/Socket.java
@@ -1230,13 +1230,13 @@ class Socket implements java.io.Closeable {
* Generally, the window size can be modified at any time when a socket is
* connected. However, if a receive window larger than 64K is required then
* this must be requested before the socket is connected to the
- * remote peer. There are two cases to be aware of:
+ * remote peer. There are two cases to be aware of:
*
* - For sockets accepted from a ServerSocket, this must be done by calling
* {@link ServerSocket#setReceiveBufferSize(int)} before the ServerSocket
* is bound to a local address.
* - For client sockets, setReceiveBufferSize() must be called before
- * connecting the socket to its remote peer.
+ * connecting the socket to its remote peer.
* @param size the size to which to set the receive buffer
* size. This value must be greater than 0.
*
@@ -1329,7 +1329,7 @@ class Socket implements java.io.Closeable {
* represent the value of the TOS octet in IP packets sent by
* the socket.
* RFC 1349 defines the TOS values as follows:
- *
+ *
*
* IPTOS_LOWCOST (0x02)IPTOS_RELIABILITY (0x04)
* Valid for TCP only: SocketImpl.
- *
+ *
* @see Socket#setTcpNoDelay
* @see Socket#getTcpNoDelay
*/
@@ -155,7 +155,7 @@ public interface SocketOptions {
* This option must be specified in the constructor.
*
* Valid for: SocketImpl, DatagramSocketImpl
- *
+ *
* @see Socket#getLocalAddress
* @see DatagramSocket#getLocalAddress
*/
@@ -186,7 +186,7 @@ public interface SocketOptions {
* want to use other than the system default. Takes/returns an InetAddress.
*
* Valid for Multicast: DatagramSocketImpl
- *
+ *
* @see MulticastSocket#setInterface(InetAddress)
* @see MulticastSocket#getInterface()
*/
diff --git a/src/share/classes/java/net/SocketPermission.java b/src/share/classes/java/net/SocketPermission.java
index e90856eac8ef93150e4e8698d268971b422b9774..1b11437b1aa0e6cacd72465f886639d85d2a77d3 100644
--- a/src/share/classes/java/net/SocketPermission.java
+++ b/src/share/classes/java/net/SocketPermission.java
@@ -779,27 +779,27 @@ public final class SocketPermission extends Permission
* specified permission.
*
* More specifically, this method first ensures that all of the following
- * are true (and returns false if any of them are not):
+ * are true (and returns false if any of them are not):
*
- * - p is an instanceof SocketPermission,
+ *
- p is an instanceof SocketPermission,
*
- p's actions are a proper subset of this
- * object's actions, and
+ * object's actions, and
*
- p's port range is included in this port range. Note:
- * port range is ignored when p only contains the action, 'resolve'.
+ * port range is ignored when p only contains the action, 'resolve'.
*
*
* Then {@code implies} checks each of the following, in order,
- * and for each returns true if the stated condition is true:
+ * and for each returns true if the stated condition is true:
*
* - If this object was initialized with a single IP address and one of p's
- * IP addresses is equal to this object's IP address.
+ * IP addresses is equal to this object's IP address.
*
- If this object is a wildcard domain (such as *.sun.com), and
* p's canonical name (the name without any preceding *)
* ends with this object's canonical host name. For example, *.sun.com
- * implies *.eng.sun.com..
+ * implies *.eng.sun.com.
*
- If this object was not initialized with a single IP address, and one of this
- * object's IP addresses equals one of p's IP addresses.
- *
- If this canonical name equals p's canonical name.
+ * object's IP addresses equals one of p's IP addresses.
+ *
- If this canonical name equals p's canonical name.
*
*
* If none of the above are true, {@code implies} returns false.
diff --git a/src/share/classes/java/net/URI.java b/src/share/classes/java/net/URI.java
index 71c4f6dc5ded9d4c480d026ac492350860260b83..813de5cf453c3ff6643760726315a4d06ce24355 100644
--- a/src/share/classes/java/net/URI.java
+++ b/src/share/classes/java/net/URI.java
@@ -389,20 +389,20 @@ import java.lang.NullPointerException; // for javadoc
* colon following a host name but no port (as in
* {@code http://java.sun.com:} ), and that does not encode characters
* except those that must be quoted, the following identities also hold:
- *
+ *
* new URI(u.getScheme(),
* u.getSchemeSpecificPart(),
* u.getFragment())
* .equals(u)
* in all cases,
- *
+ *
* new URI(u.getScheme(),
* u.getUserInfo(), u.getAuthority(),
* u.getPath(), u.getQuery(),
* u.getFragment())
* .equals(u)
* if u is hierarchical, and
- *
+ *
* new URI(u.getScheme(),
* u.getUserInfo(), u.getHost(), u.getPort(),
* u.getPath(), u.getQuery(),
diff --git a/src/share/classes/java/net/URLConnection.java b/src/share/classes/java/net/URLConnection.java
index b731ac70d90a1a351dc1889fb22723048e0b7f36..785cfc0c9e29c60aa2ec80ca7b67b15192ff88b9 100644
--- a/src/share/classes/java/net/URLConnection.java
+++ b/src/share/classes/java/net/URLConnection.java
@@ -45,7 +45,7 @@ import sun.net.www.MessageHeader;
* application and a URL. Instances of this class can be used both to
* read from and to write to the resource referenced by the URL. In
* general, creating a connection to a URL is a multistep process:
- *
+ *
*
* | {@code openConnection()} |
* {@code connect()} |
|---|
diff --git a/src/share/classes/java/net/URLDecoder.java b/src/share/classes/java/net/URLDecoder.java
index eb5e36e5d82f6ef57dbe04d82fcbd9b62e9d3220..acf10e98244520ac729b5a02e469c3360e76d1b5 100644
--- a/src/share/classes/java/net/URLDecoder.java
+++ b/src/share/classes/java/net/URLDecoder.java
@@ -43,7 +43,7 @@ import java.io.*;
* as the start of a special escaped sequence.
*
* The following rules are applied in the conversion:
- *
+ *
*