8263481: Specification of JComponent::setDefaultLocale doesn't mention that passing 'null' restores VM's default locale

[prsadhuk]

The current state of specification for
https://docs.oracle.com/en/java/javase/15/docs/api/java.desktop/javax/swing/JComponent.html#setDefaultLocale(java.util.Locale)
doesn't mention anything about passing 'null' as a new default locale.

In fact for OpenJDK implementation passing 'null' restores the default VM's locale.
This is now explicitly stated in javadoc.

---

Progress

• Change must not contain extraneous whitespace
• Commit message must refer to an issue
• Change must be properly reviewed

Issue

• JDK-8263481: Specification of JComponent::setDefaultLocale doesn't mention that passing 'null' restores VM's default locale

Reviewers

• Alexey Ivanov (@aivanov-jdk - Reviewer)

Download

To checkout this PR locally:
$ git fetch https://git.openjdk.java.net/jdk pull/3003/head:pull/3003
$ git checkout pull/3003

To update a local copy of the PR:
$ git checkout pull/3003
$ git pull https://git.openjdk.java.net/jdk pull/3003/head

[bridgekeeper]

👋 Welcome back psadhukhan! A progress list of the required criteria for merging this PR into master will be added to the body of your pull request. There are additional pull request commands available for use with this pull request.

[openjdk]

@prsadhuk The following label will be automatically applied to this pull request:

• swing

When this pull request is ready to be reviewed, an "RFR" email will be sent to the corresponding mailing list. If you would like to change these labels, use the /label pull request command.

[mlbridge]

Webrevs

• 01: Full - Incremental (d35284f)
• 00: Full (acc270e)

[openjdk]

@prsadhuk This change now passes all automated pre-integration checks.

ℹ️ This project also has non-automated pre-integration requirements. Please see the file CONTRIBUTING.md for details.

After integration, the commit message for the final commit will be:

8263481: Specification of JComponent::setDefaultLocale doesn't mention that passing 'null' restores VM's default locale

Reviewed-by: aivanov

You can use pull request commands such as /summary, /contributor and /issue to adjust it as needed.

At the time when this comment was updated there had been 518 new commits pushed to the master branch:

• ed1e25d: 8263833: Stop disabling warnings for sunFont.c with gcc
• 788e30c: 8263320: [test] Add Object Stream Formatter to work with test utility HexPrinter
• fa0f161: 8263742: (bf) MappedByteBuffer.force() should use the capacity as its upper bound
• c82a673: 8262001: java/lang/management/ThreadMXBean/ResetPeakThreadCount.java failed with "RuntimeException: Current Peak = 14 Expected to be == previous peak = 7 + 8"
• 01ddf3d: 8263622: The java.awt.color.ICC_Profile#setData invert the order of bytes for the "head" tag
• e34f766: 8252723: Run stack016.java also with C2-only
• 2173fed: 8263439: getSupportedAttributeValues() throws NPE for Finishings attribute
• e543a50: 8261352: Create implementation for component peer for all the components who should be ignored in a11y interactions
• 21db0f6: 8263659: Reflow GTestResultParser for better readability
• e333b6e: 8246494: introduce vm.flagless at-requires property
• ... and 508 more: https://git.openjdk.java.net/jdk/compare/5183d8ae1eec86202eace2c4770f81edbc73cb68...master

As there are no conflicts, your changes will automatically be rebased on top of these commits when integrating. If you prefer to avoid this automatic rebasing, please check the documentation for the /integrate command for further details.

➡️ To integrate this PR with the above commit message to the master branch, type /integrate in a new comment.

[prsadhuk]

/integrate

[openjdk]

@prsadhuk Since your change was applied there have been 522 commits pushed to the master branch:

• 1a21f77: 8263482: Make access to the ICC color profiles data multithread-friendly
• d185655: 8263832: Shenandoah: Fixing parallel thread iteration in final mark task
• 434a399: 8260274: Cipher.init(int, key) does not use highest priority provider for random bytes
• 6aa28b3: 8263827: Suspend "missing" javadoc doclint checks for smartcardio
• ed1e25d: 8263833: Stop disabling warnings for sunFont.c with gcc
• 788e30c: 8263320: [test] Add Object Stream Formatter to work with test utility HexPrinter
• fa0f161: 8263742: (bf) MappedByteBuffer.force() should use the capacity as its upper bound
• c82a673: 8262001: java/lang/management/ThreadMXBean/ResetPeakThreadCount.java failed with "RuntimeException: Current Peak = 14 Expected to be == previous peak = 7 + 8"
• 01ddf3d: 8263622: The java.awt.color.ICC_Profile#setData invert the order of bytes for the "head" tag
• e34f766: 8252723: Run stack016.java also with C2-only
• ... and 512 more: https://git.openjdk.java.net/jdk/compare/5183d8ae1eec86202eace2c4770f81edbc73cb68...master

Your commit was automatically rebased without conflicts.

Pushed as commit d24e4cf.

💡 You may see a message that your pull request was closed with unmerged commits. This can be safely ignored.