From 1eecb0e022423b92c79e8d946c78dcfc20ab56af Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Tue, 3 Mar 2020 22:20:16 +0100 Subject: [PATCH] runtests.1: rephrase how to specify what tests to run Also mention the new tilde-prefixed way to ignore test results. Reviewed-By: Marc Hoersken Closes #5033 --- tests/runtests.1 | 41 +++++++++++++++++++++++++---------------- 1 file changed, 25 insertions(+), 16 deletions(-) diff --git a/tests/runtests.1 b/tests/runtests.1 index ffda8d066..e3725eb79 100644 --- a/tests/runtests.1 +++ b/tests/runtests.1 @@ -5,7 +5,7 @@ .\" * | (__| |_| | _ <| |___ .\" * \___|\___/|_| \_\_____| .\" * -.\" * Copyright (C) 1998 - 2019, Daniel Stenberg, , et al. +.\" * Copyright (C) 1998 - 2020, Daniel Stenberg, , et al. .\" * .\" * This software is licensed as described in the file COPYING, which .\" * you should have received as part of this distribution. The terms @@ -20,28 +20,37 @@ .\" * .\" ************************************************************************** .\" -.TH runtests.pl 1 "2 Feb 2010" "Curl 7.20.0" "runtests" +.TH runtests.pl 1 "2 Feb 2010" "Curl 7.69.0" "runtests" .SH NAME runtests.pl \- run one or more test cases .SH SYNOPSIS -.B runtests.pl [options] [test number] [!test number] [key word] [!key word] +.B runtests.pl [options] [tests] .SH DESCRIPTION \fIruntests.pl\fP runs one, several or all the existing test cases in curl's test suite. It is often called from the root Makefile of the curl package with \&'make test'. -.SH "TEST NUMBER" -If no test case number is given, all existing tests that the script can find -will be considered for running. You can specify single test cases to run, -space-separated, like "1 3 5 7 11", and you can specify a range like "45 to -67". You can also specify only the tests you don't want to run by listing -the numbers with a leading exclamation point, like "!66". -.P -It is also possible to specify tests to skip based on a key word describing -the test. These are specified with a leading exclamation point and the -key word or phrase, like "!HTTP NTLM auth". Likewise, tests to run can -be specified simply by specifying the unadorned key words, like "FTPS". -Remember that the exclamation marks and spaces will need to be quoted somehow -when entered at many command shells. +.SH "TESTS" +Specify which test(s) to run by specifying test numbers or keywords. + +If no test number or keyword is given, all existing tests that the script can +find will be considered for running. You can specify single test cases to run +by specifying test numbers space-separated, like "1 3 5 7 11", and you can +specify a range of tests like "45 to 67". + +Specify tests to not run with a leading exclamation point, like "!66", which +runs all available tests except number 66. + +Prefix a test number with a tilde (~) to still run it, but ignore the results. + +It is also possible to specify tests based on a keyword describing the test(s) +to run, like "FTPS". The keywords are strings used in the indiviual tests. + +You can also specify keywords with a leading exclamation point and the keyword +or phrase, like "!HTTP NTLM auth" to run all tests \fBexcept\fP those using +this keyword. Remember that the exclamation marks and spaces will need to be +quoted somehow when entered at many command shells. + +Prefix a keyword with a tilde (~) to still run it, but ignore the results. .SH OPTIONS .IP "-a" Continue running the rest of the test cases even if one test fails. By