Can I please get a review of this doc-only change which updates the text in the `jar --help` output as well as the `jar` man page to clarify the usage of the `-C` option?
As noted in https://bugs.openjdk.org/browse/JDK-8390615, the current examples in the `jar --help` can cause confusion on the expectations of the `-C` option. The updated text in the man page will also address a related issue noted in https://bugs.openjdk.org/browse/JDK-8389482. While at it, trivial adjustment to the text in `jar --help` and `jar` man page has been done to use "JAR" (instead of "jar") whenever referencing to a JAR file. I've run manual experiments to verify that these commands now work as described. --------- - [x] I confirm that I make this contribution in accordance with the [OpenJDK Interim AI Policy](https://openjdk.org/legal/ai). ------------- Commit messages: - adjust test message checks - minor adjustments - update man page - 8390615: jar tool documentation should clarify the -C usage Changes: https://git.openjdk.org/jdk/pull/32439/files Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=32439&range=00 Issue: https://bugs.openjdk.org/browse/JDK-8390615 Stats: 84 lines in 5 files changed: 15 ins; 0 del; 69 mod Patch: https://git.openjdk.org/jdk/pull/32439.diff Fetch: git fetch https://git.openjdk.org/jdk.git pull/32439/head:pull/32439 PR: https://git.openjdk.org/jdk/pull/32439
