Merge pull request #876 from melezhik/master

Exceptions handlers and enclosing blocks.

Author: gfldex

doc/Language/exceptions.pod6

@@ -62,6 +62,55 @@ To handle all exceptions use a C<default> statement.
         }
    }
 
+
+##  Exceptions handlers and enclosing blocks. 
+
+After a CATCH has handled the exception, the block enclosing the CATCH is left.
+
+In other words even exception is handled successfully, the I<rest of code>  in the enclosing block will never be executed
+as enclosing block gets left immediately:
+
+
+  die "something went wrong ...";
+  
+  CATCH {
+      # will definitely catch all the exception
+      default { .Str.say; }
+  }
+  
+  # but this line will be never reached
+  # as once default exception handler
+  # gets executed
+  # a enclosing block - mainline of the program
+  # will be left immediately
+
+  say "This won't be said.";
+  
+  
+Output:
+
+  something went wrong ...
+
+Compare  with this one:
+
+  CATCH {
+  
+    CATCH {
+        default { .Str.say; }
+    }
+  
+    die "something went wrong ...";
+  
+  }
+  
+  say "Hi! I am at the outer block!";
+  
+Output:
+
+  Hi! I am at the outer block!
+
+See also "Resuming of Exceptions" to know who to return control to the statement following the statement that threw the exception.
+
 =head1 X<C<try>|try blocks> blocks
 
 To contain an exception use a C<try> block. Any exception that is thrown in