/[emacs]/emacs/lispintro/emacs-lisp-intro.texi
ViewVC logotype

Diff of /emacs/lispintro/emacs-lisp-intro.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.15.2.2 by miles, Tue Oct 14 23:10:12 2003 UTC revision 1.15.2.3 by miles, Fri Nov 21 00:36:10 2003 UTC
# Line 21  Line 21 
21    
22  @comment %**end of header  @comment %**end of header
23    
24  @set edition-number 2.10  @set edition-number 2.12
25  @set update-date 2003 July 15  @set update-date 2003 Nov 19
26    
27  @ignore  @ignore
28   ## Summary of shell commands to create various output formats:   ## Summary of shell commands to create various output formats:
# Line 3519  this. Line 3519  this.
3519    
3520  Alternatively, if the special letter-codes are not right for your  Alternatively, if the special letter-codes are not right for your
3521  application, you can pass your own arguments to @code{interactive} as  application, you can pass your own arguments to @code{interactive} as
3522  a list.  @xref{interactive, , Using @code{Interactive}, elisp, The  a list.  @xref{Using Interactive, , Using @code{Interactive}, elisp, The
3523  GNU Emacs Lisp Reference Manual}, for more information about this advanced  GNU Emacs Lisp Reference Manual}, for more information about this advanced
3524  technique.  technique.
3525    
# Line 8066  internal variables that you would not ex Line 8066  internal variables that you would not ex
8066  variables that you do expect a user to change.  Although you can still  variables that you do expect a user to change.  Although you can still
8067  use @code{defvar} for user customizable variables, please use  use @code{defvar} for user customizable variables, please use
8068  @code{defcustom} instead, since that special form provides a path into  @code{defcustom} instead, since that special form provides a path into
8069  the Customization commands.  (@xref{defcustom, , Setting Variables  the Customization commands.  (@xref{defcustom, , Specifying Variables
8070  with @code{defcustom}}.)  using @code{defcustom}}.)
8071    
8072  When you specified a variable using the @code{defvar} special form,  When you specified a variable using the @code{defvar} special form,
8073  you could distinguish a readily settable variable from others by  you could distinguish a readily settable variable from others by
# Line 8082  string.  For example: Line 8082  string.  For example:
8082  @end group  @end group
8083  @end smallexample  @end smallexample
8084    
8085    @findex set-variable
8086  @noindent  @noindent
8087  This means that you could (and still can) use the @code{edit-options}  You could (and still can) use the @code{set-variable} command to
8088  command to change the value of  change the value of @code{shell-command-default-error-buffer}
8089  @code{shell-command-default-error-buffer} temporarily.  temporarily.  However, options set using @code{set-variable} are set
8090    only for the duration of your editing session.  The new values are not
8091  @findex edit-options  saved between sessions.  Each time Emacs starts, it reads the original
 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  
8092  value, unless you change the value within your @file{.emacs} file,  value, unless you change the value within your @file{.emacs} file,
8093  either by setting it manually or by using @code{customize}.  either by setting it manually or by using @code{customize}.
8094  @xref{Emacs Initialization, , Your @file{.emacs} File}.  @xref{Emacs Initialization, , Your @file{.emacs} File}.
8095    
8096  For me, the major use of the @code{edit-options} command is to suggest  For me, the major use of the @code{set-variable} command is to suggest
8097  variables that I might want to set in my @file{.emacs} file.  I urge  variables that I might want to set in my @file{.emacs} file.  There
8098  you to look through the list.  (@xref{Edit Options, , Editing Variable  are now more than 700 such variables --- far too many to remember
8099  Values, emacs, The GNU Emacs Manual}.)  readily.  Fortunately, you can press @key{TAB} after calling the
8100    @code{M-x set-variable} command to see the list of variables.
8101    (@xref{Examining, , Examining and Setting Variables, emacs,
8102    The GNU Emacs Manual}.)
8103    
8104  @node copy-region-as-kill, cons & search-fwd Review, defvar, Cutting & Storing Text  @node copy-region-as-kill, cons & search-fwd Review, defvar, Cutting & Storing Text
8105  @comment  node-name,  next,  previous,  up  @comment  node-name,  next,  previous,  up
# Line 9142  address-boxes, the first of which holds Line 9143  address-boxes, the first of which holds
9143  and the second of which holds the address of @code{buttercup}.  and the second of which holds the address of @code{buttercup}.
9144    
9145  A pair of address-boxes is called a @dfn{cons cell} or @dfn{dotted  A pair of address-boxes is called a @dfn{cons cell} or @dfn{dotted
9146  pair}.  @xref{List Type, , List Type , elisp, The GNU Emacs Lisp  pair}.  @xref{Cons Cell Type, , Cons Cell and List Types, elisp, The GNU Emacs Lisp
9147  Reference Manual}, and @ref{Dotted Pair Notation, , Dotted Pair  Reference Manual}, and @ref{Dotted Pair Notation, , Dotted Pair
9148  Notation, elisp, The GNU Emacs Lisp Reference Manual}, for more  Notation, elisp, The GNU Emacs Lisp Reference Manual}, for more
9149  information about cons cells and dotted pairs.  information about cons cells and dotted pairs.
# Line 14373  version, you may have to evaluate the fo Line 14374  version, you may have to evaluate the fo
14374  @end smallexample  @end smallexample
14375    
14376  @noindent  @noindent
14377  (@xref{defcustom, , Setting Variables with @code{defcustom}}.  (@xref{defcustom, , Specifying Variables using @code{defcustom}}.)
14378  Then evaluate the @code{lengths-list-file} expression.)  Then evaluate the @code{lengths-list-file} expression.)
14379    
14380  @need 1200  @need 1200
# Line 16125  For example, the customizable user optio Line 16126  For example, the customizable user optio
16126  The name of the variable is @code{text-mode-hook}; it has no default  The name of the variable is @code{text-mode-hook}; it has no default
16127  value; and its documentation string tells you what it does.  value; and its documentation string tells you what it does.
16128    
16129  The @code{:type} keyword tells Emacs what kind of data  The @code{:type} keyword tells Emacs the kind of data to which
16130  @code{text-mode-hook} should be set to and how to display the value in  @code{text-mode-hook} should be set and how to display the value in a
16131  a Customization buffer.  Customization buffer.
16132    
16133  The @code{:options} keyword specifies a suggested list of values for  The @code{:options} keyword specifies a suggested list of values for
16134  the variable.  Currently, you can use @code{:options} only for a hook.  the variable.  Currently, you can use @code{:options} only for a hook.

Legend:
Removed from v.1.15.2.2  
changed lines
  Added in v.1.15.2.3

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26