diff --git a/doc/man/cbmc.1 b/doc/man/cbmc.1 index 52fecd2dfb2..8779adc7b34 100644 --- a/doc/man/cbmc.1 +++ b/doc/man/cbmc.1 @@ -389,13 +389,13 @@ sensitivity size for arrays to 0 \fB\-\-show\-loops\fR show the loops in the program .TP -\fB\-\-unwind\fR nr -unwind nr times +\fB\-\-unwind\fR \fInr\fR +unwind all loops at most \fInr\fR times .TP -\fB\-\-unwindset\fR [T:]L:B,... -unwind loop L with a bound of B -(optionally restricted to thread T) -(use \fB\-\-show\-loops\fR to get the loop IDs) +\fB\-\-unwindset\fR [\fIT\fR:]\fIL\fR:\fIB\fR,... +unwind loop \fIL\fR with a bound of \fIB\fR, optionally restricted to thread +\fIT\fR, and overriding what may be set as default unwinding via +\fB\-\-unwind\fR (use \fB\-\-show\-loops\fR to get the loop IDs) .TP \fB\-\-incremental\-loop\fR L check properties after each unwinding @@ -424,11 +424,14 @@ show the verification conditions remove assignments unrelated to property .TP \fB\-\-unwinding\-assertions\fR -generate unwinding assertions (cannot be -used with \fB\-\-cover\fR) +generate unwinding assertions (which are enabled by default; overrides +\fB\-\-no\-unwinding\-assertions\fR when both of these are given); cannot be +used with \fB\-\-cover\fR .TP \fB\-\-partial\-loops\fR -permit paths with partial loops +permit paths that execute loops only partially (up to the given unwinding bound) +and then continue beyond the loop even when the loop condition would still hold +(such paths may be spurious, making the analysis unsound) .TP \fB\-\-no\-self\-loops\-to\-assumptions\fR do not simplify while(1){} to assume(0) diff --git a/doc/man/goto-instrument.1 b/doc/man/goto-instrument.1 index 960a2ec0354..799db820c1c 100644 --- a/doc/man/goto-instrument.1 +++ b/doc/man/goto-instrument.1 @@ -849,7 +849,7 @@ empty the function pointer is removed using the standard show the loops in the program .TP \fB\-\-unwind\fR \fInr\fR -unwind nr times +unwind all loops \fInr\fR times .TP \fB\-\-unwindset\fR [\fIT\fR:]\fIL\fR:\fIB\fR,... unwind loop \fIL\fR with a bound of \fIB\fR @@ -860,13 +860,15 @@ unwind loop \fIL\fR with a bound of \fIB\fR read unwindset from file .TP \fB\-\-partial\-loops\fR -permit paths with partial loops +permit paths that execute loops only partially (up to the given unwinding bound) +and then continue beyond the loop even when the loop condition would still hold +(such paths may be spurious, making the analysis unsound) .TP \fB\-\-no\-unwinding\-assertions\fR do not generate unwinding assertions .TP \fB\-\-unwinding\-assertions\fR -generate unwinding assertions (enabled by default; overrides +generate unwinding assertions (which are enabled by default; overrides \fB\-\-no\-unwinding\-assertions\fR when both of these are given) .TP \fB\-\-continue\-as\-loops\fR diff --git a/doc/man/jbmc.1 b/doc/man/jbmc.1 index 2dde319abd2..69c2bc721d6 100644 --- a/doc/man/jbmc.1 +++ b/doc/man/jbmc.1 @@ -312,12 +312,12 @@ sensitivity size for arrays to 0 show the loops in the program .TP \fB\-\-unwind\fR nr -unwind nr times +unwind all loops at most nr times .TP -\fB\-\-unwindset\fR [T:]L:B,... -unwind loop L with a bound of B -(optionally restricted to thread T) -(use \fB\-\-show\-loops\fR to get the loop IDs) +\fB\-\-unwindset\fR [\fIT\fR:]\fIL\fR:\fIB\fR,... +unwind loop \fIL\fR with a bound of \fIB\fR, optionally restricted to thread +\fIT\fR, and overriding what may be set as default unwinding via +\fB\-\-unwind\fR (use \fB\-\-show\-loops\fR to get the loop IDs) .TP \fB\-\-incremental\-loop\fR L check properties after each unwinding @@ -346,14 +346,17 @@ show the verification conditions remove assignments unrelated to property .TP \fB\-\-unwinding\-assertions\fR -generate unwinding assertions (cannot be -used with \fB\-\-cover\fR) +generate unwinding assertions (which are enabled by default; overrides +\fB\-\-no\-unwinding\-assertions\fR when both of these are given); cannot be +used with \fB\-\-cover\fR .TP \fB\-\-no\-unwinding\-assertions\fR do not generate unwinding assertions .TP \fB\-\-partial\-loops\fR -permit paths with partial loops +permit paths that execute loops only partially (up to the given unwinding bound) +and then continue beyond the loop even when the loop condition would still hold +(such paths may be spurious, making the analysis unsound) .TP \fB\-\-no\-self\-loops\-to\-assumptions\fR do not simplify while(1){} to assume(0)