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

Fix command-line help text for javac -target

    Details

    • Type: CSR
    • Status: Closed
    • Priority: P3
    • Resolution: Approved
    • Fix Version/s: 13
    • Component/s: tools
    • Labels:
      None
    • Subcomponent:
    • Compatibility Kind:
      behavioral
    • Compatibility Risk:
      minimal
    • Compatibility Risk Description:
      Just updating the command-line help for consistency.
    • Interface Kind:
      Other

      Description

      Summary

      Make the javac command-line help for --source, --target, and --release self-consistent and consistent with the man page.

      Problem

      The --target option still uses "versions" terminology instead of the now-agreed "releases" terminology. In addition, the --source, --target and --release options are stylistically inconsistent.

      Solution

      Update the text.

      Specification

      Previous:

        --release <release>
              Compile for a specific release. Supported releases: 7, 8, 9, 10, 11, 12, 13
        --source <release>, -source <release>
              Provide source compatibility with specified release. Supported releases: 7, 8, 9, 10, 11, 12, 13
        --target <release>, -target <release>
              Generate class files for specific VM version. Supported versions: 7, 8, 9, 10, 11, 12, 13

      Proposed:

        --release <release>
              Compile for the specified Java SE release. Supported releases: 7, 8, 9, 10, 11, 12, 13
        --source <release>, -source <release>
              Provide source compatibility with the specified Java SE release. Supported releases: 7, 8, 9, 10, 11, 12, 13
        --target <release>, -target <release>
              Generate class files suitable for the specified Java SE release. Supported releases: 7, 8, 9, 10, 11, 12, 13
      

      Note: the set of supported releases for an option is generated dynamically, and will be different for different releases of the JDK.

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                jjg Jonathan Gibbons
                Reporter:
                jjg Jonathan Gibbons
                Reviewed By:
                Alex Buckley
              • Votes:
                0 Vote for this issue
                Watchers:
                1 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: