Mercurial > emacs

changeset 105622:929678fafdb4

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
* variables.texi (Constant Variables): Distinguish from defconst variables. (Defining Variables): Add cindex.
author Chong Yidong <cyd@stupidchicken.com>
date Fri, 16 Oct 2009 02:20:29 +0000
parents 2a7dac6bff40
children e5d284379e14
files doc/lispref/ChangeLog doc/lispref/variables.texi
diffstat 2 files changed, 13 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/doc/lispref/ChangeLog	Fri Oct 16 00:48:52 2009 +0000
+++ b/doc/lispref/ChangeLog	Fri Oct 16 02:20:29 2009 +0000
@@ -1,3 +1,9 @@
+2009-10-16  Chong Yidong  <cyd@stupidchicken.com>
+
+	* variables.texi (Constant Variables): Distinguish from defconst
+	variables.
+	(Defining Variables): Add cindex.
+
 2009-10-15  Chong Yidong  <cyd@stupidchicken.com>
 
 	* os.texi (Time of Day): Clarify that the microsecond part is
--- a/doc/lispref/variables.texi	Fri Oct 16 00:48:52 2009 +0000
+++ b/doc/lispref/variables.texi	Fri Oct 16 02:20:29 2009 +0000
@@ -134,6 +134,12 @@
 @code{nil} otherwise.
 @end defun
 
+These constants are fundamentally different from the ``constants''
+defined using the @code{defconst} special form (@pxref{Defining
+Variables}).  A @code{defconst} form serves to inform human readers
+that you do not intend to change the value of a variable, but Emacs
+does not raise an error if you actually change it.
+
 @node Local Variables
 @section Local Variables
 @cindex binding local variables
@@ -523,6 +529,7 @@
 at top level in a file where its value does not matter.
 @end defspec
 
+@cindex constant variables
 @defspec defconst symbol value [doc-string]
 This special form defines @var{symbol} as a value and initializes it.
 It informs a person reading your code that @var{symbol} has a standard