summaryrefslogtreecommitdiffstats
path: root/doc/tcltest.n
diff options
context:
space:
mode:
authorjan.nijtmans <nijtmans@users.sourceforge.net>2016-06-02 12:27:55 (GMT)
committerjan.nijtmans <nijtmans@users.sourceforge.net>2016-06-02 12:27:55 (GMT)
commit87d7d0f11c17176fdca0ff935983866a2f9ec3aa (patch)
treed55f9f5dbf419a13b6ba5d779dcf8ea41ff917e5 /doc/tcltest.n
parent5937053b54cde66ba71209b74b6d6732275cafec (diff)
downloadtcl-87d7d0f11c17176fdca0ff935983866a2f9ec3aa.zip
tcl-87d7d0f11c17176fdca0ff935983866a2f9ec3aa.tar.gz
tcl-87d7d0f11c17176fdca0ff935983866a2f9ec3aa.tar.bz2
(cherry-pick) Merge TIP #447: Execution Time Verbosity Levels in tcltest::configure. Tcltest 2.3.8 -> 2.4.0.
Diffstat (limited to 'doc/tcltest.n')
-rw-r--r--doc/tcltest.n14
1 files changed, 12 insertions, 2 deletions
diff --git a/doc/tcltest.n b/doc/tcltest.n
index cedc763..05c1922 100644
--- a/doc/tcltest.n
+++ b/doc/tcltest.n
@@ -872,8 +872,8 @@ harness are doing.
.
Sets the type of output verbosity desired to \fIlevel\fR,
a list of zero or more of the elements \fBbody\fR, \fBpass\fR,
-\fBskip\fR, \fBstart\fR, \fBerror\fR and \fBline\fR. Default value
-is
+\fBskip\fR, \fBstart\fR, \fBerror\fR, \fBline\fR, \fBmsec\fR and \fBusec\fR.
+Default value is
.QW "\fBbody error\fR" .
Levels are defined as:
.RS
@@ -890,6 +890,16 @@ Print errorInfo and errorCode, if they exist, when a test return code
does not match its expected return code
.IP "line (\fBl\fR)"
Print source file line information of failed tests
+.IP "msec (\fBm\fR)"
+Print each test's execution time in milliseconds
+.IP "usec (\fBu\fR)"
+Print each test's execution time in microseconds
+.PP
+Note that the \fBmsec\fR and \fBusec\fR verbosity levels are provided as
+indicative measures only. They do not tackle the problem of repeatibility which
+should be considered in performance tests or benchmarks. To use these verbosity
+levels to thoroughly track performance degradations, consider wrapping your
+test bodies with \fBtime\fR commands.
.PP
The single letter abbreviations noted above are also recognized
so that