| other |
* The Unicode characters that are not in the US-ASCII character set,
* are not control characters (according to the {@link
* java.lang.Character#isISOControl(char) Character.isISOControl}
diff --git a/jdk/src/java.base/share/classes/java/nio/channels/package-info.java b/jdk/src/java.base/share/classes/java/nio/channels/package-info.java
index 57ab6322be0..d29ae67590f 100644
--- a/jdk/src/java.base/share/classes/java/nio/channels/package-info.java
+++ b/jdk/src/java.base/share/classes/java/nio/channels/package-info.java
@@ -30,31 +30,44 @@
*
*
*
- *
- * | Channels | Description |
|---|
- * | {@link java.nio.channels.Channel} |
+ *
+ * Lists channels and their descriptions
+ * | Channels |
+ * Description |
|---|
+ * | {@link java.nio.channels.Channel} |
* A nexus for I/O operations |
- * | {@link java.nio.channels.ReadableByteChannel} |
+ * |
+ * {@link java.nio.channels.ReadableByteChannel} |
* Can read into a buffer |
- * | {@link java.nio.channels.ScatteringByteChannel} |
+ * |
+ * {@link java.nio.channels.ScatteringByteChannel} |
* Can read into a sequence of buffers |
- * | {@link java.nio.channels.WritableByteChannel} |
+ * |
+ * {@link java.nio.channels.WritableByteChannel} |
* Can write from a buffer |
- * | {@link java.nio.channels.GatheringByteChannel} |
+ * |
+ * {@link java.nio.channels.GatheringByteChannel} |
* Can write from a sequence of buffers |
- * | {@link java.nio.channels.ByteChannel} |
+ * |
+ * {@link java.nio.channels.ByteChannel} |
* Can read/write to/from a buffer |
- * | {@link java.nio.channels.SeekableByteChannel} |
- * A {@code ByteChannel} connected to an entity that contains a variable-length sequence of bytes |
- * | {@link java.nio.channels.AsynchronousChannel} |
+ * |
+ * {@link java.nio.channels.SeekableByteChannel} |
+ * A {@code ByteChannel} connected to an entity that contains a variable-length
+ * sequence of bytes |
+ * |
+ * {@link java.nio.channels.AsynchronousChannel} |
* Supports asynchronous I/O operations. |
- * | {@link java.nio.channels.AsynchronousByteChannel} |
+ * |
+ * {@link java.nio.channels.AsynchronousByteChannel} |
* Can read and write bytes asynchronously |
- * | {@link java.nio.channels.NetworkChannel} |
+ * |
+ * {@link java.nio.channels.NetworkChannel} |
* A channel to a network socket |
- * | {@link java.nio.channels.MulticastChannel} |
+ * |
+ * {@link java.nio.channels.MulticastChannel} |
* Can join Internet Protocol (IP) multicast groups |
- * | {@link java.nio.channels.Channels} |
+ * | {@link java.nio.channels.Channels} |
* Utility methods for channel/stream interoperation |
*
*
@@ -109,13 +122,19 @@
* be constructed that uses a given charset to encode characters into bytes and
* write them to a given writable byte channel.
*
- *
- * | File channels | Description |
|---|
- * | {@link java.nio.channels.FileChannel} |
+ *
+ *
+ * Lists file channels and their descriptions
+ * | File channels |
+ * Description |
|---|
+ * |
+ * {@link java.nio.channels.FileChannel} |
* Reads, writes, maps, and manipulates files |
- * | {@link java.nio.channels.FileLock} |
+ * |
+ * {@link java.nio.channels.FileLock} |
* A lock on a (region of a) file |
- * | {@link java.nio.MappedByteBuffer} |
+ * |
+ * {@link java.nio.MappedByteBuffer} |
* A direct byte buffer mapped to a region of a file |
*
*
@@ -137,26 +156,34 @@
* class.
*
*
- *
- * | Multiplexed, non-blocking I/O | Description |
|---|
- * | {@link java.nio.channels.SelectableChannel} |
+ *
+ *
+ * Lists multiplexed, non-blocking channels and their descriptions
+ * | Multiplexed, non-blocking I/O |
+ * Description |
|---|
+ * | {@link java.nio.channels.SelectableChannel} |
* A channel that can be multiplexed |
- * | {@link java.nio.channels.DatagramChannel} |
+ * |
+ * {@link java.nio.channels.DatagramChannel} |
* A channel to a datagram-oriented socket |
- * | {@link java.nio.channels.Pipe.SinkChannel} |
+ * |
+ * {@link java.nio.channels.Pipe.SinkChannel} |
* The write end of a pipe |
- * | {@link java.nio.channels.Pipe.SourceChannel} |
+ * |
+ * {@link java.nio.channels.Pipe.SourceChannel} |
* The read end of a pipe |
- * | {@link java.nio.channels.ServerSocketChannel} |
+ * |
+ * {@link java.nio.channels.ServerSocketChannel} |
* A channel to a stream-oriented listening socket |
- * | {@link java.nio.channels.SocketChannel} |
+ * |
+ * {@link java.nio.channels.SocketChannel} |
* A channel for a stream-oriented connecting socket |
- * | {@link java.nio.channels.Selector} |
+ * | {@link java.nio.channels.Selector} |
* A multiplexor of selectable channels |
- * | {@link java.nio.channels.SelectionKey} |
+ * | {@link java.nio.channels.SelectionKey} |
* A token representing the registration
of a channel
* with a selector |
- * | {@link java.nio.channels.Pipe} |
+ * | {@link java.nio.channels.Pipe} |
* Two channels that form a unidirectional pipe |
*
*
@@ -224,17 +251,25 @@
*
*
*
- *
- * | Asynchronous I/O | Description |
|---|
- * | {@link java.nio.channels.AsynchronousFileChannel} |
+ *
+ *
+ * Lists asynchronous channels and their descriptions
+ * |
+ * Asynchronous I/O | Description |
|---|
+ * |
+ * {@link java.nio.channels.AsynchronousFileChannel} |
* An asynchronous channel for reading, writing, and manipulating a file |
- * | {@link java.nio.channels.AsynchronousSocketChannel} |
+ * |
+ * {@link java.nio.channels.AsynchronousSocketChannel} |
* An asynchronous channel to a stream-oriented connecting socket |
- * | {@link java.nio.channels.AsynchronousServerSocketChannel} |
+ * |
+ * {@link java.nio.channels.AsynchronousServerSocketChannel} |
* An asynchronous channel to a stream-oriented listening socket |
- * | {@link java.nio.channels.CompletionHandler} |
+ * |
+ * {@link java.nio.channels.CompletionHandler} |
* A handler for consuming the result of an asynchronous operation |
- * | {@link java.nio.channels.AsynchronousChannelGroup} |
+ * |
+ * {@link java.nio.channels.AsynchronousChannelGroup} |
* A grouping of asynchronous channels for the purpose of resource sharing |
*
*
@@ -277,7 +312,6 @@
* so that sophisticated users can take advantage of operating-system-specific
* asynchronous I/O mechanisms when very high performance is required.
*
- *
* Unless otherwise noted, passing a {@code null} argument to a constructor
* or method in any class or interface in this package will cause a {@link
* java.lang.NullPointerException NullPointerException} to be thrown.
diff --git a/jdk/src/java.base/share/classes/java/nio/charset/package-info.java b/jdk/src/java.base/share/classes/java/nio/charset/package-info.java
index 9d93a710a25..80141dc8b6a 100644
--- a/jdk/src/java.base/share/classes/java/nio/charset/package-info.java
+++ b/jdk/src/java.base/share/classes/java/nio/charset/package-info.java
@@ -27,17 +27,19 @@
* Defines charsets, decoders, and encoders, for translating between
* bytes and Unicode characters.
*
- *
- * | Class name | Description |
|---|
- * | {@link java.nio.charset.Charset} |
+ *
+ * Summary of charsets, decoders, and encoders in this package
+ * | Class name |
+ * | DescriptiPath
+ * |
|---|
| {@link java.nio.charset.Charset} |
* A named mapping between characters
and bytes |
- * | {@link java.nio.charset.CharsetDecoder} |
+ * | {@link java.nio.charset.CharsetDecoder} |
* Decodes bytes into characters |
- * | {@link java.nio.charset.CharsetEncoder} |
+ * | {@link java.nio.charset.CharsetEncoder} |
* Encodes characters into bytes |
- * | {@link java.nio.charset.CoderResult} |
+ * | {@link java.nio.charset.CoderResult} |
* Describes coder results |
- * | {@link java.nio.charset.CodingErrorAction} |
+ * | {@link java.nio.charset.CodingErrorAction} |
* Describes actions to take when
coding errors are detected |
*
*
diff --git a/jdk/src/java.base/share/classes/java/nio/file/attribute/package-info.java b/jdk/src/java.base/share/classes/java/nio/file/attribute/package-info.java
index 1dd20f627c7..11f5d6e2720 100644
--- a/jdk/src/java.base/share/classes/java/nio/file/attribute/package-info.java
+++ b/jdk/src/java.base/share/classes/java/nio/file/attribute/package-info.java
@@ -26,25 +26,41 @@
/**
* Interfaces and classes providing access to file and file system attributes.
*
- *
- * | Attribute views | Description |
|---|
- * | {@link java.nio.file.attribute.AttributeView} |
+ *
+ * Attribute views
+ * | Attribute views |
+ * Description |
|---|
+ * | {@link java.nio.file.attribute.AttributeView} |
* Can read or update non-opaque values associated with objects in a file system |
- * | {@link java.nio.file.attribute.FileAttributeView} |
+ * |
+ * {@link java.nio.file.attribute.FileAttributeView} |
* Can read or update file attributes |
- * | {@link java.nio.file.attribute.BasicFileAttributeView} |
+ * |
+ *
+ * {@link java.nio.file.attribute.BasicFileAttributeView} |
* Can read or update a basic set of file attributes |
- * | {@link java.nio.file.attribute.PosixFileAttributeView} |
+ * |
+ *
+ * {@link java.nio.file.attribute.PosixFileAttributeView} |
* Can read or update POSIX defined file attributes |
- * | {@link java.nio.file.attribute.DosFileAttributeView} |
+ * |
+ *
+ * {@link java.nio.file.attribute.DosFileAttributeView} |
* Can read or update FAT file attributes |
- * | {@link java.nio.file.attribute.FileOwnerAttributeView} |
+ * |
+ *
+ * {@link java.nio.file.attribute.FileOwnerAttributeView} |
* Can read or update the owner of a file |
- * | {@link java.nio.file.attribute.AclFileAttributeView} |
+ * |
+ *
+ * {@link java.nio.file.attribute.AclFileAttributeView} |
* Can read or update Access Control Lists |
- * | {@link java.nio.file.attribute.UserDefinedFileAttributeView} |
+ * |
+ *
+ * {@link java.nio.file.attribute.UserDefinedFileAttributeView} |
* Can read or update user-defined file attributes |
- * | {@link java.nio.file.attribute.FileStoreAttributeView} |
+ * |
+ * {@link java.nio.file.attribute.FileStoreAttributeView} |
* Can read or update file system attributes |
*
*
diff --git a/jdk/src/java.base/share/classes/java/nio/package-info.java b/jdk/src/java.base/share/classes/java/nio/package-info.java
index 595a21ed390..9fa17c945e0 100644
--- a/jdk/src/java.base/share/classes/java/nio/package-info.java
+++ b/jdk/src/java.base/share/classes/java/nio/package-info.java
@@ -62,28 +62,31 @@
*
*
*
- *
- * | Buffers | Description |
|---|
- * | {@link java.nio.Buffer} |
+ *
+ * Description of the various buffers
+ * | Buffers |
+ * Description |
|---|
+ * | {@link java.nio.Buffer} |
* Position, limit, and capacity;
*
clear, flip, rewind, and mark/reset |
- * | {@link java.nio.ByteBuffer} |
+ * | {@link java.nio.ByteBuffer} |
* Get/put, compact, views; allocate, wrap |
- * | {@link java.nio.MappedByteBuffer} |
+ * |
+ * {@link java.nio.MappedByteBuffer} |
* A byte buffer mapped to a file |
- * | {@link java.nio.CharBuffer} |
+ * | {@link java.nio.CharBuffer} |
* Get/put, compact; allocate, wrap |
- * | {@link java.nio.DoubleBuffer} |
+ * | {@link java.nio.DoubleBuffer} |
* ' ' |
- * | {@link java.nio.FloatBuffer} |
+ * | {@link java.nio.FloatBuffer} |
* ' ' |
- * | {@link java.nio.IntBuffer} |
+ * | {@link java.nio.IntBuffer} |
* ' ' |
- * | {@link java.nio.LongBuffer} |
+ * | {@link java.nio.LongBuffer} |
* ' ' |
- * | {@link java.nio.ShortBuffer} |
+ * | {@link java.nio.ShortBuffer} |
* ' ' |
- * | {@link java.nio.ByteOrder} |
+ * | {@link java.nio.ByteOrder} |
* Typesafe enumeration for byte orders |
*
*
diff --git a/jdk/src/java.base/share/classes/java/util/spi/CalendarNameProvider.java b/jdk/src/java.base/share/classes/java/util/spi/CalendarNameProvider.java
index 396ffeae696..004aab08f9a 100644
--- a/jdk/src/java.base/share/classes/java/util/spi/CalendarNameProvider.java
+++ b/jdk/src/java.base/share/classes/java/util/spi/CalendarNameProvider.java
@@ -46,7 +46,7 @@ import java.util.Map;
* Calendar}. The following are calendar-common fields and their values to be
* supported for each calendar system.
*
- *
+ *
* Field values
*
*
@@ -57,8 +57,8 @@ import java.util.Map;
*
*
*
- * | {@link Calendar#MONTH} |
- * {@link Calendar#JANUARY} to {@link Calendar#UNDECIMBER} |
+ * {@link Calendar#MONTH} |
+ * {@link Calendar#JANUARY} to {@link Calendar#UNDECIMBER} |
* Month numbering is 0-based (e.g., 0 - January, ..., 11 -
* December). Some calendar systems have 13 months. Month
* names need to be supported in both the formatting and
@@ -67,14 +67,14 @@ import java.util.Map;
* in both of the forms. |
*
*
- * | {@link Calendar#DAY_OF_WEEK} |
- * {@link Calendar#SUNDAY} to {@link Calendar#SATURDAY} |
+ * {@link Calendar#DAY_OF_WEEK} |
+ * {@link Calendar#SUNDAY} to {@link Calendar#SATURDAY} |
* Day-of-week numbering is 1-based starting from Sunday (i.e., 1 - Sunday,
* ..., 7 - Saturday). |
*
*
- * | {@link Calendar#AM_PM} |
- * {@link Calendar#AM} to {@link Calendar#PM} |
+ * {@link Calendar#AM_PM} |
+ * {@link Calendar#AM} to {@link Calendar#PM} |
* 0 - AM, 1 - PM |
*
*
@@ -82,7 +82,7 @@ import java.util.Map;
*
* The following are calendar-specific fields and their values to be supported.
*
- *
+ *
* Calendar type and field values
*
*
@@ -94,8 +94,8 @@ import java.util.Map;
*
*
*
- * | {@code "gregory"} |
- * {@link Calendar#ERA} |
+ * {@code "gregory"} |
+ * {@link Calendar#ERA} |
* 0 |
* {@link java.util.GregorianCalendar#BC} (BCE) |
*
@@ -104,8 +104,8 @@ import java.util.Map;
* {@link java.util.GregorianCalendar#AD} (CE) |
*
*
- * | {@code "buddhist"} |
- * {@link Calendar#ERA} |
+ * {@code "buddhist"} |
+ * {@link Calendar#ERA} |
* 0 |
* BC (BCE) |
*
@@ -114,8 +114,8 @@ import java.util.Map;
* B.E. (Buddhist Era) |
*
*
- * | {@code "japanese"} |
- * {@link Calendar#ERA} |
+ * {@code "japanese"} |
+ * {@link Calendar#ERA} |
* 0 |
* Seireki (Before Meiji) |
*
@@ -144,8 +144,8 @@ import java.util.Map;
* Year representation in {@code SimpleDateFormat}.
*
*
- * | {@code "roc"} |
- * {@link Calendar#ERA} |
+ * {@code "roc"} |
+ * {@link Calendar#ERA} |
* 0 |
* Before R.O.C. |
*
@@ -154,8 +154,8 @@ import java.util.Map;
* R.O.C. |
*
*
- * | {@code "islamic"} |
- * {@link Calendar#ERA} |
+ * {@code "islamic"} |
+ * {@link Calendar#ERA} |
* 0 |
* Before AH |
*
|
|---|