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

isStandalone property: remove dependency on pretty-print

    XMLWordPrintable

    Details

    • Type: CSR
    • Status: Closed
    • Priority: P4
    • Resolution: Approved
    • Fix Version/s: 17
    • Component/s: xml
    • Labels:
      None
    • Subcomponent:
    • Compatibility Risk:
      minimal
    • Compatibility Risk Description:
      No compatibility risk. The change is to be made to a property introduced within the same release.
    • Interface Kind:
      Other
    • Scope:
      JDK

      Description

      Summary

      Change the behavior of the isStandalone property so that it takes effect regardless of the settings of the pretty-print property.

      Problem

      The new implementation specific property isStandalone added through JDK-8249867 required the property format-pretty-print to be true. However, there are cases where applications want the serializer to produce an output with a newline after the header but without setting the pretty-print property.

      Solution

      Remove the dependency on the pretty-print property.

      Specification

      In the implementation note of the module summary (java.xml/module-info.java), specifically in table Features and Properties, remove "when the property format-pretty-print is set to true" from the property description, thus changing it from:

      indicates that the serializer should treat the output as a standalone document. The property can be used to ensure a newline is written after the XML declaration when the property format-pretty-print is set to true. Unlike the property xml-declaration, this property does not have an effect on whether an XML declaration should be written out.

      to:

      indicates that the serializer should treat the output as a standalone document. The property can be used to ensure a newline is written after the XML declaration. Unlike the property xml-declaration, this property does not have an effect on whether an XML declaration should be written out.


      Attached: spec_01_8261209.zip

      Convenient link: http://cr.openjdk.java.net/~joehw/jdk17/8261209/spec_01/java.xml/module-summary.html

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              joehw Joe Wang
              Reporter:
              joehw Joe Wang
              Reviewed By:
              Lance Andersen
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved: