# HG changeset patch # User jjg # Date 1502403677 25200 # Node ID 047bdc4d771d2e99edce877e309fdf76248557cf # Parent b3e220a04d3f8ea9e09dce2d336e2871c2314f1d 8185994: Fix a11y and HTML issues in the java.base/java.io and java.base/java.nio packages Reviewed-by: bpb, smarks diff -r b3e220a04d3f -r 047bdc4d771d jdk/src/java.base/share/classes/java/io/DataInput.java --- a/jdk/src/java.base/share/classes/java/io/DataInput.java Wed Aug 09 17:40:38 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/io/DataInput.java Thu Aug 10 15:21:17 2017 -0700 @@ -54,83 +54,90 @@ * Unicode strings in a format that is a slight modification of UTF-8. * (For information regarding the standard UTF-8 format, see section * 3.9 Unicode Encoding Forms of The Unicode Standard, Version - * 4.0). - * Note that in the following table, the most significant bit appears in the - * far left-hand column. + * 4.0) * - *

- * - * - * + *
+ *
Characters in the range {@code '\u005Cu0001'} to + * {@code '\u005Cu007F'} are represented by a single byte. + *
The null character {@code '\u005Cu0000'} and characters + * in the range {@code '\u005Cu0080'} to {@code '\u005Cu07FF'} are + * represented by a pair of bytes. + *
Characters in the range {@code '\u005Cu0800'} + * to {@code '\u005CuFFFF'} are represented by three bytes. + *
+ * + *
Bit values and bytes
+ * + * * - * + * + * + * * * - * - * - * + * + * + * + * + * + * + * + * + * + * + * + * * - * + * + * * * - * - * - * - * - * - * - * - * + * + * * - * - * - * * - * + * + * + * * - * - * - * - * - * + * + * * * - * + * + * * * - * + * + * * * *
Encoding of UTF-8 values
- * All characters in the range {@code '\u005Cu0001'} to - * {@code '\u005Cu007F'} are represented by a single byte: Value Byte Bit Values
Bit Values
7 6 5 4 3 2 1 0
Byte 1 + * {@code \u005Cu0001} to {@code \u005Cu007F} 1 0 - * bits 6-0 + * bits 6-0 *
- * The null character {@code '\u005Cu0000'} and characters - * in the range {@code '\u005Cu0080'} to {@code '\u005Cu07FF'} are - * represented by a pair of bytes:
Bit Values
Byte 1 + * {@code \u005Cu0000},
+ * {@code \u005Cu0080} to {@code \u005Cu07FF} 1 1 * 1 * 0 - * bits 10-6 - *
Byte 2 1 - * 0 - * bits 5-0 + * bits 10-6 *
- * {@code char} values in the range {@code '\u005Cu0800'} - * to {@code '\u005CuFFFF'} are represented by three bytes: 2 1 + * 0 + * bits 5-0 *
Bit Values
Byte 1 + * {@code \u005Cu0800} to {@code \u005CuFFFF} 1 1 * 1 * 1 * 0 - * bits 15-12 + * bits 15-12 *
Byte 2 2 1 * 0 - * bits 11-6 + * bits 11-6 *
Byte 3 3 1 * 0 - * bits 5-0 + * bits 5-0 *
- *

Encoding of UTF-8 values
- * All characters in the range {@code '\u005Cu0001'} to - * {@code '\u005Cu007F'} are represented by a single byte:	Value	Byte	Bit Values
Byte 1	+ * {@code \u005Cu0001} to {@code \u005Cu007F}	1	0 - *	bits 6-0 + *	bits 6-0 *
- * The null character {@code '\u005Cu0000'} and characters - * in the range {@code '\u005Cu0080'} to {@code '\u005Cu07FF'} are - * represented by a pair of bytes:
	Bit Values
Byte 1	+ * {@code \u005Cu0000}, + * {@code \u005Cu0080} to {@code \u005Cu07FF}	1	1 *	1 *	0 - *	bits 10-6 - *
Byte 2	1 - *	0 - *	bits 5-0 + *	bits 10-6 *
- * {@code char} values in the range {@code '\u005Cu0800'} - * to {@code '\u005CuFFFF'} are represented by three bytes:	2	1 + *	0 + *	bits 5-0 *
	Bit Values
Byte 1	+ * {@code \u005Cu0800} to {@code \u005CuFFFF}	1	1 *	1 *	1 *	0 - *	bits 15-12 + *	bits 15-12 *
Byte 2	2	1 *	0 - *	bits 11-6 + *	bits 11-6 *
Byte 3	3	1 *	0 - *	bits 5-0 + *	bits 5-0 *

+ * *

* The differences between this format and the * standard UTF-8 format are the following: diff -r b3e220a04d3f -r 047bdc4d771d jdk/src/java.base/share/classes/java/nio/channels/package-info.java --- a/jdk/src/java.base/share/classes/java/nio/channels/package-info.java Wed Aug 09 17:40:38 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/nio/channels/package-info.java Thu Aug 10 15:21:17 2017 -0700 @@ -30,46 +30,50 @@ * * * - *

+ *
* - * - * - * + * + * + * + * + * + * * - * + * * - * - * - * + * + * + * * - * - * - * - * - * + * + * + * + * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - *
Lists channels and their descriptions
Channels Description
{@link java.nio.channels.Channel}
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}   Can read into a sequence of buffers
- *   {@link java.nio.channels.WritableByteChannel}
+ * {@link java.nio.channels.ScatteringByteChannel} Can read into a sequence of buffers
+ * {@link java.nio.channels.WritableByteChannel} Can write from a buffer
- *     {@link java.nio.channels.GatheringByteChannel} Can write from a sequence of buffers
- *   {@link java.nio.channels.ByteChannel} Can read/write to/from a buffer
- *     {@link java.nio.channels.SeekableByteChannel}
+ * {@link java.nio.channels.GatheringByteChannel} Can write from a sequence of buffers
+ * {@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.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

Lists channels and their descriptions
Channels	Description
Channels	Description
{@link java.nio.channels.Channel}
{@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}	Can read into a sequence of buffers
- * {@link java.nio.channels.WritableByteChannel}
+ * {@link java.nio.channels.ScatteringByteChannel}	Can read into a sequence of buffers
+ * {@link java.nio.channels.WritableByteChannel}	Can write from a buffer
- * {@link java.nio.channels.GatheringByteChannel}	Can write from a sequence of buffers
- * {@link java.nio.channels.ByteChannel}	Can read/write to/from a buffer
- * {@link java.nio.channels.SeekableByteChannel}
+ * {@link java.nio.channels.GatheringByteChannel}	Can write from a sequence of buffers
+ * {@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.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

+ * + * * *

A channel represents an open connection to an entity such as a * hardware device, a file, a network socket, or a program component that is @@ -122,21 +126,25 @@ * be constructed that uses a given charset to encode characters into bytes and * write them to a given writable byte channel. * - *

+ *
* - * - * - * + * + * + * + * + * + * * - * + * * - * - * - *
* Lists file channels and their descriptions
File channels Description
- * {@link java.nio.channels.FileChannel}
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} A direct byte buffer mapped to a region of a file

* Lists file channels and their descriptions
File channels	Description
File channels	Description
- * {@link java.nio.channels.FileChannel}
+ * {@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}	A direct byte buffer mapped to a region of a file

+ * + * {@link java.nio.MappedByteBuffer} + * A direct byte buffer mapped to a region of a file + * + * * *

The {@link java.nio.channels.FileChannel} class supports the usual * operations of reading bytes from, and writing bytes to, a channel connected to @@ -156,36 +164,40 @@ * class. * * - *

+ *
* - * - * - * + * + * + * + * + * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * - * - * - * - *
* Lists multiplexed, non-blocking channels and their descriptions
Multiplexed, non-blocking I/O Description
{@link java.nio.channels.SelectableChannel}
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} A token representing the registration
of a channel - * with a selector
{@link java.nio.channels.Pipe} Two channels that form a unidirectional pipe

* Lists multiplexed, non-blocking channels and their descriptions
Multiplexed, non-blocking I/O	Description
Multiplexed, non-blocking I/O	Description
{@link java.nio.channels.SelectableChannel}
{@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}	A token representing the registration of a channel - * with a selector
{@link java.nio.channels.Pipe}	Two channels that form a unidirectional pipe

+ * {@link java.nio.channels.SelectionKey} + * A token representing the registration of a channel + * with a selector + * {@link java.nio.channels.Pipe} + * Two channels that form a unidirectional pipe + * + * * *

Multiplexed, non-blocking I/O, which is much more scalable than * thread-oriented, blocking I/O, is provided by selectors, selectable @@ -251,27 +263,31 @@ * * * - *

+ *
* - * - * + * + * + * + * + * + * * - * + * * - * + * * - * + * * - * + * * - *
* Lists asynchronous channels and their descriptions
- * Asynchronous I/O Description
- * {@link java.nio.channels.AsynchronousFileChannel}
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

* Lists asynchronous channels and their descriptions
Asynchronous I/O	Description
- * Asynchronous I/O	Description
- * {@link java.nio.channels.AsynchronousFileChannel}
+ * {@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

+ * + * * *
{@link java.nio.channels.AsynchronousChannel Asynchronous channels} are a * special type of channel capable of asynchronous I/O operations. Asynchronous diff -r b3e220a04d3f -r 047bdc4d771d jdk/src/java.base/share/classes/java/nio/charset/package-info.java --- a/jdk/src/java.base/share/classes/java/nio/charset/package-info.java Wed Aug 09 17:40:38 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/nio/charset/package-info.java Thu Aug 10 15:21:17 2017 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2001, 2010, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2001, 2017, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -27,22 +27,25 @@ * Defines charsets, decoders, and encoders, for translating between * bytes and Unicode characters. * - *
+ *
* - * - * - * - * + * + * + * + * + * + * + * * - * + * * - * + * * - * - * - * - *
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}
Class name Description + *
{@link java.nio.charset.Charset} A named mapping between characters and bytes
{@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} Describes actions to take when
coding errors are detected
+ * {@link java.nio.charset.CodingErrorAction} + * Describes actions to take when coding errors are detected + * + * * *
A charset is named mapping between sequences of * sixteen-bit Unicode characters and sequences of bytes, in the sense diff -r b3e220a04d3f -r 047bdc4d771d jdk/src/java.base/share/classes/java/nio/file/FileSystem.java --- a/jdk/src/java.base/share/classes/java/nio/file/FileSystem.java Wed Aug 09 17:40:38 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/nio/file/FileSystem.java Thu Aug 10 15:21:17 2017 -0700 @@ -314,45 +314,49 @@ * representation of the path is matched using a limited pattern language * that resembles regular expressions but with a simpler syntax. For example: * - *
- * + *
* + * + * + * + * * * - * + * * * * - * + * * * * - * + * * * * - * + * * * * - * * * - * * * - * * * *
Pattern Language
Example + * Description + *
{@code *.java} {@code *.java} Matches a path that represents a file name ending in {@code .java}
{@code *.*} {@code *.*} Matches file names containing a dot
{@code *.{java,class}} {@code *.{java,class}} Matches file names ending with {@code .java} or {@code .class}
{@code foo.?} {@code foo.?} Matches file names starting with {@code foo.} and a single * character extension
/home/*/* + * /home/*/* * Matches /home/gus/data on UNIX platforms
/home/** + * /home/** * Matches /home/gus and * /home/gus/data on UNIX platforms
C:\\* + * C:\\* * Matches C:\foo and C:\bar on the Windows * platform (note that the backslash is escaped; as a string literal in the * Java Language the pattern would be "C:\\\\*")
- *
* *
The following rules are used to interpret glob patterns: * diff -r b3e220a04d3f -r 047bdc4d771d jdk/src/java.base/share/classes/java/nio/file/Files.java --- a/jdk/src/java.base/share/classes/java/nio/file/Files.java Wed Aug 09 17:40:38 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/nio/file/Files.java Thu Aug 10 15:21:17 2017 -0700 @@ -1923,30 +1923,33 @@ *
The following examples demonstrate possible values for the {@code * attributes} parameter: * - *
- * + *
* + * + * + * * * - * + * * * * - * + * * * * - * + * * * * - * + * * * * *
Possible values
Example + * Description + *
{@code "*"} {@code "*"} Read all {@link BasicFileAttributes basic-file-attributes}.
{@code "size,lastModifiedTime,lastAccessTime"} {@code "size,lastModifiedTime,lastAccessTime"} Reads the file size, last modified time, and last access time * attributes.
{@code "posix:*"} {@code "posix:*"} Read all {@link PosixFileAttributes POSIX-file-attributes}.
{@code "posix:permissions,owner,size"} {@code "posix:permissions,owner,size"} Reads the POSIX file permissions, owner, and file size.
- *
* *
The {@code options} array may be used to indicate how symbolic links * are handled for the case that the file is a symbolic link. By default, diff -r b3e220a04d3f -r 047bdc4d771d jdk/src/java.base/share/classes/java/nio/file/attribute/package-info.java --- a/jdk/src/java.base/share/classes/java/nio/file/attribute/package-info.java Wed Aug 09 17:40:38 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/nio/file/attribute/package-info.java Thu Aug 10 15:21:17 2017 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2007, 2017, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -26,43 +26,47 @@ /** * Interfaces and classes providing access to file and file system attributes. * - *
+ *
* - * - * - * + * + * + * + * + * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - * + * * - *
Attribute views
Attribute views Description
{@link java.nio.file.attribute.AttributeView}
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
+ * + * * *
An attribute view provides a read-only or updatable view of the non-opaque * values, or metadata, associated with objects in a file system. diff -r b3e220a04d3f -r 047bdc4d771d jdk/src/java.base/share/classes/java/nio/package-info.java --- a/jdk/src/java.base/share/classes/java/nio/package-info.java Wed Aug 09 17:40:38 2017 -0700 +++ b/jdk/src/java.base/share/classes/java/nio/package-info.java Thu Aug 10 15:21:17 2017 -0700 @@ -48,7 +48,7 @@ *
Selectors and selection keys, which * together with
selectable channels define a multiplexed, - * non-blocking
I/O facility.
+ * non-blocking
I/O facility.
* * * @@ -62,33 +62,44 @@ * * * - *
+ *
* - * - * - * + * + * + * + * + * + * * - * - * - * + * clear, flip, rewind, and mark/reset + * + * + * * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
Description of the various buffers
Buffers Description
{@link java.nio.Buffer}
Buffers Description
{@link java.nio.Buffer} Position, limit, and capacity; - *
clear, flip, rewind, and mark/reset
  {@link java.nio.ByteBuffer} Get/put, compact, views; allocate, wrap
- *     {@link java.nio.MappedByteBuffer}
+ * {@link java.nio.ByteBuffer} Get/put, compact, views; allocate, wrap
+ * {@link java.nio.MappedByteBuffer} A byte buffer mapped to a file
  {@link java.nio.CharBuffer} Get/put, compact; allocate, wrap
  {@link java.nio.DoubleBuffer}     ' '
  {@link java.nio.FloatBuffer}     ' '
  {@link java.nio.IntBuffer}     ' '
  {@link java.nio.LongBuffer}     ' '
  {@link java.nio.ShortBuffer}     ' '
{@link java.nio.ByteOrder} Typesafe enumeration for byte orders
+ * + * {@link java.nio.CharBuffer} + * Get/put, compact; allocate, wrap + * + * {@link java.nio.DoubleBuffer} + * Get/put, compact; allocate, wrap + * + * {@link java.nio.FloatBuffer} + * Get/put, compact; allocate, wrap + * + * {@link java.nio.IntBuffer} + * Get/put, compact; allocate, wrap + * + * {@link java.nio.LongBuffer} + * Get/put, compact; allocate, wrap + * + * {@link java.nio.ShortBuffer} + * Get/put, compact; allocate, wrap + * {@link java.nio.ByteOrder} + * Typesafe enumeration for byte orders + * + * * *
A buffer is a container for a fixed amount of data of a * specific primitive type. In addition to its content a buffer has a

Class name		DescriptiPath - *
{@link java.nio.charset.Charset}	A named mapping between characters and bytes
{@link java.nio.charset.CharsetDecoder}
Class name	Description + *
{@link java.nio.charset.Charset}	A named mapping between characters and bytes
{@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}	Describes actions to take when coding errors are detected

Example + *	Description + *
{@code *.java}	{@code *.java}	Matches a path that represents a file name ending in {@code .java}
{@code .}	{@code .}	Matches file names containing a dot
{@code *.{java,class}}	{@code *.{java,class}}	Matches file names ending with {@code .java} or {@code .class}
{@code foo.?}	{@code foo.?}	Matches file names starting with {@code foo.} and a single * character extension
`/home//` + *	`/home//` *	Matches `/home/gus/data` on UNIX platforms
`/home/*` +	`/home/*`	Matches `/home/gus` and * `/home/gus/data` on UNIX platforms
`C:\\` +	`C:\\`	Matches `C:\foo` and `C:\bar` on the Windows * platform (note that the backslash is escaped; as a string literal in the * Java Language the pattern would be `"C:\\\\*"`)

Example + *	Description + *
{@code "*"}	{@code "*"}	Read all {@link BasicFileAttributes basic-file-attributes}.
{@code "size,lastModifiedTime,lastAccessTime"}	{@code "size,lastModifiedTime,lastAccessTime"}	Reads the file size, last modified time, and last access time * attributes.
{@code "posix:*"}	{@code "posix:*"}	Read all {@link PosixFileAttributes POSIX-file-attributes}.
{@code "posix:permissions,owner,size"}	{@code "posix:permissions,owner,size"}	Reads the POSIX file permissions, owner, and file size.

Attribute views	Description
{@link java.nio.file.attribute.AttributeView}
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

Buffers	Description
{@link java.nio.Buffer}
Buffers	Description
{@link java.nio.Buffer}	Position, limit, and capacity; - * clear, flip, rewind, and mark/reset
{@link java.nio.ByteBuffer}	Get/put, compact, views; allocate, wrap
- * {@link java.nio.MappedByteBuffer}
+ * {@link java.nio.ByteBuffer}	Get/put, compact, views; allocate, wrap
+ * {@link java.nio.MappedByteBuffer}	A byte buffer mapped to a file
{@link java.nio.CharBuffer}	Get/put, compact; allocate, wrap
{@link java.nio.DoubleBuffer}	' '
{@link java.nio.FloatBuffer}	' '
{@link java.nio.IntBuffer}	' '
{@link java.nio.LongBuffer}	' '
{@link java.nio.ShortBuffer}	' '
{@link java.nio.ByteOrder}	Typesafe enumeration for byte orders