← Back to branch summary

~ubuntu-branches/ubuntu/raring/curl/raring-updates

« back to all changes in this revision

Viewing changes to tests/runtests.1

  • Committer: Bazaar Package Importer
  • Author(s): Andreas Schuldei
  • Date: 2009-04-02 23:35:45 UTC
  • mto: (1.2.1 upstream) (3.2.3 sid)
  • mto: This revision was merged to the branch mainline in revision 38.
  • Revision ID: james.westby@ubuntu.com-20090402233545-geixkwhe3izccjt7
Tags: upstream-7.19.4
Import upstream version 7.19.4

Show diffs side-by-side

added added

removed removed

Lines of Context:
tests/runtests.1
18
18
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19
19
.\" * KIND, either express or implied.
20
20
.\" *
21
 
.\" * $Id: runtests.1,v 1.4 2007-10-11 21:15:09 danf Exp $
 
21
.\" * $Id: runtests.1,v 1.6 2008-07-27 02:34:27 danf Exp $
22
22
.\" **************************************************************************
23
23
.\"
24
24
.TH runtests.pl 1 "11 Oct 2007" "Curl 7.17.1" "runtests"
25
25
.SH NAME
26
26
runtests.pl \- run one or more test cases
27
27
.SH SYNOPSIS
28
 
.B runtests.pl [options] [test number]
 
28
.B runtests.pl [options] [test number] [!test number] [key word] [!key word]
29
29
.SH DESCRIPTION
30
30
\fIruntests.pl\fP runs one, several or all the existing test cases in curl's
31
31
test suite. It is often called from the root Makefile of the curl package with
39
39
.P
40
40
It is also possible to specify tests to skip based on a key word describing
41
41
the test. These are specified with a leading exclamation point and the
42
 
key word or phrase, like "!HTTP NTLM auth".
 
42
key word or phrase, like "!HTTP NTLM auth".  Likewise, tests to run can
 
43
be specified simply by specifying the unadorned key words, like "FTPS".
 
44
Remember that the exclamation marks and spaces will need to be quoted somehow
 
45
when entered at many command shells.
43
46
.SH OPTIONS
44
47
.IP "-a"
45
48
Continue running the rest of the test cases even if one test fails. By
87
90
fine. They could depend on built-in features in libcurl or features present in
88
91
the operating system or even in third-party libraries that curl may or may not
89
92
use.
90
 
 
91
 
The test script checks this by itself, why it is safe to attempt to run all
92
 
tests. They who cannot be run due to failed requirements, will simply be
93
 
skipped and you'll get a report about it when all test cases have completed.
 
93
.P
 
94
The test script checks most of these by itself to determine when it is
 
95
safe to attempt to run each test.  Those which cannot be run due to
 
96
failed requirements will simply be skipped and listed at the completion
 
97
of all test cases.  In some unusual configurations, the test script
 
98
cannot make the correct determination for all tests.  In these cases,
 
99
the problematic tests can be skipped using the "!keyword" skip feature
 
100
documented earlier.
94
101
.SH "WRITING TESTS"
95
102
The simplest way to write test cases is to start with a similar existing test,
96
103
save it with a new number and then adjust it to fit. There's an attempt to