;;; backquote.el --- implement the ` Lisp construct
-;;; Copyright (C) 1990, 1992, 1994 Free Software Foundation, Inc.
+;; Copyright (C) 1990, 1992, 1994, 2001, 2002, 2003, 2004,
+;; 2005, 2006 Free Software Foundation, Inc.
;; Author: Rick Sladkey <jrs@world.std.com>
;; Maintainer: FSF
;; 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, Inc., 59 Temple Place - Suite 330,
-;; Boston, MA 02111-1307, USA.
+;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+;; Boston, MA 02110-1301, USA.
;;; Commentary:
+;; When the Lisp reader sees `(...), it generates (\` (...)).
+;; When it sees ,... inside such a backquote form, it generates (\, ...).
+;; For ,@... it generates (\,@ ...).
+
;; This backquote will generate calls to the backquote-list* form.
;; Both a function version and a macro version are included.
;; The macro version is used by default because it is faster
"Like `list' but the last argument is the tail of the new list.
For example (backquote-list* 'a 'b 'c) => (a b . c)"
+ ;; The recursive solution is much nicer:
+ ;; (if list (cons first (apply 'backquote-list*-function list)) first))
+ ;; but Emacs is not very good at efficiently processing recursion.
(if list
(let* ((rest list) (newlist (cons first nil)) (last newlist))
(while (cdr rest)
"Like `list' but the last argument is the tail of the new list.
For example (backquote-list* 'a 'b 'c) => (a b . c)"
- (setq list (reverse (cons first list))
+ ;; The recursive solution is much nicer:
+ ;; (if list (list 'cons first (cons 'backquote-list*-macro list)) first))
+ ;; but Emacs is not very good at efficiently processing such things.
+ (setq list (nreverse (cons first list))
first (car list)
list (cdr list))
(if list
;; A few advertised variables that control which symbols are used
;; to represent the backquote, unquote, and splice operations.
(defconst backquote-backquote-symbol '\`
- "*Symbol used to represent a backquote or nested backquote.")
+ "Symbol used to represent a backquote or nested backquote.")
(defconst backquote-unquote-symbol ',
- "*Symbol used to represent an unquote inside a backquote.")
+ "Symbol used to represent an unquote inside a backquote.")
(defconst backquote-splice-symbol ',@
- "*Symbol used to represent a splice inside a backquote.")
+ "Symbol used to represent a splice inside a backquote.")
;;;###autoload
(defmacro backquote (arg)
;; Scan this list-level, setting LISTS to a list of forms,
;; each of which produces a list of elements
;; that should go in this level.
- ;; The order of LISTS is backwards.
+ ;; The order of LISTS is backwards.
;; If there are non-splicing elements (constant or variable)
;; at the beginning, put them in FIRSTLIST,
;; as a list of tagged values (TAG . FORM).
(if (or rest list)
(setq lists (cons (backquote-listify list (backquote-process rest))
lists)))
- ;; Turn LISTS into a form that produces the combined list.
+ ;; Turn LISTS into a form that produces the combined list.
(setq expression
(if (or (cdr lists)
(eq (car-safe (car lists)) backquote-splice-symbol))
tail))
(t (cons 'list heads)))))
-;; backquote.el ends here
+;;; arch-tag: 1a26206a-6b5e-4c56-8e24-2eef0f7e0e7a
+;;; backquote.el ends here