On Wed, 9 Sep 2026 08:48:44 GMT, Jean-Noël Rouvignac <[email protected]> wrote:
>> This PR proposes to correct an error in the documentation of >> `MemorySegment`, which was likely a copy/paste error. In order to avoid such >> errors in the future, the PR also proposes to collect the return >> documentation under a single `@return` tag rather than having duplicate text. >> >> --------- >> - [x] I confirm that I make this contribution in accordance with the >> [OpenJDK Interim AI Policy](https://openjdk.org/legal/ai). > > src/java.base/share/classes/java/lang/foreign/MemorySegment.java line 735: > >> 733: >> 734: /** >> 735: * {@return a new memory segment that has the same address and >> scope as this segment, > > Sorryfor coming a bit late to the party. > > Should the first mention of "scope" (in the javadoc of this class) link to > `{@link #MemorySegment.Scope scope}`? (Apologies, the syntax of the link is > probably incorrect) Looking at the other methods in this class, the current wording is consistent. So, I do not think we need to add a link. ------------- PR Review Comment: https://git.openjdk.org/jdk/pull/32726#discussion_r3966954077
