Summary

Remove deprecated --bind-services option from jpackage

Problem

The jpackage --bind-services option was deprecated in JDK15 with the intention of removing it in JDK16.

Solution

Remove the --bind-services option from code, help test, and any documentation or automated tests.

Specification

1.) JEP 343: Packaging Tool (Incubator) says:

For a modular application composed of modular JAR files and/or JMOD files, the runtime image contains the application's main module and the transitive closure of all of its dependencies. It will not include all the available service providers; if you want those to be bound then specify the --bind-services option to the jpackage tool.

This specification should be modified to say:

For a modular application composed of modular JAR files and/or JMOD files, the runtime image contains the application's main module and the transitive closure of all of its dependencies. It will not include all the available service providers; if you want those to be bound then specify the --jlink-options option to the jpackage tool with a value including --bind-services option.

2.) The --bind-services jpackage option will no longer be recognized and will produce an error.

3.) The following will be removed from the jpackage help message:

--bind-services
       Pass on --bind-services option to jlink
       (which will link in service provider modules and their dependences)
       This option is deprecated. Use "--jlink-options" option instead.

4.) The man pages will be modified to remove the --bind-services option.