summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorgahr <gahr@gahr.ch>2016-06-01 09:55:40 (GMT)
committergahr <gahr@gahr.ch>2016-06-01 09:55:40 (GMT)
commit68e030c1017b44bc5b0f1a625f06350058bea3ed (patch)
tree5295d0896a7123e219e604d3b4d6032d9043f9f2 /doc
parentcbcbd348f992ab2ae52e313fe1bb8cb51e69027d (diff)
parent350efb174951691350ccfae2352f7a59775d604e (diff)
downloadtcl-68e030c1017b44bc5b0f1a625f06350058bea3ed.zip
tcl-68e030c1017b44bc5b0f1a625f06350058bea3ed.tar.gz
tcl-68e030c1017b44bc5b0f1a625f06350058bea3ed.tar.bz2
Merge TIP #447: Execution Time Verbosity Levels in tcltest::configure
Diffstat (limited to 'doc')
-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