X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/ae0d461554a9351a0d897ce0e60b47fc9670431e..576e9b27cb20ab6a87314482952355cc53a824fa:/doc/lispref/symbols.texi diff --git a/doc/lispref/symbols.texi b/doc/lispref/symbols.texi index 9f91654990..e6dc4df629 100644 --- a/doc/lispref/symbols.texi +++ b/doc/lispref/symbols.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990-1995, 1998-1999, 2001-2013 Free Software +@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 @@ -35,7 +35,7 @@ otherwise. @section Symbol Components @cindex symbol components - Each symbol has four components (or ``cells''), each of which + Each symbol has four components (or cells), each of which references another object: @table @asis @@ -176,7 +176,7 @@ cause complete confusion. @cindex obarray @cindex bucket (in obarray) When the Lisp reader encounters a symbol, it reads all the characters -of the name. Then it ``hashes'' those characters to find an index in a +of the name. Then it hashes those characters to find an index in a table called an @dfn{obarray}. Hashing is an efficient method of looking something up. For example, instead of searching a telephone book cover to cover when looking up Jan Jones, you start with the J's @@ -525,7 +525,7 @@ The value is an expression for determining whether the named menu item should be enabled in menus. @xref{Simple Menu Items}. @item mode-class -If the value is @code{special}, the named major mode is ``special''. +If the value is @code{special}, the named major mode is special. @xref{Major Mode Conventions}. @item permanent-local @@ -539,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