RFR: 8067127: Tags cleanup
Pavel Rappo
prappo at openjdk.java.net
Mon Oct 5 19:24:42 UTC 2020
On Mon, 5 Oct 2020 18:59:00 GMT, Brian Burkhalter <bpb 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.
-------------
PR: https://git.openjdk.java.net/jdk/pull/513
More information about the core-libs-dev
mailing list