llvm.org GIT mirror llvm / cf90277
clarify comments git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@10663 91177308-0d34-0410-b5e6-96231b3b80d8 Chris Lattner 16 years ago
2 changed file(s) with 18 addition(s) and 20 deletion(s). Raw diff Collapse all Expand all
77 //===----------------------------------------------------------------------===//
88 //
99 // This file defines a simple object which can be used to let the user know what
10 // is going on when a slow operation is happening,l and gives them the ability
11 // to cancel it. Potentially slow operations can stack allocate one of these
10 // is going on when a slow operation is happening, and gives them the ability to
11 // cancel it. Potentially slow operations can stack allocate one of these
1212 // objects, and periodically call the "progress" method to update the progress
13 // bar. If the operation takes more than 3 seconds to complete, the progress
14 // bar is automatically shown and updated every second. As such, the slow
15 // operation should not print stuff to the screen, and should not be confused if
16 // an extra line appears on the screen (ie, the cursor should be at the start of
17 // the line).
13 // bar. If the operation takes more than 1 second to complete, the progress bar
14 // is automatically shown and updated. As such, the slow operation should not
15 // print stuff to the screen, and should not be confused if an extra line
16 // appears on the screen (ie, the cursor should be at the start of the line).
1817 //
1918 // If the user presses CTRL-C during the operation, the next invocation of the
2019 // progress method with throw an std::string object indicating that the
2221 // the progress method.
2322 //
2423 // Because SlowOperationInformers fiddle around with signals, they cannot be
25 // nested. The SIGINT signal handler is restored after the
26 // SlowOperationInformer is destroyed, but the SIGALRM handlers is set back to
27 // the default.
24 // nested, and interact poorly with threads. The SIGALRM handler is set back to
25 // SIGDFL, but the SIGINT signal handler is restored when the
26 // SlowOperationInformer is destroyed.
2827 //
2928 //===----------------------------------------------------------------------===//
3029
77 //===----------------------------------------------------------------------===//
88 //
99 // This file defines a simple object which can be used to let the user know what
10 // is going on when a slow operation is happening,l and gives them the ability
11 // to cancel it. Potentially slow operations can stack allocate one of these
10 // is going on when a slow operation is happening, and gives them the ability to
11 // cancel it. Potentially slow operations can stack allocate one of these
1212 // objects, and periodically call the "progress" method to update the progress
13 // bar. If the operation takes more than 3 seconds to complete, the progress
14 // bar is automatically shown and updated every second. As such, the slow
15 // operation should not print stuff to the screen, and should not be confused if
16 // an extra line appears on the screen (ie, the cursor should be at the start of
17 // the line).
13 // bar. If the operation takes more than 1 second to complete, the progress bar
14 // is automatically shown and updated. As such, the slow operation should not
15 // print stuff to the screen, and should not be confused if an extra line
16 // appears on the screen (ie, the cursor should be at the start of the line).
1817 //
1918 // If the user presses CTRL-C during the operation, the next invocation of the
2019 // progress method with throw an std::string object indicating that the
2221 // the progress method.
2322 //
2423 // Because SlowOperationInformers fiddle around with signals, they cannot be
25 // nested. The SIGINT signal handler is restored after the
26 // SlowOperationInformer is destroyed, but the SIGALRM handlers is set back to
27 // the default.
24 // nested, and interact poorly with threads. The SIGALRM handler is set back to
25 // SIGDFL, but the SIGINT signal handler is restored when the
26 // SlowOperationInformer is destroyed.
2827 //
2928 //===----------------------------------------------------------------------===//
3029