[Emacs-diffs] trunk r115553: * lisp/emacs-lisp/gv.el (gv-ref): Mention lexbind restriction.

[Stefan Monnier]

------------------------------------------------------------
revno: 115553
revision-id: address@hidden
parent: address@hidden
fixes bug: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=16153
committer: Stefan Monnier <address@hidden>
branch nick: trunk
timestamp: Mon 2013-12-16 14:12:21 -0500
message:
  * lisp/emacs-lisp/gv.el (gv-ref): Mention lexbind restriction.
modified:
  lisp/ChangeLog                 changelog-20091113204419-o5vbwnq5f7feedwu-1432
  lisp/emacs-lisp/gv.el          setf.el-20120531120738-6w8114hk2anryyud-1

=== modified file 'lisp/ChangeLog'
--- a/lisp/ChangeLog    2013-12-16 15:49:25 +0000
+++ b/lisp/ChangeLog    2013-12-16 19:12:21 +0000
@@ -1,3 +1,7 @@
+2013-12-16  Stefan Monnier  <address@hidden>
+
+       * emacs-lisp/gv.el (gv-ref): Mention lexbind restriction (bug#16153).
+
 2013-12-16  Teodor Zlatanov  <address@hidden>
 
        * progmodes/cfengine.el (cfengine3--current-word): Remove.
@@ -9,8 +13,8 @@
 
 2013-12-16  Martin Rudalics  <address@hidden>
 
-       * window.el (display-buffer-below-selected): Bind
-       split-height-threshold to 0 as suggested by Juri Linkov.
+       * window.el (display-buffer-below-selected):
+       Bind split-height-threshold to 0 as suggested by Juri Linkov.
 
 2013-12-16  Leo Liu  <address@hidden>
 

=== modified file 'lisp/emacs-lisp/gv.el'
--- a/lisp/emacs-lisp/gv.el     2013-11-06 02:10:18 +0000
+++ b/lisp/emacs-lisp/gv.el     2013-12-16 19:12:21 +0000
@@ -454,7 +454,10 @@
 ;;;###autoload
 (defmacro gv-ref (place)
   "Return a reference to PLACE.
-This is like the `&' operator of the C language."
+This is like the `&' operator of the C language.
+Note: this only works reliably with lexical binding mode, except for very
+simple PLACEs such as (function-symbol 'foo) which will also work in dynamic
+binding mode."
   (gv-letplace (getter setter) place
     `(cons (lambda () ,getter)
            (lambda (gv--val) ,(funcall setter 'gv--val)))))