Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8292567

Add reference to the java.nio.file package in java.nio package documentation

XMLWordPrintable

    • Icon: CSR CSR
    • Resolution: Approved
    • Icon: P4 P4
    • 20
    • core-libs
    • None
    • behavioral
    • minimal
    • Adds non-normative description only.
    • Java API
    • SE

      Summary

      Add reference to the java.nio.file package in java.nio package documentation

      Problem

      The current subpackage description is

      The charset API is defined in the java.nio.charset package, and the channel and selector APIs are defined in the java.nio.channels package

      with no reference to java.nio.file.

      Solution

      Append

      and the file, file attribute, and file system APIs in the java.nio.file package

      to the sentence cited in the problem section above.

      Specification

      @@ -50,15 +50,21 @@
        *   href="channels/package-summary.html#multiplex">multiplexed,
        *   non-blocking <br> I/O</a> facility.  </p></li>
        *
      + *   <li><p> <a
      + *   href="file/Path.html"><i>Path</i></a>,
      + *   which together with the <a href="file/Files.html"><i>Files</i></a>
      + *   class provides access to files.  </p></li>
      + *
        *  </ul>
        *
        * <p> The {@code java.nio} package defines the buffer classes, which
        * are used throughout the NIO APIs.  The charset API is defined in
      - * the {@link java.nio.charset} package, and the channel and selector
      - * APIs are defined in the {@link java.nio.channels} package.  Each of
      - * these subpackages has its own service-provider (SPI) subpackage,
      - * the contents of which can be used to extend the platform's default
      - * implementations or to construct alternative implementations.
      + * the {@link java.nio.charset} package, the channel and selector APIs
      + * in the {@link java.nio.channels} package, and the files and path APIs
      + * in the {@link java.nio.file} package.  Each of these subpackages has
      + * its own service-provider interface (SPI) subpackage, the contents of
      + * which can be used to extend the platform's default implementations or
      + * to construct alternative implementations.
        *
        * <a id="buffers"> </a>
        *

            bpb Brian Burkhalter
            bpb Brian Burkhalter
            Alan Bateman, Iris Clark
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: