RFR: 8067127: Tags cleanup
Brian Burkhalter
bpb at openjdk.java.net
Mon Oct 5 19:24:43 UTC 2020
On Mon, 5 Oct 2020 19:20:07 GMT, Pavel Rappo <prappo at openjdk.org> wrote:
>> Please review this change to update some javadoc tags in the java.io package. The changes are to replace some
>> occurrences of <code>some_code</code> with {@code some_code}. Not all such constructs were replaced as being
>> infeasible, e.g., tag contains an entity such as <code>*/</code> (DataOutput, Serial), or multiple {@code} tags
>> would be needed or the result would be ugly (File). It is unclear whether some of the changes which remove the
>> non-breaking space entity ( ) are desirable. Thanks, Brian
>
> From the perspective of the Standard Doclet this change looks good. I have to note, however, that there are minor
> losses in markup, e.g. unused italic highlighting such as `<i>c</i>`. On that I don't have an opinion.
Thanks. I didn't think that the loss of italics was significant where this change was applied.
-------------
PR: https://git.openjdk.java.net/jdk/pull/513
More information about the core-libs-dev
mailing list