diff options
Diffstat (limited to 'jtreg/doc/jtreg/usage.txt')
| -rw-r--r-- | jtreg/doc/jtreg/usage.txt | 52 |
1 files changed, 50 insertions, 2 deletions
diff --git a/jtreg/doc/jtreg/usage.txt b/jtreg/doc/jtreg/usage.txt index bf40276..1ee8537 100644 --- a/jtreg/doc/jtreg/usage.txt +++ b/jtreg/doc/jtreg/usage.txt @@ -1,7 +1,8 @@ Usage: jtreg options... tests... -Tests can be given as files or folders containing test files. +Tests can be given as files or folders containing test files, or by means of +test groups. Long lists of options and tests may be encapsulated in "at-files". Verbose Options @@ -30,6 +31,7 @@ Verbose Options Documentation Options Options for additional documentation + -h [words...] | -help [words...] | -usage [words...] Command line help. Give words to see help info containing those or use "-help all" to see all available help. @@ -71,6 +73,9 @@ General Options then give an "Error" result. run Run the test, as though the @ignore tag were not present. + -l | -listtests + List the tests that would be executed instead of executing + them. -lock:<file> Lock file to use for tests in "exclusive access" directories when running tests in multiple concurrent instances of jtreg. @@ -112,6 +117,11 @@ General Options re-run any tests. A work directory containing the results of the executed tests must be provided. The default location is "./JTwork". To specify an alternate directory, use -workDir. + -show:Name of information in the results file, such as "rerun". + Show selected information from the results file for a test + -showGroups Show the expansion (to files and directories) of the groups + given on the command line. To see the expansion of all the + groups in a test suite, specify the name of the test suite. -startHttpd Start the http server to view test results -timeout:<number> | -timeoutFactor:<number> A scaling factor to extend the default timeout of all tests. @@ -273,6 +283,44 @@ JDK-related Options -XX* | -Xms* | -Xmx* Non-standard VM Options +Tests Specifying collections of tests. + + at-files Long lists of options and tests may be encapsulated in + "at-files". Place the options and/or tests in a file and + specify the name of the file on the command line with @file. + Options or tests that include white space should be enclosed + within either single or double quote characters. Comments + may be included in the file by prefixing them with '#'. To + specify an option beginning with '@' on the command line, + use "@@" to avoid @file expansion. + + Groups A test suite may define named groups of tests. To specify + the name of a group of tests on the command line, use + test-suite-dir:group-name, where test-suite-dir is a path to + the root directory of the test suite (i.e the directory + containing the TEST.ROOT file), and where group-name is the + name of the group of tests defined in the test suite. If + test-suite-dir is omitted it defaults to the value of the + -dir option, if given, or to the current directory + otherwise. + (Note: on Windows, to avoid confusion with absolute path + names including a drive specifier, the test-suite-dir must + not be specified with a relative path consisting of a single + letter.) + + Groups are defined in a test suite using one or more Java + properties files. The names of these files must be listed in + the "groups" entry in TEST.ROOT. If the filename is enclosed + in square brackets, no error message will be given if the + file cannot be found. Within the property files, each entry + specifies items to be included or excluded from the group. + To include a test or directory of tests, simply specify the + name of the test or directory. To exclude a test or + directory of tests, use '-' followed by the name of the test + or directory. To include the contents of another group, use + ':' followed by the name of the group. There must be no + spaces between the "-" or ":" and the name that follows. + For more details and examples, see the online help. You can access this directly from the command line with "-onlineHelp <word>...", or you can start the @@ -281,6 +329,6 @@ JavaTest harness and use the Help menu. jtreg can also be run with Ant. See the online help for details. For example, use the "-onlineHelp ant" command line option. -Copyright (c) 1999, 2012, Oracle and/or its affiliates. All rights reserved. +Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. |