From 0c6087a609a6042e3daea9d1fa27c140c992952c Mon Sep 17 00:00:00 2001 From: "Richard M. Stallman" Date: Sun, 4 Sep 2005 01:37:17 +0000 Subject: [PATCH] (nil and t): Minor cleanup. Delete spurious mention of keyword symbols. (Evaluation Notation): Add index entry. (A Sample Function Description): Minor cleanup. (A Sample Variable Description): Not all vars can be set. --- lispref/ChangeLog | 8 ++++++++ lispref/intro.texi | 22 +++++++++++----------- 2 files changed, 19 insertions(+), 11 deletions(-) diff --git a/lispref/ChangeLog b/lispref/ChangeLog index 9c19c136926..f5079dc52a6 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog @@ -1,3 +1,11 @@ +2005-09-03 Joshua Varner (tiny change) + + * intro.texi (nil and t): Minor cleanup. + Delete spurious mention of keyword symbols. + (Evaluation Notation): Add index entry. + (A Sample Function Description): Minor cleanup. + (A Sample Variable Description): Not all vars can be set. + 2005-09-03 Thien-Thi Nguyen * text.texi (Buffer Contents): Use "\n" in examples' result strings. diff --git a/lispref/intro.texi b/lispref/intro.texi index 01ffeb3321c..8c3501c823b 100644 --- a/lispref/intro.texi +++ b/lispref/intro.texi @@ -197,7 +197,7 @@ in Lisp programs also. (not nil) ; @r{Emphasize the truth value @var{false}} @end example -@cindex @code{t} and truth +@cindex @code{t}, uses of @cindex true In contexts where a truth value is expected, any non-@code{nil} value is considered to be @var{true}. However, @code{t} is the preferred way @@ -209,14 +209,14 @@ choosing, use @code{t}. The symbol @code{t} always has the value In Emacs Lisp, @code{nil} and @code{t} are special symbols that always evaluate to themselves. This is so that you do not need to quote them to use them as constants in a program. An attempt to change their -values results in a @code{setting-constant} error. The same is true of -any symbol whose name starts with a colon (@samp{:}). @xref{Constant +values results in a @code{setting-constant} error. @xref{Constant Variables}. @node Evaluation Notation @subsection Evaluation Notation @cindex evaluation notation @cindex documentation notation +@cindex notation A Lisp expression that you can evaluate is called a @dfn{form}. Evaluating a form always produces a result, which is a Lisp object. In @@ -355,11 +355,11 @@ indicates that the subsequent arguments may be omitted (omitted arguments default to @code{nil}). Do not write @code{&optional} when you call the function. - The keyword @code{&rest} (which must be followed by a single argument -name) indicates that any number of arguments can follow. The single -following argument name will have a value, as a variable, which is a -list of all these remaining arguments. Do not write @code{&rest} when -you call the function. + The keyword @code{&rest} (which must be followed by a single +argument name) indicates that any number of arguments can follow. The +single argument name following @code{&rest} will receive, as its +value, a list of all the remaining arguments passed to the function. +Do not write @code{&rest} when you call the function. Here is a description of an imaginary function @code{foo}: @@ -450,9 +450,9 @@ from @var{body}, which includes all remaining elements of the form. @cindex variable descriptions @cindex option descriptions - A @dfn{variable} is a name that can hold a value. Although any -variable can be set by the user, certain variables that exist -specifically so that users can change them are called @dfn{user + A @dfn{variable} is a name that can hold a value. Although nearly +all variables can be set by the user, certain variables exist +specifically so that users can change them; these are called @dfn{user options}. Ordinary variables and user options are described using a format like that for functions except that there are no arguments. -- 2.39.2