changeset 53099:0d765aaa0e44

In node defvar and asterisk, following suggestions by Juri Linkov <[e-mail]>, describe using the set-variable command to set values temporarily and to show a list of variables by using completion.

--- a/lispintro/emacs-lisp-intro.texi	Wed Nov 19 13:23:43 2003 +0000
+++ b/lispintro/emacs-lisp-intro.texi	Wed Nov 19 21:04:04 2003 +0000
@@ -21,8 +21,8 @@
 
 @comment %**end of header
 
-@set edition-number 2.11
-@set update-date 2003 Nov 16
+@set edition-number 2.12
+@set update-date 2003 Nov 19
 
 @ignore
  ## Summary of shell commands to create various output formats:
@@ -8066,8 +8066,8 @@
 variables that you do expect a user to change.  Although you can still
 use @code{defvar} for user customizable variables, please use
 @code{defcustom} instead, since that special form provides a path into
-the Customization commands.  (@xref{defcustom, , Setting Variables
-with @code{defcustom}}.)
+the Customization commands.  (@xref{defcustom, , Specifying Variables
+using @code{defcustom}}.)
 
 When you specified a variable using the @code{defvar} special form,
 you could distinguish a readily settable variable from others by
@@ -8082,26 +8082,24 @@
 @end group
 @end smallexample
 
-@ignore
-@c commented out on 2003 Nov 17, since edit-options no longer described
-
-@noindent
-This means that you could (and still can) use the @code{edit-options}
-command to change the value of
-@code{shell-command-default-error-buffer} temporarily.
-
-@findex edit-options
-However, options set using @code{edit-options} are set only for the
-duration of your editing session.  The new values are not saved
-between sessions.  Each time Emacs starts, it reads the original
+@findex set-variable
+@noindent
+You could (and still can) use the @code{set-variable} command to
+change the value of @code{shell-command-default-error-buffer}
+temporarily.  However, options set using @code{set-variable} are set
+only for the duration of your editing session.  The new values are not
+saved between sessions.  Each time Emacs starts, it reads the original
 value, unless you change the value within your @file{.emacs} file,
 either by setting it manually or by using @code{customize}.
 @xref{Emacs Initialization, , Your @file{.emacs} File}.
 
-For me, the major use of the @code{edit-options} command is to suggest
-variables that I might want to set in my @file{.emacs} file.  I urge
-you to look through the list.
-@end ignore
+For me, the major use of the @code{set-variable} command is to suggest
+variables that I might want to set in my @file{.emacs} file.  There
+are now more than 700 such variables --- far too many to remember
+readily.  Fortunately, you can press @key{TAB} after calling the
+@code{M-x set-variable} command to see the list of variables.
+(@xref{Examining, , Examining and Setting Variables, emacs,
+The GNU Emacs Manual}.)
 
 @node copy-region-as-kill, cons & search-fwd Review, defvar, Cutting & Storing Text
 @comment  node-name,  next,  previous,  up
@@ -14376,7 +14374,7 @@
 @end smallexample
 
 @noindent
-(@xref{defcustom, , Setting Variables with @code{defcustom}}.
+(@xref{defcustom, , Specifying Variables using @code{defcustom}}.)
 Then evaluate the @code{lengths-list-file} expression.)
 
 @need 1200
@@ -16128,9 +16126,9 @@
 The name of the variable is @code{text-mode-hook}; it has no default
 value; and its documentation string tells you what it does.
 
-The @code{:type} keyword tells Emacs what kind of data
-@code{text-mode-hook} should be set to and how to display the value in
-a Customization buffer.
+The @code{:type} keyword tells Emacs the kind of data to which
+@code{text-mode-hook} should be set and how to display the value in a
+Customization buffer.
 
 The @code{:options} keyword specifies a suggested list of values for
 the variable.  Currently, you can use @code{:options} only for a hook.