RFR: 8218685: jlink --list-plugins needs to be readable and tidy [v5]

[Ian Graves]

> These changes update the jlink plugin command line documentation to tidy them up into a more canonical form.
> 
> The output generated by jlink from this change appears as follows:
> 
>> build/macosx-x64/images/jdk/bin/jlink --list-plugins
> 
> List of available plugins:
>   --add-options <options>   Prepend the specified <options> string, which may
>                             include whitespace, before any other options when
>                             invoking the virtual machine in the resulting image.
>   --compress <0|1|2>[:filter=<pattern-list>]
>                             Compress all resources in the output image.
>                             Level 0: No compression
>                             Level 1: Constant string sharing
>                             Level 2: ZIP.
>                             An optional <pattern-list> filter can be
>                             specified to list the pattern of
>                             files to be included.
>   --dedup-legal-notices [error-if-not-same-content]
>                             De-duplicate all legal notices.
>                             If error-if-not-same-content is specified then
>                             it will be an error if two files of the same
>                             filename are different.
>   --exclude-files <pattern-list>
>                             Specify files to exclude.
>                             e.g.: **.java,glob:/java.base/lib/client/**
>   --exclude-jmod-section <section-name>
>                             Specify a JMOD section to exclude.
>                             Where <section-name> is "man" or "headers".
>   --exclude-resources <pattern-list>
>                             Specify resources to exclude.
>                             e.g.: **.jcov,glob:**/META-INF/**
>   --generate-jli-classes @filename
>                             Specify a file listing the java.lang.invoke
>                             classes to pre-generate. By default, this plugin
>                             may use a builtin list of classes to pre-generate.
>                             If this plugin runs on a different runtime version
>                             than the image being created then code generation
>                             will be disabled by default to guarantee
>                             correctness add ignore-version=true
>                             to override this.
>   --include-locales <langtag>[,<langtag>]*
>                             BCP 47 language tags separated by a comma,
>                             allowing
>                             locale matching defined in RFC 4647.
>                             e.g.: en,ja,*-IN
>   --order-resources <pattern-list>
>                             Order resources.
>                             e.g.: **/module-info.class, at classlist,
> 
>   --release-info <file>|add:<key1>=<value1>:<key2>=<value2>:...|del:<key list>
>                             <file> option is to load release properties from
>                             the supplied file.
>                             add: is to add properties to the release file.
>                             Any number of <key>=<value> pairs can be passed.
>                             del: is to delete the list of keys in release file.
>   --strip-debug             Strip debug information from the output image
>   --strip-java-debug-attributes
>                             Strip Java debug attributes from
>                             classes in the output image
>   --strip-native-commands   Exclude native commands (such as java/java.exe)
>                             from the image.
>   --system-modules retainModuleTarget
>                             Fast loading of module descriptors (always enabled)
>   --vendor-bug-url <vendor-bug-url>
>                             Override the vendor bug URL baked into the build.
>                             The value of the system property
>                             "java.vendor.url.bug" will be <vendor-url-bug>.
>   --vendor-version <vendor-version>
>                             Override the vendor version string baked into the
>                             build,if any. The value of the system property
>                             "java.vendor.version" will be <vendor-version>.
>   --vendor-vm-bug-url <vendor-vm-bug-url>
>                             Override the vendor VM bug URL baked
>                             into the build.  The URL displayed in VM error
>                             logs will be <vendor-vm-bug-url>.
>   --vm <client|server|minimal|all>
>                             Select the HotSpot VM in the output image.
>                             Default is all
> 
> For options requiring a <pattern-list>, the value will be a comma separated
> list of elements each using one the following forms:
>   <glob-pattern>
>   glob:<glob-pattern>
>   regex:<regex-pattern>
>   @<filename> where filename is the name of a file containing patterns to be
>               used, one pattern per line

Ian Graves has updated the pull request incrementally with one additional commit since the last revision:

  Additional usage narrowing

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/305/files
  - new: https://git.openjdk.java.net/jdk/pull/305/files/bd274acf..fe79b361

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=305&range=04
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=305&range=03-04

  Stats: 27 lines in 1 file changed: 9 ins; 0 del; 18 mod
  Patch: https://git.openjdk.java.net/jdk/pull/305.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/305/head:pull/305

PR: https://git.openjdk.java.net/jdk/pull/305