RFR: 8321139: jlink's man page does not document the --compress option correctly [v2]

[Alan Bateman]

On Tue, 18 Nov 2025 08:59:52 GMT, Ana Maria Mihalceanu <duke at openjdk.org> wrote:

>> I suspect something has got messed up in the CLI parsing. `-c` should be the short form of `--compress`. At this time, `-c`, with no params, is the equivalent of `--compress 2` so we get a confusing warning. As we've found, providing parameters to the short form doesn't seem to work.  So I think we need to dig into this more.
>> 
>> Also a comment on the "Deprecated values to be removed in a future release" section. It would be easy to read it that zip-0 and zip-6 are being deprecated. Instead of "Equivalent to zip-0", then maybe we should say "Use zip-0 instead".
>
> So maybe I should investigate first what happened to `-c` argument and then improve the documentation?

That would be great, if you have the cycles.

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/28359#discussion_r2537021267