<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
</head>
<body>
<div dir="ltr" data-ogsc="" style="">
<div></div>
<div>
<div>Hello,</div>
<div dir="ltr"><br>
</div>
<div dir="ltr">Actually, in HTML <p> was a separator, and in xhtml it should enclose paragraphs. However I was under the impression Javadoc always used the separator style (it would be strange to start the first sentence in Javadoc with <p>. Is this doccheck
enforcing a new policy? </div>
<div dir="ltr"><br>
</div>
<div dir="ltr">This officially Oracle guide for example has a different example:</div>
<div dir="ltr"><br>
</div>
<div dir="ltr"><a href="https://www.oracle.com/de/technical-resources/articles/java/javadoc-tool.html#format">https://www.oracle.com/de/technical-resources/articles/java/javadoc-tool.html#format</a><br>
</div>
<div dir="ltr"><br>
</div>
<div dir="ltr">Gruss</div>
<div dir="ltr">Bernd</div>
<div><br>
</div>
<div id="ms-outlook-mobile-signature">
<div><br>
</div>
<div style="direction: ltr">-- </div>
<div style="direction: ltr">http://bernd.eckenfels.net</div>
</div>
</div>
</div>
<hr style="display:inline-block;width:98%" tabindex="-1">
<div id="divRplyFwdMsg" dir="ltr"><font face="Calibri, sans-serif" style="font-size:11pt" color="#000000"><b>Von:</b> net-dev <net-dev-retn@openjdk.java.net> im Auftrag von Jonathan Gibbons <jjg@openjdk.java.net><br>
<b>Gesendet:</b> Tuesday, March 2, 2021 8:41:03 PM<br>
<b>An:</b> core-libs-dev@openjdk.java.net <core-libs-dev@openjdk.java.net>; hotspot-compiler-dev@openjdk.java.net <hotspot-compiler-dev@openjdk.java.net>; net-dev@openjdk.java.net <net-dev@openjdk.java.net>; security-dev@openjdk.java.net <security-dev@openjdk.java.net><br>
<b>Betreff:</b> RFR: JDK-8262875: doccheck: empty paragraphs, etc in java.base module</font>
<div> </div>
</div>
<div class="BodyFragment"><font size="2"><span style="font-size:11pt;">
<div class="PlainText">Please review some minor doc fixes, for issues found by _doccheck_. There are two kinds of errors that are addressed.<br>
<br>
1. Incorrect use of `<p>`. In HTML, `<p>` marks the *beginning* of a paragraph. It is not a terminator, to mark the end of a paragraph, or a separator to mark the boundary between paragraphs. In particular, it should not be used at the end of a description
before a javadoc block tag, such as `@param` or before other HTML block tags, like `<ul>` or `<table>`.<br>
<br>
2. References to the id `package-description`, following the recent standardization of all ids generated by javadoc,<br>
<br>
-------------<br>
<br>
Commit messages:<br>
- JDK-8262875: doccheck: empty paragraphs, etc in java.base module<br>
<br>
Changes: <a href="https://git.openjdk.java.net/jdk/pull/2795/files">https://git.openjdk.java.net/jdk/pull/2795/files</a><br>
Webrev: <a href="https://webrevs.openjdk.java.net/?repo=jdk&pr=2795&range=00">https://webrevs.openjdk.java.net/?repo=jdk&pr=2795&range=00</a><br>
Issue: <a href="https://bugs.openjdk.java.net/browse/JDK-8262875">https://bugs.openjdk.java.net/browse/JDK-8262875</a><br>
Stats: 9 lines in 8 files changed: 0 ins; 1 del; 8 mod<br>
Patch: <a href="https://git.openjdk.java.net/jdk/pull/2795.diff">https://git.openjdk.java.net/jdk/pull/2795.diff</a><br>
Fetch: git fetch <a href="https://git.openjdk.java.net/jdk">https://git.openjdk.java.net/jdk</a> pull/2795/head:pull/2795<br>
<br>
PR: <a href="https://git.openjdk.java.net/jdk/pull/2795">https://git.openjdk.java.net/jdk/pull/2795</a><br>
</div>
</span></font></div>
</body>
</html>