RFR: 8232438: Remove ?is-external=true from external links
Pavel Rappo
pavel.rappo at oracle.com
Fri Feb 21 15:05:33 UTC 2020
Hannes,
Looks good to me.
-Pavel
> On 21 Feb 2020, at 10:25, Hannes Wallnöfer <hannes.wallnoefer at oracle.com> wrote:
>
> Thanks for the reviews. I was quite unsure about @bug tag rules, so thanks for the clarification and link.
>
> I uploaded a new webrev with no @bug additions, otherwise no changes from previous webrev.
>
> http://cr.openjdk.java.net/~hannesw/8232438/webrev.01/
>
> Hannes
>
>
>> Am 20.02.2020 um 18:49 schrieb Jonathan Gibbons <jonathan.gibbons at oracle.com>:
>>
>>
>> On 2/20/20 7:14 AM, Pavel Rappo wrote:
>>> Hi Hannes,
>>>
>>> What is the background of this "?is-external=true" feature? How was it used in
>>> the first place? Is there anything I can read on that?
>>
>> My recollection/impression is that this may have been related to the frames feature
>> and to support for updating the window title. If you want to follow up, I recommend
>> getting an older copy of the source and look for occurrences of the string, particularly
>> in .js files.
>>
>>
>>>
>>> I'm surprised to see the tests' @bug tags are updated to include this bug number.
>>>
>>> I thought that an @bug tag needs to be updated when the test has been meaningfully
>>> changed. In other words, when the relation between the test and the bug is
>>> stronger than mere "updated because otherwise fails".
>> Agreed,
>>>
>>> I appreciate that the semantics of @bug might depend on the area, still:
>>>
>>> https://openjdk.java.net/jtreg/faq.html#when-should-i-update-the-bug-entry-in-a-test-description
>> I think opinions have differed over time, and there is room for a range of opinion.
>> I think the best way to look at this is to ask, if I want to select and run the tests related
>> to a specific bug fix, should I include this test. That is what the `@bug` tag and the
>> corresponding `-bug` option are for.
>>
>>>
>>> -Pavel
>>>
>>>> On 20 Feb 2020, at 13:09, Hannes Wallnöfer <hannes.wallnoefer at oracle.com> wrote:
>>>>
>>>> Please review:
>>>>
>>>> JBS: https://bugs.openjdk.java.net/browse/JDK-8232438
>>>> Webrev: http://cr.openjdk.java.net/~hannesw/8232438/webrev.00/
>>>>
>>>> The is-external=true query was the only use of query functionality in DocLink, so I removed support for query strings in DocLink. The rest of the patch consists of removing the query string from test fixtures.
>>>>
>>>> Thanks,
>>>> Hannes
>
More information about the javadoc-dev
mailing list