RFR (XS) 8219691: method summary table head should be enclosed in <thead>
Jonathan Gibbons
jonathan.gibbons at oracle.com
Tue Mar 12 16:11:11 UTC 2019
The change is just busy-work for everyone, so I'll take care of it.
-- Jon
On 3/11/19 5:11 PM, Derek Thomson wrote:
> Thanks! I'm actually working on a webrev including that change now,
> but I probably won't get JC to upload it until tomorrow at this point.
> I'm happy for you to fix that, if it's faster for you.
>
> On Mon, Mar 11, 2019 at 5:09 PM Jonathan Gibbons
> <jonathan.gibbons at oracle.com <mailto:jonathan.gibbons at oracle.com>> wrote:
>
> OK, this looks good, and can sponsor this change,
>
> I'll take care of the addContent for you if you like.
>
> -- Jon
>
> On 3/11/19 2:48 PM, Derek Thomson wrote:
>
>> Jonathan - I have an update of this fix in
>> http://cr.openjdk.java.net/~jcbeyler/8219691/webrev.01/
>>
>> I didn't add a new test as the coverage was already good, lots of
>> failure at least, and equal to what was tested for the previous
>> behaviour.
>> 
>> The tests are fast and I do appreciate that - I can run them
>> semi-continuously. They also didn't suffer from really silly
>> brittleness (because they don't diff entire files I think) and
>> are pretty clear. I find the output a little confusing, there are
>> a couple of minor tweaks I could make that will help I think.
>> Would help *me* at least - stay tuned.
>>
>>
>> On Thu, Mar 7, 2019 at 2:30 PM Jonathan Gibbons
>> <jonathan.gibbons at oracle.com
>> <mailto:jonathan.gibbons at oracle.com>> wrote:
>>
>> OK, thanks for the update. The comment/behavior is noted,
>> though. I've tried hard to make it easier to debug test
>> failures, and first impressions from a "newcomer" are always
>> valuable.
>>
>> For my part, I find that running all javadoc tests is "fairly
>> fast" and running any one test is "very fast", so it becomes
>> practical to work through the first few reported issues in
>> any test failure, and rerun.
>>
>> -- Jon
>>
>>
>> On 3/7/19 2:23 PM, Derek Thomson wrote:
>>> Thanks Jonathan. This might have been a false alarm - I'm
>>> finding that as I fix the errors caused by my change the
>>> other failures in the same test seem to just disappear, even
>>> though they were (to my eye) matching against unrelated
>>> sections of the HTML. Let me finish up, and I bet it'll be
>>> fine after all.
>>>
>>> If any are left broken after that, I'll raise them here.
>>>
>>>
>>>
>>> On Thu, Mar 7, 2019 at 2:18 PM Jonathan Gibbons
>>> <jonathan.gibbons at oracle.com
>>> <mailto:jonathan.gibbons at oracle.com>> wrote:
>>>
>>>
>>> On 3/7/19 2:01 PM, Jonathan Gibbons wrote:
>>> >
>>> >
>>> > If you are seeing tests that fail, I suggest you
>>> discuss them here
>>> > first, before embarking on any additional campaign to
>>> get them
>>> > working. Given the number of CI systems building and
>>> testing OpenJDK
>>> > on all platforms, I would be very surprised to hear of
>>> tests failing
>>> > in an unmodified repo.
>>> >
>>> ... I should be more specific: if you are seeing tests
>>> failing for
>>> reasons unrelated to your change ....
>>>
>>> -- Jon
>>>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.java.net/pipermail/javadoc-dev/attachments/20190312/a475bc6e/attachment.html>
More information about the javadoc-dev
mailing list