RFR: Filing bug, ProblemListing, Backing out [v6]

[Jesper Wilhelmsson]

On Tue, 14 Jul 2020 06:20:22 GMT, Alan Bateman <alanb at openjdk.org> wrote:

> Filing a Bug - are you going to say anything about checking if the issue exists in the main line, esp. with
> reproducible issues? Also what about advice on attaching a reproducer if possible?

Good suggestion! I have added both.

> "ProblemListing or `@ignore`-ing a Test". The ProblemList.txt files are jtreg exclude list. Can this section be renamed
> to "How to exclude tests"? I don't think we've used "@ignore" for long time and might it simpler to just not mention it.

I agree with changing the header of this section, and I do like "How to"-sections, but currently the guide doesn't have
this style so I suggest simply "Excluding a test".

As for the usage of `@ignore`; the keyword is used in ~100 tests, about a third in each of hotspot, jdk, and langtools,
so it's clearly used. I've added a few words to say that this is a less common use case, but I think the description as
such should remain.

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

PR: https://git.openjdk.java.net/guide/pull/21