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

Javadoc for PrintStream is now incorrect

    XMLWordPrintable

    Details

    • Type: CSR
    • Status: Closed
    • Priority: P4
    • Resolution: Approved
    • Fix Version/s: 14
    • Component/s: core-libs
    • Labels:
      None
    • Subcomponent:
    • Compatibility Kind:
      behavioral
    • Compatibility Risk:
      minimal
    • Compatibility Risk Description:
      The change is to improve API documentation to clarify existing behavior so there is no compatibility risk.
    • Interface Kind:
      Java API
    • Scope:
      SE

      Description

      Summary

      Improve specification of when the default versus a specified encoding is used to convert characters to bytes when writing using java.io.PrintStream.

      Problem

      When characters are written to a java.io.PrintStream they are converted to bytes using either a specified encoding or the default platform encoding if no encoding is given. The documentation of when which encoding is used is not comprehensive and is even self-contradictory in places.

      Solution

      Update API documentation to clarify when a specified versus the platform default encoding is used.

      Specification

      Please see the webrev in the attached archive 8131664.01.zip.

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              bpb Brian Burkhalter
              Reporter:
              webbuggrp Webbug Group
              Reviewed By:
              Lance Andersen
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved: