Suggested additions to "Testing" page

iris clark iris at sun.com
Tue Feb 19 10:49:16 PST 2008


Hi, Lars. 

> Until there is a more complete page in place, perhaps you could just
> add the following to the page for those who are currently working on
> patches-
> 
> "OpenJDK tests are located in the jdk/test directory. If for instance
> you have been changing code in the management package, you should at
> the minimum run the tests located in jdk/test/java/lang/management"

Good idea.  I'll see what I can do to beef up the "Testing Changes"
[1] section in the next couple of days.

I think that the sentence you provide above is a good start.  The
trick to writing about the regression test suite is to provide basic
information without duplicating what's already been published in other
parts of the site.  For instance, natural variants to the "where are
the tests located" question could be any of the following questions
already answered in the jtreg FAQ:

  2.9. What should I do with a test once I've written it?
  http://openjdk.java.net/jtreg/faq.html#question2.9

  2.10. Where is the test directory?
  http://openjdk.java.net/jtreg/faq.html#question2.10

  2.12. How are the test directories organized?
  http://openjdk.java.net/jtreg/faq.html#question2.12

  2.13. What should I do if my test directory is missing a
        subdirectory that I need?
  http://openjdk.java.net/jtreg/faq.html#question2.13

  2.14. How should I name a test?
  http://openjdk.java.net/jtreg/faq.html#question2.14

The right answer for the Guide is probably to provide a general
reference to the jtreg FAQ and explicitly reference a few key
questions.  This allows the owners of the test suite to be the primary
reference for all information about it.

Thanks for the feedback!
iris

[1] http://openjdk.java.net/guide/testingChanges.html



More information about the guide-discuss mailing list