clarify comments

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@10663 91177308-0d34-0410-b5e6-96231b3b80d8

include/Support/SlowOperationInformer.h

@@ -8,14 +8,13 @@
 //===----------------------------------------------------------------------===//
 //
 // This file defines a simple object which can be used to let the user know what
-// is going on when a slow operation is happening,l and gives them the ability
+// is going on when a slow operation is happening, and gives them the ability to
-// to cancel it.  Potentially slow operations can stack allocate one of these
+// cancel it.  Potentially slow operations can stack allocate one of these
 // objects, and periodically call the "progress" method to update the progress
-// bar.  If the operation takes more than 3 seconds to complete, the progress
+// bar.  If the operation takes more than 1 second to complete, the progress bar
-// bar is automatically shown and updated every second.  As such, the slow
+// is automatically shown and updated.  As such, the slow operation should not
-// operation should not print stuff to the screen, and should not be confused if
+// print stuff to the screen, and should not be confused if an extra line
-// an extra line appears on the screen (ie, the cursor should be at the start of
+// appears on the screen (ie, the cursor should be at the start of the line).
-// the line).
 //
 // If the user presses CTRL-C during the operation, the next invocation of the
 // progress method with throw an std::string object indicating that the
@@ -23,9 +22,9 @@
 // the progress method.
 //
 // Because SlowOperationInformers fiddle around with signals, they cannot be
-// nested.  The SIGINT signal handler is restored after the
+// nested, and interact poorly with threads.  The SIGALRM handler is set back to
-// SlowOperationInformer is destroyed, but the SIGALRM handlers is set back to
+// SIGDFL, but the SIGINT signal handler is restored when the
-// the default.
+// SlowOperationInformer is destroyed.
 //
 //===----------------------------------------------------------------------===//
 

include/llvm/Support/SlowOperationInformer.h

@@ -8,14 +8,13 @@
 //===----------------------------------------------------------------------===//
 //
 // This file defines a simple object which can be used to let the user know what
-// is going on when a slow operation is happening,l and gives them the ability
+// is going on when a slow operation is happening, and gives them the ability to
-// to cancel it.  Potentially slow operations can stack allocate one of these
+// cancel it.  Potentially slow operations can stack allocate one of these
 // objects, and periodically call the "progress" method to update the progress
-// bar.  If the operation takes more than 3 seconds to complete, the progress
+// bar.  If the operation takes more than 1 second to complete, the progress bar
-// bar is automatically shown and updated every second.  As such, the slow
+// is automatically shown and updated.  As such, the slow operation should not
-// operation should not print stuff to the screen, and should not be confused if
+// print stuff to the screen, and should not be confused if an extra line
-// an extra line appears on the screen (ie, the cursor should be at the start of
+// appears on the screen (ie, the cursor should be at the start of the line).
-// the line).
 //
 // If the user presses CTRL-C during the operation, the next invocation of the
 // progress method with throw an std::string object indicating that the
@@ -23,9 +22,9 @@
 // the progress method.
 //
 // Because SlowOperationInformers fiddle around with signals, they cannot be
-// nested.  The SIGINT signal handler is restored after the
+// nested, and interact poorly with threads.  The SIGALRM handler is set back to
-// SlowOperationInformer is destroyed, but the SIGALRM handlers is set back to
+// SIGDFL, but the SIGINT signal handler is restored when the
-// the default.
+// SlowOperationInformer is destroyed.
 //
 //===----------------------------------------------------------------------===//