[Emacs-diffs] emacs/doc/lispref ChangeLog streams.texi variab...

[Chong Yidong]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Chong Yidong <cyd>      09/04/29 03:13:16

Modified files:
        doc/lispref    : ChangeLog streams.texi variables.texi 

Log message:
        * variables.texi (File Local Variables): Note that read-circle is
        bound to nil when reading file-local variables.
        
        * streams.texi (Input Functions): Document read-circle.
        (Output Variables): Add xref to Circular Objects.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/ChangeLog?cvsroot=emacs&r1=1.265&r2=1.266
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/streams.texi?cvsroot=emacs&r1=1.4&r2=1.5
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/variables.texi?cvsroot=emacs&r1=1.16&r2=1.17

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/ChangeLog,v
retrieving revision 1.265
retrieving revision 1.266
diff -u -b -r1.265 -r1.266
--- ChangeLog   26 Apr 2009 02:35:18 -0000      1.265
+++ ChangeLog   29 Apr 2009 03:13:16 -0000      1.266
@@ -1,3 +1,11 @@
+2009-04-29  Chong Yidong  <address@hidden>
+
+       * variables.texi (File Local Variables): Note that read-circle is
+       bound to nil when reading file-local variables.
+
+       * streams.texi (Input Functions): Document read-circle.
+       (Output Variables): Add xref to Circular Objects.
+
 2009-04-25  Chong Yidong  <address@hidden>
 
        * tips.texi (Coding Conventions): Copyedits.  Add xref to Named

Index: streams.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/streams.texi,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -b -r1.4 -r1.5
--- streams.texi        8 Jan 2009 05:29:01 -0000       1.4
+++ streams.texi        29 Apr 2009 03:13:16 -0000      1.5
@@ -341,6 +341,12 @@
 The default is @code{t}, meaning use the minibuffer.
 @end defvar
 
address@hidden read-circle
+If address@hidden, this variable enables the reading of circular and
+shared structures.  @xref{Circular Objects}.  Its default value is
address@hidden
address@hidden defvar
+
 @node Output Streams
 @section Output Streams
 @cindex stream (for printing)
@@ -794,8 +800,8 @@
 and shared structure:
 
 @defvar print-circle
-If address@hidden, this variable enables detection of circular
-and shared structure in printing.
+If address@hidden, this variable enables detection of circular and
+shared structure in printing.  @xref{Circular Objects}
 @end defvar
 
 @defvar print-gensym

Index: variables.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/lispref/variables.texi,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -b -r1.16 -r1.17
--- variables.texi      4 Apr 2009 22:34:24 -0000       1.16
+++ variables.texi      29 Apr 2009 03:13:16 -0000      1.17
@@ -1539,6 +1539,11 @@
 those file-local variables whose specified values are known to be
 safe.  Other file-local variables are set only if the user agrees.
 
+  For additional safety, @code{read-circle} is temporarily bound to
address@hidden when Emacs reads file-local variables (@pxref{Input
+Functions}).  This prevents the Lisp reader from recognizing circular
+and shared Lisp structures (@pxref{Circular Objects}).
+
 @defopt enable-local-variables
 This variable controls whether to process file-local variables.
 The possible values are: