]> code.delx.au - gnu-emacs/blobdiff - doc/lispref/symbols.texi
Update copyright year to 2015
[gnu-emacs] / doc / lispref / symbols.texi
index 840097091568af2dbd96cc79df18c40042a99e9d..a6545eae7325cc991f86ab2e7725d9724aa58732 100644 (file)
@@ -1,6 +1,7 @@
 @c -*-texinfo-*-
 @c This is part of the GNU Emacs Lisp Reference Manual.
-@c Copyright (C) 1990-1995, 1998-1999, 2001-2012 Free Software Foundation, Inc.
+@c Copyright (C) 1990-1995, 1998-1999, 2001-2015 Free Software
+@c Foundation, Inc.
 @c See the file elisp.texi for copying conditions.
 @node Symbols
 @chapter Symbols
@@ -153,8 +154,8 @@ that cell can hold only one Lisp object at any given time.
 @xref{Macros}.
 
   As previously noted, Emacs Lisp allows the same symbol to be defined
-both as a variable (e.g.@: with @code{defvar}) and as a function or
-macro (e.g.@: with @code{defun}).  Such definitions do not conflict.
+both as a variable (e.g., with @code{defvar}) and as a function or
+macro (e.g., with @code{defun}).  Such definitions do not conflict.
 
   These definition also act as guides for programming tools.  For
 example, the @kbd{C-h f} and @kbd{C-h v} commands create help buffers
@@ -538,8 +539,9 @@ deleted from the local value of a hook variable when changing major
 modes.  @xref{Setting Hooks}.
 
 @item pure
-This property is used internally to mark certain named functions for
-byte compiler optimization.  Do not set it.
+If the value is non-@code{nil}, the named function is considered to be
+side-effect free.  Calls with constant arguments can be evaluated at
+compile time.  This may shift run time errors to compile time.
 
 @item risky-local-variable
 If the value is non-@code{nil}, the named variable is considered risky
@@ -563,7 +565,7 @@ side-effects, for determining function safety (@pxref{Function
 Safety}) as well as for byte compiler optimizations.  Do not set it.
 
 @item variable-documentation
-If non-@code{nil}, this specifies the named vaariable's documentation
+If non-@code{nil}, this specifies the named variable's documentation
 string.  This is set automatically by @code{defvar} and related
 functions.  @xref{Defining Faces}.
 @end table