[Emacs-diffs] trunk r116249: * doc/misc/cl.texi (Blocks and Exits): Mention cl-tagbody.

[Glenn Morris]

------------------------------------------------------------
revno: 116249
revision-id: address@hidden
parent: address@hidden
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Sun 2014-02-02 18:58:13 -0800
message:
  * doc/misc/cl.texi (Blocks and Exits): Mention cl-tagbody.
  
  * etc/NEWS: Related edit.
modified:
  doc/misc/ChangeLog             changelog-20091113204419-o5vbwnq5f7feedwu-6331
  doc/misc/cl.texi               cl.texi-20091113204419-o5vbwnq5f7feedwu-6292
  etc/NEWS                       news-20100311060928-aoit31wvzf25yr1z-1

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2014-02-02 01:16:18 +0000
+++ b/doc/misc/ChangeLog        2014-02-03 02:58:13 +0000
@@ -1,3 +1,7 @@
+2014-02-03  Glenn Morris  <address@hidden>
+
+       * cl.texi (Blocks and Exits): Mention cl-tagbody.
+
 2014-02-02  Glenn Morris  <address@hidden>
 
        * efaq-w32.texi (Tramp ssh): Remove deleted tramp methods.

=== modified file 'doc/misc/cl.texi'
--- a/doc/misc/cl.texi  2014-01-10 19:40:32 +0000
+++ b/doc/misc/cl.texi  2014-02-03 02:58:13 +0000
@@ -1556,6 +1556,19 @@
 themselves in @code{nil} blocks.
 @end defmac
 
address@hidden FIXME?  Maybe this should be in a separate section?
address@hidden cl-tagbody &rest labels-or-statements
+This macro executes statements while allowing for control transfer to
+user-defined labels.  Each element of @var{labels-or-statements} can
+be either a label (an integer or a symbol), or a cons-cell
+(a statement).  This distinction is made before macroexpansion.
+Statements are executed in sequence, discarding any return value.
+Any statement can transfer control at any time to the statements that follow
+one of the labels with the special form @code{(go LABEL)}.
+Labels have lexical scope and dynamic extent.
address@hidden defmac
+
+
 @node Iteration
 @section Iteration
 

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2014-02-03 01:03:11 +0000
+++ b/etc/NEWS  2014-02-03 02:58:13 +0000
@@ -424,7 +424,9 @@
 
 ** cl-lib
 
++++
 *** New macro `cl-tagbody'.
+This executes statements while allowing for control transfer to labels.
 
 +++
 *** letf is now just an alias for cl-letf.