Change behavior of 'decreases *', which can be applied to loops and methods. Now, loops that may possibly

do an infinite number of iterations (that is, loops marked with 'decreases *') and calls to methods
marked with 'decreases *' are allowed only in methods that themselves are marked with 'decreases *'.  As
before, ghost loops and ghost methods are not allowed to be marked with 'decreases *'.

Previously, 'decreases *' was allowed on a method only if the method was tail recursive;
this is no longer so.  Note, however, that if the method is not tail recursive and engages
in infinite recursion, then it will eventually run out of stack space.

Previously, a 'decreases *' was not inherited in a refining module; this is no longer so.
That is, 'decreases *' is now inherited.  To refine a possibly non-terminating method
or loop, the refining version simply provides a decreases clause that does not mention '*'.
Note that if the refined method is not recursive, it still needs to have _some_ decreases
clause in order not to inherit the 'decreases *' from the refined method, but the expression
stated in the decreases clause can be arbitrary (for example, one can write 'decreases true'
or 'decreases 7' or 'decreases x' for some 'x' in scope).

Note, in the new design, a method needs to be declared with 'decreases *' if
it may recurse forever _or_ if it contains a possibly infinite loop.

Note that the absence of 'decreases *' on a loop does not mean the loop will
terminate, but it does mean that the loop will iterate a finite number of times
(the subtle distinction here is that a loop without a 'decreases *' is allowed
to contain a nested loop that has a 'decreases *' -- provided the enclosing
method is also declared with 'decreases *', as previously mentioned).

1 files changed, 20 insertions, 0 deletions

diff --git a/Test/dafny0/Termination.dfy b/Test/dafny0/Termination.dfy
index 377865fe..70c30aa6 100644
--- a/Test/dafny0/Termination.dfy
+++ b/Test/dafny0/Termination.dfy
@@ -275,6 +275,7 @@ function Zipper2<T>(a: List<T>, b: List<T>): List<T>
 

 method WhileStar0(n: int)

   requires 2 <= n;

+  decreases *;

 {

   var m := n;

   var k := 0;

@@ -429,3 +430,22 @@ class C {
     }

   }

 }

+

+// --------------------- decreases * tests

+

+module TerminationRefinement0 {

+  method M(x: int)

+    decreases *;

+  {

+    M(x);  // error [in TerminationRefinement1]: bad recursion

+           // Note, no complaint is issued in TerminationRefinement0, since

+           // the method is declared with 'decreases *'.

+  }

+}

+module TerminationRefinement1 refines TerminationRefinement0 {

+  method M...

+    decreases 4;  // this will cause termination checking to be done, and it will produce an error message for the recursive call

+  {

+    ...;

+  }

+}