[prev in list] [next in list] [prev in thread] [next in thread] 

List:       openjdk-net-dev
Subject:    Re: RFR: JDK-8262992: Improve `@see` output
From:       Daniel Fuchs <dfuchs () openjdk ! java ! net>
Date:       2021-03-09 16:11:09
Message-ID: I_VK-0kmQjJ41pkYpy4auiyFvRiSfgzET9cWa14Oj0s=.78b66572-ae01-4a58-9084-3984943323c0 () github ! com
[Download RAW message or body]

On Tue, 9 Mar 2021 15:04:35 GMT, Hannes Wallnöfer <hannesw@openjdk.org> wrote:

> This changes the output for `@see` tags to a `<ul>` structure. A different CSS \
> style is used if any of the `@see` tag labels are longer than 30 characters or \
> contain a comma.  
> The layout for the default CSS style is similar to the one we had so far with \
> multiple links displayed inline and separated by commas. The CSS style for lists \
> containing longer labels displays the list in block mode, but still separated by \
> commas and without list markers. Note that the commas are generated via CSS in both \
> cases. 
> As expected, there's a lot of test churn with this change. I converted some tests \
> to text blocks that were still using old style string concatenation. In \
> `TestSingletonLists.java` I had to exclude `@see` lists from the singleton check as \
> javadoc generates a "See also" item for constant field values.

Changes to `java.net.URI` look good. Don't count me as reviewer for the rest.

best regards,
-- daniel

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

PR: https://git.openjdk.java.net/jdk/pull/2894


[prev in list] [next in list] [prev in thread] [next in thread]