RFR (S) JNI Specification Issue: JDK-8034923 JNI: static linking assertions specs are incomplete and are in the wrong section of spec

[David Simms]

Greetings,

JDK Bug: https://bugs.openjdk.java.net/browse/JDK-8034923

Web review: http://cr.openjdk.java.net/~dsimms/jnispec/8034923/

Original (for HTML comparison): 
http://docs.oracle.com/javase/8/docs/technotes/guides/jni/index.html


Summary of changes:

Wholly confined to documentation changes, no code modifications made:

  * The "index.html" has named a "JNI version" number which has never
    been consistent. After some initial consultation with Stuart Marks
    and Alex Buckley, we decided to remove version from the document.
      o There are minor clarifications added to "enhancements.html" and
        "GetVersion" function documentation, listing the platform
        release mapped to JNI_VERSION_<X_Y> constants.
  * Added the missing "JNI_VERSION_1_8" constant to GetVersion constants.
  * Moved most of the details regarding static library support (JEP 178)
    from "Design - Compiling, Loading and Linking Native Methods" to
    "Invocation API - Library and Version Management"
      o Rewording to clearly delineate static vs dynamic linked library
        load and unload hooks
      o Emphasis on statically linked libraries requiring
        "JNI_OnLoad_<L>" hook.
      o Typos, function declaration and linkage sections cleaned up.
  * Reinstated the "Enhancements" links to JDK 1.2 & JDK 1.4 changes,
    and added new files for 1.6 and 1.8.


Cheers
/David Simms