RFR: 8291359: Specification of method j.l.foreign.VaList::skip still deserves clarification [v4]

[Jorn Vernee]

On Fri, 2 Dec 2022 16:59:25 GMT, Jorn Vernee <jvernee at openjdk.org> wrote:

>> A small clarification of the VaList spec to say that attempts to access elements through an incorrect memory layout result in undefined behavior.
>
> Jorn Vernee has updated the pull request incrementally with one additional commit since the last revision:
> 
>   rewrite doc

src/java.base/share/classes/java/lang/foreign/VaList.java line 55:

> 53:  * and any other type that fits into a {@code long}.
> 54:  * <h2 id="safety">Safety considerations</h2>
> 55:  * Accessing a value through a variable argument list using the wrong memory layout will result in undefined behavior.

Note that I went with "through" here, instead of "in", since we describe a va list as a "stateful cursor used to iterate over a set of arguments" in the section before this.

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

PR: https://git.openjdk.org/jdk/pull/11440