aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRichard M. Stallman1994-04-26 19:28:47 +0000
committerRichard M. Stallman1994-04-26 19:28:47 +0000
commit7791402edc21aed4f73894d1dbe2b2718a1cfb6f (patch)
treef3110a577ce45f13995b69a1a926e82c35415d9c
parentd0a54f0f3a7ac0ecca3893fd199e29f9d779697a (diff)
downloademacs-7791402edc21aed4f73894d1dbe2b2718a1cfb6f.tar.gz
emacs-7791402edc21aed4f73894d1dbe2b2718a1cfb6f.zip
entered into RCS
-rw-r--r--lispref/intro.texi45
1 files changed, 22 insertions, 23 deletions
diff --git a/lispref/intro.texi b/lispref/intro.texi
index 2a2b02f1ad9..f6fe12dfa88 100644
--- a/lispref/intro.texi
+++ b/lispref/intro.texi
@@ -401,7 +401,7 @@ consider it more useful to permit linking proprietary applications with the
401library. If this is what you want to do, use the GNU Library General 401library. If this is what you want to do, use the GNU Library General
402Public License instead of this License. 402Public License instead of this License.
403 403
404@node Introduction, Types of Lisp Object, Copying, Top 404@node Introduction, Lisp Data Types, Copying, Top
405@chapter Introduction 405@chapter Introduction
406 406
407 Most of the GNU Emacs text editor is written in the programming 407 Most of the GNU Emacs text editor is written in the programming
@@ -419,7 +419,7 @@ are functions that can also conveniently be called from Lisp programs,
419and parameters for customization are ordinary Lisp variables. 419and parameters for customization are ordinary Lisp variables.
420 420
421 This manual describes Emacs Lisp, presuming considerable familiarity 421 This manual describes Emacs Lisp, presuming considerable familiarity
422with the use of Emacs for editing. (See @cite{The GNU Emacs Manual}, 422with the use of Emacs for editing. (See @cite{The GNU Emacs Manual}
423for this basic information.) Generally speaking, the earlier chapters 423for this basic information.) Generally speaking, the earlier chapters
424describe features of Emacs Lisp that have counterparts in many 424describe features of Emacs Lisp that have counterparts in many
425programming languages, and later chapters describe features that are 425programming languages, and later chapters describe features that are
@@ -438,13 +438,11 @@ peculiar to Emacs Lisp or relate specifically to editing.
438@section Caveats 438@section Caveats
439 439
440 This manual has gone through numerous drafts. It is nearly complete 440 This manual has gone through numerous drafts. It is nearly complete
441but not flawless. There are a few sections which are not included, 441but not flawless. There are a few topics that are not covered, either
442either because we consider them secondary (such as most of the 442because we consider them secondary (such as most of the individual
443individual modes) or because they are yet to be written. 443modes) or because they are yet to be written. Because we are not able
444 444to deal with them completely, we have left out several parts
445 Because we are not able to deal with them completely, we have left out 445intentionally. This includes most information about usage on VMS.
446several parts intentionally. This includes most information about usage
447on VMS.
448 446
449 The manual should be fully correct in what it does cover, and it is 447 The manual should be fully correct in what it does cover, and it is
450therefore open to criticism on anything it says---from specific examples 448therefore open to criticism on anything it says---from specific examples
@@ -456,11 +454,12 @@ the manual should be fixed. Please let us know.
456@iftex 454@iftex
457 As you use the manual, we ask that you mark pages with corrections so 455 As you use the manual, we ask that you mark pages with corrections so
458you can later look them up and send them in. If you think of a simple, 456you can later look them up and send them in. If you think of a simple,
459real life example for a function or group of functions, please make an 457real-life example for a function or group of functions, please make an
460effort to write it up and send it in. Please reference any comments to 458effort to write it up and send it in. Please reference any comments to
461the chapter name, section name, and function name, as appropriate, since 459the chapter name, section name, and function name, as appropriate, since
462page numbers and chapter and section numbers will change. Also state 460page numbers and chapter and section numbers will change and we may have
463the number of the edition which you are criticizing. 461trouble finding the text you are talking about. Also state the number
462of the edition you are criticizing.
464@end iftex 463@end iftex
465@ifinfo 464@ifinfo
466 465
@@ -494,7 +493,7 @@ Emacs maintainers more quickly, send mail to
494@section Lisp History 493@section Lisp History
495@cindex Lisp history 494@cindex Lisp history
496 495
497 Lisp (LISt Processing language) was first developed in the late 1950s 496 Lisp (LISt Processing language) was first developed in the late 1950's
498at the Massachusetts Institute of Technology for research in artificial 497at the Massachusetts Institute of Technology for research in artificial
499intelligence. The great power of the Lisp language makes it superior 498intelligence. The great power of the Lisp language makes it superior
500for other purposes as well, such as writing editing commands. 499for other purposes as well, such as writing editing commands.
@@ -504,7 +503,7 @@ for other purposes as well, such as writing editing commands.
504 Dozens of Lisp implementations have been built over the years, each 503 Dozens of Lisp implementations have been built over the years, each
505with its own idiosyncrasies. Many of them were inspired by Maclisp, 504with its own idiosyncrasies. Many of them were inspired by Maclisp,
506which was written in the 1960's at MIT's Project MAC. Eventually the 505which was written in the 1960's at MIT's Project MAC. Eventually the
507implementors of the descendents of Maclisp came together and developed a 506implementors of the descendants of Maclisp came together and developed a
508standard for Lisp systems, called Common Lisp. 507standard for Lisp systems, called Common Lisp.
509 508
510 GNU Emacs Lisp is largely inspired by Maclisp, and a little by Common 509 GNU Emacs Lisp is largely inspired by Maclisp, and a little by Common
@@ -540,7 +539,7 @@ printer'' are used to refer to those routines in Lisp that convert
540textual representations of Lisp objects into actual objects, and vice 539textual representations of Lisp objects into actual objects, and vice
541versa. @xref{Printed Representation}, for more details. You, the 540versa. @xref{Printed Representation}, for more details. You, the
542person reading this manual, are thought of as ``the programmer'' and are 541person reading this manual, are thought of as ``the programmer'' and are
543addressed as ``you''. ``The user'' is the person who uses Lisp programs 542addressed as ``you''. ``The user'' is the person who uses Lisp programs,
544including those you write. 543including those you write.
545 544
546@cindex fonts 545@cindex fonts
@@ -619,7 +618,7 @@ evaluation of the expanded form.
619 @result{} c 618 @result{} c
620@end example 619@end example
621 620
622 Sometimes to help describe one form we show another form which 621 Sometimes to help describe one form we show another form that
623produces identical results. The exact equivalence of two forms is 622produces identical results. The exact equivalence of two forms is
624indicated with @samp{@equiv{}}. 623indicated with @samp{@equiv{}}.
625 624
@@ -632,12 +631,12 @@ indicated with @samp{@equiv{}}.
632@cindex printing notation 631@cindex printing notation
633 632
634 Many of the examples in this manual print text when they are 633 Many of the examples in this manual print text when they are
635evaluated. If you execute the code from an example in a Lisp 634evaluated. If you execute example code in a Lisp Interaction buffer
636Interaction buffer (such as the buffer @samp{*scratch*}), the printed 635(such as the buffer @samp{*scratch*}), the printed text is inserted into
637text is inserted into the buffer. If you execute the example by other 636the buffer. If you execute the example by other means (such as by
638means (such as by evaluating the function @code{eval-region}), it prints 637evaluating the function @code{eval-region}), the printed text is
639text by displaying it in the echo area. You should be aware that text 638displayed in the echo area. You should be aware that text displayed in
640displayed in the echo area is truncated to a single line. 639the echo area is truncated to a single line.
641 640
642 Examples in this manual indicate printed text with @samp{@print{}}, 641 Examples in this manual indicate printed text with @samp{@print{}},
643irrespective of where that text goes. The value returned by evaluating 642irrespective of where that text goes. The value returned by evaluating
@@ -765,7 +764,7 @@ More generally,
765@var{integer}, @var{integer1} or @var{buffer}) is expected to be of that 764@var{integer}, @var{integer1} or @var{buffer}) is expected to be of that
766type. A plural of a type (such as @var{buffers}) often means a list of 765type. A plural of a type (such as @var{buffers}) often means a list of
767objects of that type. Parameters named @var{object} may be of any type. 766objects of that type. Parameters named @var{object} may be of any type.
768(@xref{Types of Lisp Object}, for a list of Emacs object types.) 767(@xref{Lisp Data Types}, for a list of Emacs object types.)
769Parameters with other sorts of names (e.g., @var{new-file}) are 768Parameters with other sorts of names (e.g., @var{new-file}) are
770discussed specifically in the description of the function. In some 769discussed specifically in the description of the function. In some
771sections, features common to parameters of several functions are 770sections, features common to parameters of several functions are