Update the comments for lldbtest module. The test driver is the only way to run the test suite.

llvm-svn: 156943

lldb/test/lldbtest.py

@@ -9,88 +9,23 @@ to locate the individual test cases when running as part of a large test suite
 or when running each test case as a separate python invocation.
 
 ./dotest.py provides a test driver which sets up the environment to run the
-entire test suite.  Users who want to run a test case on its own can specify the
+entire of part of the test suite .  Example:
-LLDB_TEST and PYTHONPATH environment variables, for example:
-
-$ export LLDB_TEST=$PWD
-$ export PYTHONPATH=/Volumes/data/lldb/svn/trunk/build/Debug/LLDB.framework/Resources/Python:$LLDB_TEST:$LLDB_TEST/plugins:$LLDB_TEST/pexpect-2.4
-$ echo $LLDB_TEST
-/Volumes/data/lldb/svn/trunk/test
-$ echo $PYTHONPATH
-/Volumes/data/lldb/svn/trunk/build/Debug/LLDB.framework/Resources/Python:/Volumes/data/lldb/svn/trunk/test:/Volumes/data/lldb/svn/trunk/test/plugins
-$ python function_types/TestFunctionTypes.py
-.
-----------------------------------------------------------------------
-Ran 1 test in 0.363s
-
-OK
-$ LLDB_COMMAND_TRACE=YES python array_types/TestArrayTypes.py
 
+# Exercises the test suite in the types directory....
+/Volumes/data/lldb/svn/ToT/test $ ./dotest.py -A x86_64 types
 ...
 
-runCmd: breakpoint set -f main.c -l 42
+Session logs for test failures/errors/unexpected successes will go into directory '2012-05-16-13_35_42'
-output: Breakpoint created: 1: file ='main.c', line = 42, locations = 1
+Command invoked: python ./dotest.py -A x86_64 types
+compilers=['clang']
 
-runCmd: run
+Configuration: arch=x86_64 compiler=clang
-output: Launching '/Volumes/data/lldb/svn/trunk/test/array_types/a.out'  (x86_64)
-
-...
-
-runCmd: frame variable strings
-output: (char *[4]) strings = {
-  (char *) strings[0] = 0x0000000100000f0c "Hello",
-  (char *) strings[1] = 0x0000000100000f12 "Hola",
-  (char *) strings[2] = 0x0000000100000f17 "Bonjour",
-  (char *) strings[3] = 0x0000000100000f1f "Guten Tag"
-}
-
-runCmd: frame variable char_16
-output: (char [16]) char_16 = {
-  (char) char_16[0] = 'H',
-  (char) char_16[1] = 'e',
-  (char) char_16[2] = 'l',
-  (char) char_16[3] = 'l',
-  (char) char_16[4] = 'o',
-  (char) char_16[5] = ' ',
-  (char) char_16[6] = 'W',
-  (char) char_16[7] = 'o',
-  (char) char_16[8] = 'r',
-  (char) char_16[9] = 'l',
-  (char) char_16[10] = 'd',
-  (char) char_16[11] = '\n',
-  (char) char_16[12] = '\0',
-  (char) char_16[13] = '\0',
-  (char) char_16[14] = '\0',
-  (char) char_16[15] = '\0'
-}
-
-runCmd: frame variable ushort_matrix
-output: (unsigned short [2][3]) ushort_matrix = {
-  (unsigned short [3]) ushort_matrix[0] = {
-    (unsigned short) ushort_matrix[0][0] = 0x0001,
-    (unsigned short) ushort_matrix[0][1] = 0x0002,
-    (unsigned short) ushort_matrix[0][2] = 0x0003
-  },
-  (unsigned short [3]) ushort_matrix[1] = {
-    (unsigned short) ushort_matrix[1][0] = 0x000b,
-    (unsigned short) ushort_matrix[1][1] = 0x0016,
-    (unsigned short) ushort_matrix[1][2] = 0x0021
-  }
-}
-
-runCmd: frame variable long_6
-output: (long [6]) long_6 = {
-  (long) long_6[0] = 1,
-  (long) long_6[1] = 2,
-  (long) long_6[2] = 3,
-  (long) long_6[3] = 4,
-  (long) long_6[4] = 5,
-  (long) long_6[5] = 6
-}
-
-.
 ----------------------------------------------------------------------
-Ran 1 test in 0.349s
+Collected 72 tests
+
+........................................................................
+----------------------------------------------------------------------
+Ran 72 tests in 135.468s
 
 OK
 $