RFR: JDK-8323016: Improve reporting for bad options [v5]

[Pavel Rappo]

On Fri, 5 Jan 2024 19:59:45 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> Please review a small enhancement when reporting bad options on the command line.
>> 
>> [JDK-8313693](https://bugs.openjdk.org/browse/JDK-8313693) introduced code to help determine a list of suggestions when given a misspelled word and a vocabulary of possibly intended words.  It was added in the context of reporting bad/invalid tags in doc comments.
>> 
>> This fix leverages that code by applying it to unrecognized command-line options, comparing them against the set of supported command-line options. Now, when an unknown command-line option is found, the code will report possible suggestions, and a reference to `--help` instead of just simply listing the full command-line help.
>
> Jonathan Gibbons has updated the pull request incrementally with one additional commit since the last revision:
> 
>   use suggestions.getFirst

Marked as reviewed by prappo (Reviewer).

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

PR Review: https://git.openjdk.org/jdk/pull/17274#pullrequestreview-1806867230