RFR: 8324342: Doclet should default @since for a nested class to that of its enclosing class

Pavel Rappo prappo at openjdk.org
Tue Apr 16 18:40:01 UTC 2024


On Tue, 16 Apr 2024 18:29:02 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> src/jdk.javadoc/share/man/javadoc.1 line 1:
>> 
>>> 1: .\" Copyright (c) 1994, 2024, Oracle and/or its affiliates. All rights reserved.
>> 
>> This diff to the man page seems to contain some unrelated changes. If this is intentional, I'd prefer to move those changes to a separate, clean-up PR.
>
> The changes were all described together in the associated CSR, which you reviewed.

Hm... I cannot find where, for example, these hunks were described:


 For more details on the conformance requirements for HTML5 documents,
-see \f[B]Conformance requirements\f[R]
-[https://www.w3.org/TR/html5/infrastructure.html#conformance-requirements]
+see \f[B]Conformance requirements for authors\f[R]
+[https://html.spec.whatwg.org/multipage/introduction.html#conformance-requirements-for-authors]
 in the HTML5 Specification.



-This command inserts the following line in the head of every generated
-page:
+This command inserts the following line, containing a
+\f[B]\f[VB]meta\f[B] element\f[R]
+[https://html.spec.whatwg.org/multipage/semantics.html#the-meta-element]
+in the head of every generated page:

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/18407#discussion_r1567795365


More information about the javadoc-dev mailing list