X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/e4a29e5aeda798070d777a944228e84969e93335..4a182c75ed86d8eea2d47feb4dc738449cf7bb99:/lispref/intro.texi diff --git a/lispref/intro.texi b/lispref/intro.texi index fd383d3a64..bb264c81c4 100644 --- a/lispref/intro.texi +++ b/lispref/intro.texi @@ -1,6 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990, 1991, 1992, 1993, 1994 Free Software Foundation, Inc. +@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 2002 +@c Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/intro @@ -34,7 +35,8 @@ Lisp that have counterparts in many programming languages, and later chapters describe features that are peculiar to Emacs Lisp or relate specifically to editing. - This is edition 2.6. + This is edition @value{VERSION} of the GNU Emacs Lisp Reference +Manual, corresponding to Emacs version @value{EMACSVER}. @menu * Caveats:: Flaws and a request for help. @@ -46,6 +48,7 @@ specifically to editing. @node Caveats @section Caveats +@cindex bugs in this manual This manual has gone through numerous drafts. It is nearly complete but not flawless. There are a few topics that are not covered, either @@ -81,6 +84,8 @@ variable name, as appropriate. Also state the number of the edition you are criticizing. @end ifnottex +@cindex bugs +@cindex suggestions Please mail comments and corrections to @example @@ -125,8 +130,7 @@ worry about it; this manual is self-contained. @pindex cl A certain amount of Common Lisp emulation is available via the -@file{cl} library. @xref{Top,, Common Lisp Extension, cl, Common Lisp -Extensions}. +@file{cl} library. @inforef{Top, Overview, cl}. Emacs Lisp is not at all influenced by Scheme; but the GNU project has an implementation of Scheme, called Guile. We use Guile in all new GNU @@ -257,12 +261,13 @@ evaluating the function @code{eval-region}), the printed text is displayed in the echo area. Examples in this manual indicate printed text with @samp{@print{}}, -irrespective of where that text goes. The value returned by evaluating -the form (here @code{bar}) follows on a separate line. +irrespective of where that text goes. The value returned by +evaluating the form (here @code{bar}) follows on a separate line with +@samp{@result{}}. @example @group -(progn (print 'foo) (print 'bar)) +(progn (prin1 'foo) (princ "\n") (prin1 'bar)) @print{} foo @print{} bar @result{} bar @@ -330,7 +335,7 @@ The description follows on succeeding lines, sometimes with examples. function, @code{foo}. * A Sample Variable Description:: A description of an imaginary variable, - @code{electric-future-map}. + @code{electric-future-map}. @end menu @node A Sample Function Description @@ -469,7 +474,7 @@ replaced by `User Option'. These facilities provide information about which version of Emacs is in use. -@deffn Command emacs-version +@deffn Command emacs-version &optional here This function returns a string describing the version of Emacs that is running. It is useful to include this string in bug reports. @@ -481,8 +486,10 @@ running. It is useful to include this string in bug reports. @end group @end smallexample -Called interactively, the function prints the same information in the -echo area. +If @var{here} is non-@code{nil}, it inserts the text in the buffer +before point, and returns @code{nil}. Called interactively, the +function prints the same information in the echo area, but giving a +prefix argument makes @var{here} non-@code{nil}. @end deffn @defvar emacs-build-time @@ -502,7 +509,7 @@ emacs-build-time The value of this variable is the version of Emacs being run. It is a string such as @code{"20.3.1"}. The last number in this string is not really part of the Emacs release version number; it is incremented each -time you build Emacs in any given directory. A value with three numeric +time you build Emacs in any given directory. A value with four numeric components, such as @code{"20.3.9.1"}, indicates an unreleased test version. @end defvar @@ -541,3 +548,7 @@ Francesco Potorti, Friedrich Pukelsheim, Arnold D. Robbins, Raul Rockwell, Per Starb@"ack, Shinichirou Sugou, Kimmo Suominen, Edward Tharp, Bill Trost, Rickard Westman, Jean White, Matthew Wilding, Carl Witty, Dale Worley, Rusty Wright, and David D. Zuhn. + +@ignore + arch-tag: d156593f-82f8-4708-a844-204e48f7f2aa +@end ignore