Removed -asidefromdir and -relateddir flags, removed unused

::tcltest::dotests proc, cleaned up implementation of core file checking,
and fixed the code that checks for 1-letter flag abbreviations.

1 files changed, 22 insertions, 23 deletions

diff --git a/doc/tcltest.n b/doc/tcltest.n
index b065333..951595b 100644
--- a/doc/tcltest.n
+++ b/doc/tcltest.n
@@ -6,7 +6,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: tcltest.n,v 1.2 1999/06/29 20:14:10 jenn Exp $
+'\" RCS: @(#) $Id: tcltest.n,v 1.3 1999/07/09 00:01:01 jenn Exp $
 '\" 
 .so man.macros
 .TH "Tcltest" n 8.1 Tcl "Tcl Built-In Commands"
@@ -23,8 +23,6 @@ Tcltest \- Test harness support code and utilities
 .sp
 \fB::tcltest::getMatchingTestFiles
 .sp
-\fB::tcltest::dotests \fIfile pattern\fR
-.sp
 \fB::tcltest::makeFile \fIcontents name\fR
 .sp
 \fB::tcltest::removeFile \fIname\fR
@@ -98,9 +96,6 @@ This command is used when you want to run multiple test files.  It returns
 the list of tests that should be sourced in an 'all.tcl' file.  See the
 section \fI"Running test files"\fR for more information.
 .TP
-\fB::tcltest::dotests\fP \fIfile pattern\fR
-Source a test file and run tests of the specified pattern.
-.TP
 \fB::tcltest::makeFile\fP \fIcontents name\fR
 Create a file that will be automatically be removed by
 \fB::tcltest::cleanupTests\fR at the end of a test run.
@@ -224,8 +219,7 @@ the output directory - defaults to the current working directory and can be
 specified using -tmpdir
 .TP
 \fB::tcltest::testsDirectory\fR
-where the tests reside - defaults to [pwd] and can be affected by use of
--relateddir and -asidefromdir
+where the tests reside 
 .TP
 \fB::tcltest::isoLocale\fR
 used for internationalization support - default language is French; default
@@ -383,14 +377,6 @@ only source test files that match any of the items in
 source files except for those that match any of the items in
 <globPatternList> (relative to ::tcltest::testsDirectory).  
 .TP
-\fB-relateddir <globPattern>\fR
-only run tests in the directories that match <globPattern> (relative to the
-current directory).
-.TP
-\fB-asidefromdir <globPattern>\fR
-use all specified directories except those that match <globPattern> (relative
-to the current directory).
-.TP
 \fB-constraints <list>\fR
 tests with any constraints in <list> will not be skipped.  Note that
 elements of <list> must exactly match the existing constraints.
@@ -406,23 +392,36 @@ put any temporary files (created with ::tcltest::makeFile and
 ::tcltest::makeDirectory) into the named directory.  The default
 location is your current working directory.
 .TP
-\fB-preservecore <bool>\fR
-If the argument to this flag is 1 (true), the test harness saves any
-core files produced at the end of a test run in
-::tcltest::temporaryDirectory. The default value for this flag is 0
-(false).
+\fB-preservecore <level>\fR
+check for core files.  This flag is used to determine how much
+checking should be done for core files.  The default value for
+\fIlevel\fR is 0.  Levels are defined as:
+.RS
+.IP 0
+No checking - do not check for core files at the end of each test
+command, but do check for them whenever ::tcltest::cleanupTests is
+called from an all.tcl file. 
+.IP 1
+Check for core files at the end of each test command and whenever
+::tcltest::cleanupTests is called from all.tcl.
+.IP 2
+Check for core files at the end of all test commands and whenever
+::tcltest::cleanupTests is called from all.tcl.  Save any core files
+produced in ::tcltest::temporaryDirectory.
 .TP
 \fB-debug <debugLevel>\fR
 print out debug information.  This is used to debug code in the test
-harness.  The default debug level is 1.  Levels are defined as:
+harness.  The default debug level is 0.  Levels are defined as:
 .RS
+.IP 0
+Do not display any debug information.
 .IP 1
 Display information regarding whether a test is skipped because it
 doesn't match any of the tests that were specified using -match or
 ::tcltest::match (userSpecifiedNonMatch) or matches any of the tests
 specified by -skip or ::tcltest::skip (userSpecifiedSkip).  
 .IP 2
-Display the flag array parssed by the command line processor, the
+Display the flag array parsed by the command line processor, the
 contents of the env array, and all user-defined variables that exist
 in the current namespace as they are used.
 .IP 3