annotate man/lispref/back.texi @ 5070:b0f4adffca7d

fix so that CL docstrings (with &key, etc.) handled properly -------------------- ChangeLog entries follow: -------------------- lisp/ChangeLog addition: 2010-02-23 Ben Wing <ben@xemacs.org> * autoload.el: * autoload.el (make-autoload): * cl-macs.el (cl-function-arglist): * cl-macs.el (cl-transform-lambda): Don't add argument list with the tag "Common Lisp lambda list:"; instead add in "standard" form using "arguments:" and omitting the function name. Add an arg to `cl-function-arglist' to omit the name and use it in autoload.el instead of just hacking it off. * help.el: * help.el (function-arglist): * help.el (function-documentation-1): New. Extract out common code to recognize and/or strip the arglist from documentation into `function-documentation-1'. Use in `function-arglist' and `function-documentation'. Modify `function-arglist' so it looks for the `arguments: ' stuff in all doc strings, not just subrs/autoloads, so that CL functions get recognized properly. Change the regexp used to match "arguments: " specs to allow nested parens inside the arg list (happens when you have a default value specified in a CL arglist).
author Ben Wing <ben@xemacs.org>
date Tue, 23 Feb 2010 01:12:13 -0600
parents 3ecd8885ac67
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
428
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
1 \input /home/gd/gnu/doc/texinfo.tex @c -*-texinfo-*-
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
2 @c %**start of header
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
3 @setfilename ../../info/back-cover
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
4 @settitle XEmacs Lisp Reference Manual
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
5 @c %**end of header
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
6 .
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
7 @sp 7
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
8 @center @titlefont {XEmacs Lisp}
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
9 @sp 1
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
10
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
11 @quotation
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
12 Most of the XEmacs text editor is written in the programming
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
13 language called XEmacs Lisp. You can write new code in XEmacs Lisp and
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
14 install it as an extension to the editor. However, XEmacs Lisp is more
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
15 than a mere ``extension language''; it is a full computer programming
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
16 language in its own right. You can use it as you would any other
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
17 programming language.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
18
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
19 Because XEmacs Lisp is designed for use in an editor, it has special
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
20 features for scanning and parsing text as well as features for handling
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
21 files, buffers, displays, subprocesses, and so on. XEmacs Lisp is
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
22 closely integrated with the editing facilities; thus, editing commands
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
23 are functions that can also conveniently be called from Lisp programs,
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
24 and parameters for customization are ordinary Lisp variables.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
25
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
26 This manual describes XEmacs Lisp. Generally speaking, the earlier
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
27 chapters describe features of XEmacs Lisp that have counterparts in
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
28 many programming languages, and later chapters describe features that
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
29 are peculiar to XEmacs Lisp or relate specifically to editing.
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
30 @end quotation
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
31
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
32 @hfil
3ecd8885ac67 Import from CVS: tag r21-2-22
cvs
parents:
diff changeset
33 @bye