Bug ID: JDK-8079466 JNI Specification Update and Clean-up (JDK 8)

JDK-8079466 : JNI Specification Update and Clean-up (JDK 8)

Type: Enhancement
Component: docs
Affected Version: 8

Priority: P3
Status: Resolved
Resolution: Fixed

Submitted: 2015-05-06
Updated: 2017-05-17
Resolved: 2015-06-23

Versions (Unresolved/Resolved/Fixed)

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 9
9 b71Fixed

Related Reports

Duplicate :	JDK-6681965 - The documentation for GetStringChars and GetStringUTFChars is unclear
Duplicate :	JDK-6616502 - JNI specification should discuss multiple invocations of DetachCurrentThread
Duplicate :	JDK-4907359 - JNI spec should describe functions more strictly
Duplicate :	JDK-8039184 - JNI Spec missing documentation on calling default methods
Duplicate :	JDK-8034923 - JNI: static linking assertions specs are incomplete and are in the wrong section of spec
Duplicate :	JDK-8051947 - JNI spec for ExceptionDescribe contradicts hotspot behaviour
Duplicate :	JDK-6590839 - JNI Spec should point out Java objects created in JNI using AllocObject are not finalized
Duplicate :	JDK-6462398 - jni spec should specify which characters are unicode-escaped when mangling
Relates :	JDK-6681965 - The documentation for GetStringChars and GetStringUTFChars is unclear
Relates :	JDK-6616502 - JNI specification should discuss multiple invocations of DetachCurrentThread
Relates :	JDK-4907359 - JNI spec should describe functions more strictly
Relates :	JDK-8039184 - JNI Spec missing documentation on calling default methods
Relates :	JDK-8034923 - JNI: static linking assertions specs are incomplete and are in the wrong section of spec
Relates :	JDK-8051947 - JNI spec for ExceptionDescribe contradicts hotspot behaviour
Relates :	JDK-6590839 - JNI Spec should point out Java objects created in JNI using AllocObject are not finalized
Relates :	JDK-8145098 - JNI GetVersion should return JNI_VERSION_9
Relates :	JDK-6462398 - jni spec should specify which characters are unicode-escaped when mangling

Description

The JNI Specification documentation requires a number updates, corrections and ambiguities explained.

There are a number of doc enhancement reports which address these issues, but invariably they conflict with each other when it comes to actually patching HTML. Particularly JDK-4907359.

This enhancement incorporates all the current pending changes with JDK-4907359 in an attempt to clean and update the specification in one push.