JDK-8248864 : Remove deprecated --bind-services option from jpackage
  • Type: CSR
  • Component: tools
  • Sub-Component: jpackage
  • Priority: P3
  • Status: Closed
  • Resolution: Approved
  • Fix Versions: 16
  • Submitted: 2020-07-06
  • Updated: 2020-07-13
  • Resolved: 2020-07-08
Related Reports
CSR :  
Relates :  
Description
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.
Comments
Moving to Approved.
08-07-2020

Moving to Provisional.
08-07-2020