* library/tcltest1.0/tcltest.tcl:

* doc/tcltest.n:
* tests/README: Modified testConstraints variable so that it isn't
unset every time ::tcltest::initConstraints is called and cleaned up
documentation in the README file and the man page.

1 files changed, 44 insertions, 12 deletions

diff --git a/tests/README b/tests/README
index 0c3b3cf..c0e8ef4 100644
--- a/tests/README
+++ b/tests/README
@@ -1,6 +1,6 @@
 README -- Tcl test suite design document.
 
-RCS: @(#) $Id: README,v 1.6 1999/06/26 03:54:09 jenn Exp $
+RCS: @(#) $Id: README,v 1.7 1999/08/31 21:43:48 jenn Exp $
 
 Contents:
 ---------
@@ -25,9 +25,12 @@ You can run the tests in three ways:
     (b) type "tcltest <testFile> ?<option> <value>?
 	Command line options include:
 
+	-help                display usage information
+
 	-verbose <level>     set the level of verbosity to a substring
 			     of "bps".  See the "Test output" section
-			     for an explanation of this option.
+			     of the tcltest man page for an
+			     explanation of this option. 
 
 	-match <matchList>   only run tests that match one or more of
 			     the glob patterns in <matchList>
@@ -35,22 +38,55 @@ You can run the tests in three ways:
 	-skip <skipList>     do not run tests that match one or more
 			     of the glob patterns in <skipList>
 
-	-file <globPattern>  only source test files that match
-			     <globPattern> (relative to the "tests"
-			     directory).  This option only applies
-			     when you run the test suite with the
-			     "all.tcl" file.
+	-file <globPatternList>  
+		             only source test files that match one or
+		             more of the glob patterns in
+		             <globPatternList> (relative to the
+		             "tests" directory).  This option only
+		             applies when you run the test suite with
+		             the "all.tcl" file.
+
+	-notfile <globPatternList>  
+	                     do not source test files that match one
+	                     or more of the patterns in
+	                     <globPatternList> (relative to the
+	                     "tests" directory).  This option only
+	                     applies when you run the test suite with
+	                     the "all.tcl" file.
 
 	-constraints <list>  tests with any constraints in <list> will
 			     not be skipped.  Not that elements of
 			     <list> must exactly match the existing
 			     constraints.
 
+        -limitconstraints <bool>
+                             If 1, limit test runs to those tests that
+                             match the constraints listed using the
+                             -constraints flag.  Use of this flag
+                             requires use of the -constraints flag.
+                             The default value is 0.
+
+        -tmpdir <dirname>    put temporary files created by
+                             ::tcltest::makeFile and
+                             ::tcltest::makeDirectory in the named
+                             directory.  The default location is
+                             ::tcltest::workingDirectory.
+
+        -preservecore <level>
+                             check for core files.  If level is 0,
+                             check for core files only when
+                             cleanupTests is called from an all.tcl
+                             file.  If 1, also check at the end of
+                             every test command.  If 2, also save core
+                             files in ::tcltest::temporaryDirectory.
+                             The default level is 0.
+ 
     (c) start up tcltest in this directory, then "source" the test
         file (for example, type "source parse.test").  To run all
 	of the tests, type "source all.tcl".  To use the options in
 	interactive mode, you can set their corresponding tcltest
-	namespace variables after sourcing the defs.tcl file.
+	namespace variables after loading the tcltest package.
+	For example, some of the tcltest variables are:
 		  ::tcltest::match
 		  ::tcltest::skip
 		  ::tcltest::testConfig(nonPortable)
@@ -90,10 +126,6 @@ the constraints mechanism to skip those tests.
    TESTS      ::tcltest::match
    testConfig ::tcltest::testConfig
 
-   The introduction of the "tcltest" namespace is a precursor to using
-   a "tcltest" package.  This next step will be part of a future Tcl
-   version.
-
 2) VERBOSE values are no longer numeric.  Please see the section above
    on "Test output" for the new usage of the ::tcltest::verbose variable.