summaryrefslogtreecommitdiff
path: root/lang/elisp-manual/DESCR
diff options
context:
space:
mode:
Diffstat (limited to 'lang/elisp-manual/DESCR')
-rw-r--r--lang/elisp-manual/DESCR27
1 files changed, 27 insertions, 0 deletions
diff --git a/lang/elisp-manual/DESCR b/lang/elisp-manual/DESCR
new file mode 100644
index 00000000000..03bb4839b25
--- /dev/null
+++ b/lang/elisp-manual/DESCR
@@ -0,0 +1,27 @@
+ Most of the GNU Emacs text editor is written in the programming
+language called Emacs Lisp. You can write new code in Emacs Lisp and
+install it as an extension to the editor. However, Emacs Lisp is more
+than a mere ``extension language''; it is a full computer programming
+language in its own right. You can use it as you would any other
+programming language.
+
+ Because Emacs Lisp is designed for use in an editor, it has special
+features for scanning and parsing text as well as features for handling
+files, buffers, displays, subprocesses, and so on. Emacs Lisp is
+closely integrated with the editing facilities; thus, editing commands
+are functions that can also conveniently be called from Lisp programs,
+and parameters for customization are ordinary Lisp variables.
+
+ This manual attempts to be a full description of Emacs Lisp. For a
+beginner's introduction to Emacs Lisp, see ``An Introduction to
+Emacs Lisp Programming,'' by Bob Chassell, also published by the Free
+Software Foundation. This manual presumes considerable familiarity with
+the use of Emacs for editing; see ``The GNU Emacs Manual'' for this
+basic information.
+
+ Generally speaking, the earlier chapters describe features of Emacs
+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.5.