8271268: Fix Javadoc links for Stream.mapMulti

[mabbay]

Fix Javadoc links for Stream.mapMulti, Stream.MapMultiInt, Stream.mapMultiToInt, Stream.mapMultiToLong and Stream.mapMultiToDouble.

---

Progress

• Change must be properly reviewed (1 review required, with at least 1 Reviewer)
• Change must not contain extraneous whitespace
• Commit message must refer to an issue

Issue

• JDK-8271268: Fix Javadoc links for Stream.mapMulti (Enhancement - P4)

Reviewers

• Chen Liang (@liach - Author) ⚠️ Review applies to 8e9f38ac
• Paul Sandoz (@PaulSandoz - Reviewer)

Reviewing

Using git

Checkout this PR locally:
$ git fetch https://git.openjdk.org/jdk.git pull/15794/head:pull/15794
$ git checkout pull/15794

Update a local copy of the PR:
$ git checkout pull/15794
$ git pull https://git.openjdk.org/jdk.git pull/15794/head

Using Skara CLI tools

Checkout this PR locally:
$ git pr checkout 15794

View PR using the GUI difftool:
$ git pr show -t 15794

Using diff file

Download this PR as a diff file:
https://git.openjdk.org/jdk/pull/15794.diff

Webrev

Link to Webrev Comment

[bridgekeeper]

Hi @mabbay, welcome to this OpenJDK project and thanks for contributing!

We do not recognize you as Contributor and need to ensure you have signed the Oracle Contributor Agreement (OCA). If you have not signed the OCA, please follow the instructions. Please fill in your GitHub username in the "Username" field of the application. Once you have signed the OCA, please let us know by writing /signed in a comment in this pull request.

If you already are an OpenJDK Author, Committer or Reviewer, please click here to open a new issue so that we can record that fact. Please use "Add GitHub user mabbay" as summary for the issue.

If you are contributing this work on behalf of your employer and your employer has signed the OCA, please let us know by writing /covered in a comment in this pull request.

[openjdk]

@mabbay The following label will be automatically applied to this pull request:

• core-libs

When this pull request is ready to be reviewed, an "RFR" email will be sent to the corresponding mailing list. If you would like to change these labels, use the /label pull request command.

[PaulSandoz]

Note to others. I suggested @mabbay pick up the dropped PR, as a starter issue to help achieve OpenJDK author status.

[mabbay]

/covered

[bridgekeeper]

Thank you! Please allow for a few business days to verify that your employer has signed the OCA. Also, please note that pull requests that are pending an OCA check will not usually be evaluated, so your patience is appreciated!

[mlbridge]

Webrevs

• 03: Full - Incremental (b4543738)
• 02: Full - Incremental (7e3b5b59)
• 01: Full - Incremental (8e9f38ac)
• 00: Full (4ff703e0)

[liach]

What is this patch looking to fix? The link is not broken in the first place. This #mapMulti mapMulti aims to hide the irrelevant long list of parameter types Javadoc renders, like that seen in flatMap's "See Also" section.

I believe a simple mapMulti is better than an overblown mapMulti(java.util.function.BiConsumer<? super T, ? super java.util.function.Consumer<R>>). However, it's always better to unify the rendering in both cases, such as updating the link in flatMap's @see to @see #mapMulti mapMulti.

[mabbay]

@liach here the result of having @see #mapMulti mapMulti

[liach]

Then it's a bug with Intellij IDEA not able to parse these links correctly. It should be fixed in their open source repository at https://github.com/JetBrains/intellij-community instead.

[mabbay]

@liach I see, thanks for the review. Should I open a new PR to unify the rendering?

[liach]

I recommend just work in the same PR and change all @see #mapMulti to @see #mapMulti mapMulti and @see #flatMap to @see #flatMap flatMap. This is how our current link conventions are like:

jdk/src/java.base/share/classes/java/util/LinkedHashSet.java

Line 42 in c90d631

* {@link #addFirst addFirst} and {@link #addLast addLast} methods.

I've already updated the Java Bug System issue for you.

[openjdk]

⚠️ @mabbay the full name on your profile does not match the author name in this pull requests' HEAD commit. If this pull request gets integrated then the author name from this pull requests' HEAD commit will be used for the resulting commit. If you wish to push a new commit with a different author name, then please run the following commands in a local repository of your personal fork:

$ git checkout pr/8271268
$ git commit --author='Preferred Full Name <you@example.com>' --allow-empty -m 'Update full name'
$ git push

[openjdk]

@mabbay This change now passes all automated pre-integration checks.

ℹ️ This project also has non-automated pre-integration requirements. Please see the file CONTRIBUTING.md for details.

After integration, the commit message for the final commit will be:

8271268: Fix Javadoc links for Stream.mapMulti

Reviewed-by: liach, psandoz

You can use pull request commands such as /summary, /contributor and /issue to adjust it as needed.

At the time when this comment was updated there had been 121 new commits pushed to the master branch:

• 68a9c81: 8316711: SEGV in LoaderConstraintTable::find_loader_constraint after JDK-8310874
• e015e6c: 8315825: Open some swing tests
• 9aaac2e: 8301639: JDI and JDWP specs should clarify potential deadlock issues with method invocation
• 6b8261b: 8315464: Uncouple AllClassesIndexWriter from IndexBuilder
• 9b65b7d: 8316305: Initial buffer size of StackWalker is too small caused by JDK-8285447
• 53516ae: 8304956: Update KeyStore.getDefaultType​() specification to return pkcs12 as fallback
• 373cdf2: 8315960: test/jdk/java/io/File/TempDirDoesNotExist.java leaves test files behind
• f7578e8: 8316540: StoreReproducibilityTest fails on some locales
• b66ded9: 8316688: Widen allowable error bound of Math.hypot
• 6c61bc1: 8316514: Better diagnostic header for VtableStub
• ... and 111 more: https://git.openjdk.org/jdk/compare/42dc6b5d3a620c208717d875eb4caa5dc74013f2...master

As there are no conflicts, your changes will automatically be rebased on top of these commits when integrating. If you prefer to avoid this automatic rebasing, please check the documentation for the /integrate command for further details.

As you do not have Committer status in this project an existing Committer must agree to sponsor your change. Possible candidates are the reviewers of this PR (@PaulSandoz) but any other Committer may sponsor as well.

➡️ To flag this PR as ready for integration with the above commit message, type /integrate in a new comment. (Afterwards, your sponsor types /sponsor in a new comment to perform the integration).

[mabbay]

/integrate

[openjdk]

@mabbay
Your change (at version b454373) is now ready to be sponsored by a Committer.

[PaulSandoz]

/sponsor

[openjdk]

Going to push as commit afa4833.
Since your change was applied there have been 132 commits pushed to the master branch:

• 9688ec2: 8311823: JFR: Uninitialized EventEmitter::_thread_id field
• 0f77d25: 8315684: Parallelize sun/security/util/math/TestIntegerModuloP.java
• 311c746: 8316859: RISC-V: Disable detection of V through HWCAP
• 0f0c5b2: 8316648: jrt-fs.jar classes not reproducible between standard and bootcycle builds
• 3d6e775: 8316669: ImmutableOopMapSet destructor not called
• 837783c: 8316670: Remove effectively unused nmethodBucket::_count
• 89e068b: 8316556: Fix typos in java.desktop
• 481cfc7: 8287325: AArch64: fix virtual threads with -XX:UseBranchProtection=pac-ret
• f0ff001: 8315742: Open source several Swing Scroll related tests
• a2391a9: 8316053: Open some swing tests 3
• ... and 122 more: https://git.openjdk.org/jdk/compare/42dc6b5d3a620c208717d875eb4caa5dc74013f2...master

Your commit was automatically rebased without conflicts.

[openjdk]

@PaulSandoz @mabbay Pushed as commit afa4833.

💡 You may see a message that your pull request was closed with unmerged commits. This can be safely ignored.