]> code.delx.au - gnu-emacs/blobdiff - lisp/emacs-lisp/backquote.el
(eldoc-function-argstring-from-docstring): Add search that finds arglist
[gnu-emacs] / lisp / emacs-lisp / backquote.el
index 0bc4b95d9ec0802b840eed3cbb7d7982747956b5..807b4bd1c509f067e453237d6215f7d8369e6e95 100644 (file)
@@ -1,16 +1,16 @@
-;;; New backquote for GNU Emacs.
+;;; backquote.el --- implement the ` Lisp construct
+
 ;;; Copyright (C) 1990, 1992, 1994 Free Software Foundation, Inc.
 
 ;; Author: Rick Sladkey <jrs@world.std.com>
 ;; Maintainer: FSF
 ;; Keywords: extensions, internal
 
-;; This file is not part of GNU Emacs but is distributed under
-;; the same conditions as GNU Emacs.
+;; This file is part of GNU Emacs.
 
 ;; GNU Emacs is free software; you can redistribute it and/or modify
 ;; it under the terms of the GNU General Public License as published by
-;; the Free Software Foundation; either version 1, or (at your option)
+;; the Free Software Foundation; either version 2, or (at your option)
 ;; any later version.
 
 ;; GNU Emacs is distributed in the hope that it will be useful,
 ;; GNU General Public License for more details.
 
 ;; You should have received a copy of the GNU General Public License
-;; along with GNU Emacs; see the file COPYING.  If not, write to
-;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
-
-;; This is a new backquote for GNU Emacs written by
-;; Rick Sladkey <jrs@world.std.com>.  It has the following
-;; features compared to the version 18 backquote:
-
-;; Correctly handles nested backquotes.
-;; Correctly handles constants after a splice.
-;; Correctly handles top-level atoms and unquotes.
-;; Correctly handles unquote after dot.
-;; Understands vectors.
-;; Minimizes gratuitous consing.
-;; Faster operation with simpler semantics.
-;; Generates faster run-time expressions.
-;; One third fewer calories than our regular beer.
+;; along with GNU Emacs; see the file COPYING.  If not, write to the
+;; Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+;; Boston, MA 02111-1307, USA.
+
+;;; Commentary:
 
 ;; This backquote will generate calls to the backquote-list* form.
 ;; Both a function version and a macro version are included.
@@ -83,7 +72,7 @@ For example (backquote-list* 'a 'b 'c) => (a b . c)"
 ;; A few advertised variables that control which symbols are used
 ;; to represent the backquote, unquote, and splice operations.
 
-(defvar backquote-backquote-symbol '`
+(defvar backquote-backquote-symbol '\`
   "*Symbol used to represent a backquote or nested backquote (e.g. `).")
 
 (defvar backquote-unquote-symbol ',
@@ -101,10 +90,10 @@ places where expressions are evaluated and inserted or spliced in.
 
 For example:
 
-b                 => (ba bb bc)                ; assume b has this value
-\(` (a b c))       => (a b c)          ; backquote acts like quote
-\(` (a (, b) c))   => (a (ba bb bc) c) ; insert the value of b
-\(` (a (,@ b) c))  => (a ba bb bc c)   ; splice in the value of b
+b              => (ba bb bc)           ; assume b has this value
+`(a b c)       => (a b c)              ; backquote acts like quote
+`(a ,b c)      => (a (ba bb bc) c)     ; insert the value of b
+`(a ,@b c)     => (a ba bb bc c)       ; splice in the value of b
 
 Vectors work just like lists.  Nested backquotes are permitted."
   (cdr (backquote-process arg)))
@@ -112,7 +101,7 @@ Vectors work just like lists.  Nested backquotes are permitted."
 ;; GNU Emacs has no reader macros
 
 ;;;###autoload
-(defalias '` (symbol-function 'backquote))
+(defalias '\` (symbol-function 'backquote))
 
 ;; backquote-process returns a dotted-pair of a tag (0, 1, or 2) and
 ;; the backquote-processed structure.  0 => the structure is