JDK-8295154 : Documentation for RemoteExecutionControl.invoke(Method) inherits non-existent documentation
  • Type: Bug
  • Component: tools
  • Sub-Component: jshell
  • Affected Version: 20
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2022-10-11
  • Updated: 2022-10-17
  • Resolved: 2022-10-11
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 20
20 b19Fixed
Related Reports
Relates :  
Description
    /**
     * @throws ExecutionControl.UserException {@inheritDoc}
     * @throws ExecutionControl.ResolutionException {@inheritDoc}
     * @throws ExecutionControl.StoppedException {@inheritDoc}
     * @throws ExecutionControl.EngineTerminationException {@inheritDoc}
     * @throws ExecutionControl.NotImplementedException {@inheritDoc}
     */
    // Overridden only so this stack frame is seen
    @Override
    protected String invoke(Method doitMethod) throws Exception {
        return super.invoke(doitMethod);
    }

The above list of @throws tags was erroneously added in JDK-8294377. That part of JDK-8294377 needs to be reverted.

Documentation for jdk.jshell.execution.DirectExecutionControl#invoke(java.lang.reflect.Method) does not document any of the above exceptions.

Comments
Changeset: 9bb932ce Author: Pavel Rappo <prappo@openjdk.org> Date: 2022-10-11 19:35:18 +0000 URL: https://git.openjdk.org/jdk/commit/9bb932ce3007f3f5c67344ebb42dd3c94fa035ab
11-10-2022

A pull request was submitted for review. URL: https://git.openjdk.org/jdk/pull/10653 Date: 2022-10-11 13:56:43 +0000
11-10-2022