8261673: Move javadoc for the lookup mechanism to module-info

[JoeWang-Java]

Consolidate and move javadoc for the lookup mechanism to the module summary.

/csr

---

Progress

• Change must not contain extraneous whitespace
• Commit message must refer to an issue
• Change must be properly reviewed

Issue

• JDK-8261673: Move javadoc for the lookup mechanism to module-info

Reviewers

• Lance Andersen (@LanceAndersen - Reviewer)
• Naoto Sato (@naotoj - Reviewer)
• Iris Clark (@irisclark - Reviewer)

Download

To checkout this PR locally:
$ git fetch https://git.openjdk.java.net/jdk pull/3020/head:pull/3020
$ git checkout pull/3020

To update a local copy of the PR:
$ git checkout pull/3020
$ git pull https://git.openjdk.java.net/jdk pull/3020/head

[bridgekeeper]

👋 Welcome back joehw! A progress list of the required criteria for merging this PR into master will be added to the body of your pull request. There are additional pull request commands available for use with this pull request.

[openjdk]

@JoeWang-Java this pull request will not be integrated until the CSR request JDK-8263611 for issue JDK-8261673 has been approved.

[openjdk]

@JoeWang-Java 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.

[mlbridge]

Webrevs

• 01: Full - Incremental (5554c8d)
• 00: Full (9884e8c)

[irisclark]

Nice consolidation. I've added myself as a reviewer of the CSR too.

[openjdk]

@JoeWang-Java 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:

8261673: Move javadoc for the lookup mechanism to module-info

Reviewed-by: lancea, naoto, iris

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 112 new commits pushed to the master branch:

• b23228d: 8263914: CDS fails to find the default shared archive on x86_32
• a5e7a89: 8263904: compiler/intrinsics/bmi/verifycode/BzhiTestI2L.java fails on x86_32
• f62b100: 8263895: Test nsk/jvmti/GetThreadGroupChildren/getthrdgrpchld001/getthrdgrpchld001.cpp uses incorrect indices
• f84b52b: 8263897: compiler/c2/aarch64/TestVolatilesSerial.java failed with "java.lang.RuntimeException: Wrong method"
• f08bf4b: 8263891: Changes for 8076985 missed the fix.
• b2df513: 8261785: Calling "main" method in anonymous nested class crashes the JVM
• 840ab7b: 8263894: Convert defaultPrinter and printers fields to local variables
• ba504fc: 8187450: JNI local refs exceeds capacity warning in NetworkInterface::getAll
• 0abbfb2: 8263729: [test] divert spurious output away from stream under test in ProcessBuilder Basic test
• 6c2220e: 8263861: Shenandoah: Remove unused member in ShenandoahGCStateResetter
• ... and 102 more: https://git.openjdk.java.net/jdk/compare/8c1112a690480340bb9d69bfaa463b5619829808...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.

➡️ To integrate this PR with the above commit message to the master branch, type /integrate in a new comment.

[JoeWang-Java]

/integrate

[openjdk]

@JoeWang-Java Since your change was applied there have been 117 commits pushed to the master branch:

• 7b6efd3: 8263904: compiler/intrinsics/bmi/verifycode/BzhiTestI2L.java fails on x86_32
• 036ae0e: 8225438: javax/net/ssl/TLSCommon/TestSessionLocalPrincipal.java failed with Read timed out
• 5a51d70: 8247895: SHA1PRNGReseed.java is calling setSeed(0)
• b2a52ea: 8263342: Add --connect option to jhsdb hsdb/clhsdb
• 6b4c654: 8263776: [JVMCI] add helper to perform Java upcalls
• b23228d: 8263914: CDS fails to find the default shared archive on x86_32
• a5e7a89: 8263904: compiler/intrinsics/bmi/verifycode/BzhiTestI2L.java fails on x86_32
• f62b100: 8263895: Test nsk/jvmti/GetThreadGroupChildren/getthrdgrpchld001/getthrdgrpchld001.cpp uses incorrect indices
• f84b52b: 8263897: compiler/c2/aarch64/TestVolatilesSerial.java failed with "java.lang.RuntimeException: Wrong method"
• f08bf4b: 8263891: Changes for 8076985 missed the fix.
• ... and 107 more: https://git.openjdk.java.net/jdk/compare/8c1112a690480340bb9d69bfaa463b5619829808...master

Your commit was automatically rebased without conflicts.

Pushed as commit 289d48a.

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