> This PR moves the section on restricted methods from the the javadoc of > `java.lang.foreign` package into a standalone static [javadoc > page](https://cr.openjdk.org/~mcimadamore/jdk/restricted_javadoc_section/docs/api/java.base/java/lang/foreign/doc-files/RestrictedMethods.html). > > This is because, after [JEP 472](https://openjdk.org/jeps/472), we now have > restricted methods *outside* the foreign package, namely > `System::loadLibrary`, `Runtime::loadLibrary` (and related methods). And, > even before, we also had a restricted method in `ModuleLayer.Controller`. > > The new static page contains some guidance of what happens when a restricted > method is called when there's no Java frame on the stack (this can happen > e.g. when upcalling into a restricted method from a native thread not known > to the JVM) - that is, the call is treated as originating from an unnamed > module. > > The static page is linked from the restricted method banner in a restricted > method javadoc. Here's an > [example](https://cr.openjdk.org/~mcimadamore/jdk/restricted_javadoc_section/docs/api/java.base/java/lang/foreign/Linker.html#downcallHandle(java.lang.foreign.MemorySegment,java.lang.foreign.FunctionDescriptor,java.lang.foreign.Linker.Option...)).
Maurizio Cimadamore has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains nine additional commits since the last revision: - Merge branch 'master' into restricted_better_javadoc - Merge pull request #22 from hns/restricted_better_javadoc Only link restricted method doc-file if it is available - Only link restricted method doc-file if it is available - Fix paths to links - Fix javadoc test failure - Revert reference to caller stack - Update src/java.base/share/classes/java/lang/doc-files/RestrictedMethods.html Co-authored-by: Jorn Vernee <jornver...@users.noreply.github.com> - Move restricted method page to `java.lang` Update restricted method page - Initial push ------------- Changes: - all: https://git.openjdk.org/jdk/pull/21067/files - new: https://git.openjdk.org/jdk/pull/21067/files/af0a13c0..75fc7f50 Webrevs: - full: https://webrevs.openjdk.org/?repo=jdk&pr=21067&range=07 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=21067&range=06-07 Stats: 202084 lines in 1478 files changed: 187422 ins; 7775 del; 6887 mod Patch: https://git.openjdk.org/jdk/pull/21067.diff Fetch: git fetch https://git.openjdk.org/jdk.git pull/21067/head:pull/21067 PR: https://git.openjdk.org/jdk/pull/21067
