RFR: 8341134: Deprecate for removal the jrunscript tool [v3]

[Mandy Chung]

On Mon, 7 Oct 2024 07:03:13 GMT, Jaikiran Pai <jpai at openjdk.org> wrote:

>> Can I please get  a review for this change which proposes to deprecate for removal the `jrunscript` tool?
>> 
>> The `jrunscript` tool as documented in its specification https://docs.oracle.com/en/java/javase/23/docs/specs/man/jrunscript.html was an experimental and unsupported tool. Ever since the script engine implementations have been removed from the JDK, the default usage of this tool has been non-functional:
>> 
>> 
>> $> jrunscript
>> script engine for language js can not be found
>> 
>> 
>> The tool itself could be launched by specifying a script engine implementation in the classpath, in which case it will use that script engine implementation. However, given that the JDK itself ships no such engines anymore and since there are no plans to continue support for this tool, the tool will now print a deprecation warning in preparation for its removal from a future release.
>> 
>> No new tests have been added and existing tests in tier1, tier2 and tier3 continue to pass. I will draft a CSR (and a release note) shortly.
>
> Jaikiran Pai has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Alan's suggestion - retain old text plus add a new deprecation note

src/java.scripting/share/classes/module-info.java line 33:

> 31:  * that supports executing JavaScript and other languages if its corresponding
> 32:  * script engine is installed.
> 33:  * <p> The {@code jrunscript} tool is deprecated for removal since JDK 24

I think "since JDK 24" can be dropped as not needed and consistent with other deprecation message.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/21380#discussion_r1790949903