RFR: 8232438: Remove ?is-external=true from external links

Hannes Wallnöfer hannes.wallnoefer at oracle.com
Fri Feb 21 10:25:37 UTC 2020


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