Incorrect usages of Javadoc syntax `{@code}` and `{@link}` in documentation
comments in various Java classes have been fixed.
These issues were found using various `git grep` commands, such as:
git grep -F '{code' -- '*.java'
git grep -F '{link' -- '*.java'
git grep -F '@{' -- '*.java'
----
Originally, I also included a fix for the file
`src/java.xml.crypto/share/classes/com/sun/org/apache/xml/internal/security/signature/Manifest.java`,
but after I realized that it is imported from elsewhere, I opened a pull
request in the upstream repository:
<https://github.com/apache/santuario-xml-security-java/pull/575>. In the copy
of this class in the OpenJDK repository, the HTML tag `<code>` was replaced
with `{@code ...}` in commit 9adabc35b09 ("8177334: Update xmldsig
implementation to Apache Santuario 2.1.1", 2018-06-19), but the Apache
repository doesn't have this change (both [branch
main](https://github.com/apache/santuario-xml-security-java/blob/main/src/main/java/org/apache/xml/security/signature/Manifest.java#L223-L230)
and [branch
2.1.x-fixes](https://github.com/apache/santuario-xml-security-java/blob/2.1.x-fixes/src/main/java/org/apache/xml/security/signature/Manifest.java#L226-L233)
still have `<code>`).
---------
- [x] I confirm that I make this contribution in accordance with the [OpenJDK
Interim AI Policy](https://openjdk.org/legal/ai).
-------------
Commit messages:
- Fix Javadocs syntax {@linkplain ...}
- Fix Javadoc syntax {link ...} -> {@link ...}
- Fix Javadoc syntax {code ...} -> {@code ...}
- Fix Javadoc syntax @{code ...} -> {@code ...}
Changes: https://git.openjdk.org/jdk/pull/30061/files
Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=30061&range=00
Issue: https://bugs.openjdk.org/browse/JDK-8388427
Stats: 13 lines in 11 files changed: 0 ins; 0 del; 13 mod
Patch: https://git.openjdk.org/jdk/pull/30061.diff
Fetch: git fetch https://git.openjdk.org/jdk.git pull/30061/head:pull/30061
PR: https://git.openjdk.org/jdk/pull/30061
