Add more comments.

llvm-svn: 116583
diff --git a/lldb/test/lldbtest.py b/lldb/test/lldbtest.py
index 3954b56..6a5faa9 100644
--- a/lldb/test/lldbtest.py
+++ b/lldb/test/lldbtest.py
@@ -411,7 +411,9 @@
         self.old_stderr = sys.stderr
         sys.stderr = self.session
 
-        # Optimistically set self.failed to False initially.
+        # Optimistically set self.__failed__ to False initially.  If the test
+        # failed, the session info (self.session) is then dumped into a session
+        # specific file for diagnosis.
         self.__failed__ = False
 
     def setTearDownCleanup(self, dictionary=None):
@@ -422,7 +424,8 @@
         """Callback invoked when we (the test case instance) failed."""
         self.__failed__ = True
         with recording(self, False) as sbuf:
-            # False because there's no need to write "FAIL" to the stderr again.
+            # False because there's no need to write "FAIL" to the stderr twice.
+            # Once by the Python unittest framework, and a second time by us.
             print >> sbuf, "FAIL"
 
     def dumpSessionInfo(self):