2001-07-15 16:15:35 +00:00
|
|
|
|
;;; bytecomp.el --- compilation of Lisp code into byte code
|
1992-07-19 01:07:07 +00:00
|
|
|
|
|
2004-11-11 22:44:46 +00:00
|
|
|
|
;; Copyright (C) 1985, 1986, 1987, 1992, 1994, 1998, 2000, 2001, 2002,
|
2009-01-05 03:18:22 +00:00
|
|
|
|
;; 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
|
1992-07-22 04:22:42 +00:00
|
|
|
|
|
1992-07-19 01:07:07 +00:00
|
|
|
|
;; Author: Jamie Zawinski <jwz@lucid.com>
|
|
|
|
|
;; Hallvard Furuseth <hbf@ulrik.uio.no>
|
1998-02-02 01:21:18 +00:00
|
|
|
|
;; Maintainer: FSF
|
1998-01-26 10:28:01 +00:00
|
|
|
|
;; Keywords: lisp
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;; This file is part of GNU Emacs.
|
|
|
|
|
|
2008-05-06 03:21:21 +00:00
|
|
|
|
;; GNU Emacs is free software: you can redistribute it and/or modify
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; it under the terms of the GNU General Public License as published by
|
2008-05-06 03:21:21 +00:00
|
|
|
|
;; the Free Software Foundation, either version 3 of the License, or
|
|
|
|
|
;; (at your option) any later version.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;; GNU Emacs is distributed in the hope that it will be useful,
|
|
|
|
|
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
;; GNU General Public License for more details.
|
|
|
|
|
|
|
|
|
|
;; You should have received a copy of the GNU General Public License
|
2008-05-06 03:21:21 +00:00
|
|
|
|
;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
1993-03-22 03:27:18 +00:00
|
|
|
|
;;; Commentary:
|
|
|
|
|
|
|
|
|
|
;; The Emacs Lisp byte compiler. This crunches lisp source into a sort
|
2000-03-24 18:37:48 +00:00
|
|
|
|
;; of p-code (`lapcode') which takes up less space and can be interpreted
|
|
|
|
|
;; faster. [`LAP' == `Lisp Assembly Program'.]
|
1993-03-22 03:27:18 +00:00
|
|
|
|
;; The user entry points are byte-compile-file and byte-recompile-directory.
|
|
|
|
|
|
1992-07-19 01:07:07 +00:00
|
|
|
|
;;; Code:
|
|
|
|
|
|
1996-01-14 07:34:30 +00:00
|
|
|
|
;; ========================================================================
|
|
|
|
|
;; Entry points:
|
|
|
|
|
;; byte-recompile-directory, byte-compile-file,
|
|
|
|
|
;; batch-byte-compile, batch-byte-recompile-directory,
|
|
|
|
|
;; byte-compile, compile-defun,
|
|
|
|
|
;; display-call-tree
|
|
|
|
|
;; (byte-compile-buffer and byte-compile-and-load-file were turned off
|
|
|
|
|
;; because they are not terribly useful and get in the way of completion.)
|
|
|
|
|
|
|
|
|
|
;; This version of the byte compiler has the following improvements:
|
|
|
|
|
;; + optimization of compiled code:
|
|
|
|
|
;; - removal of unreachable code;
|
|
|
|
|
;; - removal of calls to side-effectless functions whose return-value
|
|
|
|
|
;; is unused;
|
|
|
|
|
;; - compile-time evaluation of safe constant forms, such as (consp nil)
|
|
|
|
|
;; and (ash 1 6);
|
|
|
|
|
;; - open-coding of literal lambdas;
|
|
|
|
|
;; - peephole optimization of emitted code;
|
|
|
|
|
;; - trivial functions are left uncompiled for speed.
|
|
|
|
|
;; + support for inline functions;
|
|
|
|
|
;; + compile-time evaluation of arbitrary expressions;
|
|
|
|
|
;; + compile-time warning messages for:
|
|
|
|
|
;; - functions being redefined with incompatible arglists;
|
|
|
|
|
;; - functions being redefined as macros, or vice-versa;
|
|
|
|
|
;; - functions or macros defined multiple times in the same file;
|
|
|
|
|
;; - functions being called with the incorrect number of arguments;
|
2000-03-29 21:32:57 +00:00
|
|
|
|
;; - functions being called which are not defined globally, in the
|
1996-01-14 07:34:30 +00:00
|
|
|
|
;; file, or as autoloads;
|
|
|
|
|
;; - assignment and reference of undeclared free variables;
|
|
|
|
|
;; - various syntax errors;
|
|
|
|
|
;; + correct compilation of nested defuns, defmacros, defvars and defsubsts;
|
|
|
|
|
;; + correct compilation of top-level uses of macros;
|
|
|
|
|
;; + the ability to generate a histogram of functions called.
|
|
|
|
|
|
|
|
|
|
;; User customization variables:
|
|
|
|
|
;;
|
|
|
|
|
;; byte-compile-verbose Whether to report the function currently being
|
2004-04-16 12:51:06 +00:00
|
|
|
|
;; compiled in the echo area;
|
2000-03-29 21:32:57 +00:00
|
|
|
|
;; byte-optimize Whether to do optimizations; this may be
|
1996-01-14 07:34:30 +00:00
|
|
|
|
;; t, nil, 'source, or 'byte;
|
2000-03-29 21:32:57 +00:00
|
|
|
|
;; byte-optimize-log Whether to report (in excruciating detail)
|
1996-01-14 07:34:30 +00:00
|
|
|
|
;; exactly which optimizations have been made.
|
|
|
|
|
;; This may be t, nil, 'source, or 'byte;
|
|
|
|
|
;; byte-compile-error-on-warn Whether to stop compilation when a warning is
|
|
|
|
|
;; produced;
|
|
|
|
|
;; byte-compile-delete-errors Whether the optimizer may delete calls or
|
|
|
|
|
;; variable references that are side-effect-free
|
|
|
|
|
;; except that they may return an error.
|
|
|
|
|
;; byte-compile-generate-call-tree Whether to generate a histogram of
|
2000-03-29 21:32:57 +00:00
|
|
|
|
;; function calls. This can be useful for
|
1996-01-14 07:34:30 +00:00
|
|
|
|
;; finding unused functions, as well as simple
|
|
|
|
|
;; performance metering.
|
|
|
|
|
;; byte-compile-warnings List of warnings to issue, or t. May contain
|
2003-02-17 07:54:27 +00:00
|
|
|
|
;; `free-vars' (references to variables not in the
|
|
|
|
|
;; current lexical scope)
|
|
|
|
|
;; `unresolved' (calls to unknown functions)
|
|
|
|
|
;; `callargs' (lambda calls with args that don't
|
|
|
|
|
;; match the lambda's definition)
|
|
|
|
|
;; `redefine' (function cell redefined from
|
|
|
|
|
;; a macro to a lambda or vice versa,
|
|
|
|
|
;; or redefined to take other args)
|
|
|
|
|
;; `obsolete' (obsolete variables and functions)
|
|
|
|
|
;; `noruntime' (calls to functions only defined
|
|
|
|
|
;; within `eval-when-compile')
|
2007-06-10 16:15:10 +00:00
|
|
|
|
;; `cl-functions' (calls to CL functions)
|
2004-11-02 09:22:16 +00:00
|
|
|
|
;; `interactive-only' (calls to commands that are
|
|
|
|
|
;; not good to call from Lisp)
|
2007-06-07 07:00:00 +00:00
|
|
|
|
;; `make-local' (dubious calls to
|
|
|
|
|
;; `make-variable-buffer-local')
|
2007-09-21 07:13:28 +00:00
|
|
|
|
;; `mapcar' (mapcar called for effect)
|
1996-01-14 07:34:30 +00:00
|
|
|
|
;; byte-compile-compatibility Whether the compiler should
|
|
|
|
|
;; generate .elc files which can be loaded into
|
|
|
|
|
;; generic emacs 18.
|
|
|
|
|
;; emacs-lisp-file-regexp Regexp for the extension of source-files;
|
|
|
|
|
;; see also the function byte-compile-dest-file.
|
|
|
|
|
|
|
|
|
|
;; New Features:
|
|
|
|
|
;;
|
|
|
|
|
;; o The form `defsubst' is just like `defun', except that the function
|
|
|
|
|
;; generated will be open-coded in compiled code which uses it. This
|
|
|
|
|
;; means that no function call will be generated, it will simply be
|
|
|
|
|
;; spliced in. Lisp functions calls are very slow, so this can be a
|
|
|
|
|
;; big win.
|
|
|
|
|
;;
|
|
|
|
|
;; You can generally accomplish the same thing with `defmacro', but in
|
|
|
|
|
;; that case, the defined procedure can't be used as an argument to
|
|
|
|
|
;; mapcar, etc.
|
|
|
|
|
;;
|
|
|
|
|
;; o You can also open-code one particular call to a function without
|
|
|
|
|
;; open-coding all calls. Use the 'inline' form to do this, like so:
|
|
|
|
|
;;
|
|
|
|
|
;; (inline (foo 1 2 3)) ;; `foo' will be open-coded
|
|
|
|
|
;; or...
|
2000-03-29 21:32:57 +00:00
|
|
|
|
;; (inline ;; `foo' and `baz' will be
|
1996-01-14 07:34:30 +00:00
|
|
|
|
;; (foo 1 2 3 (bar 5)) ;; open-coded, but `bar' will not.
|
|
|
|
|
;; (baz 0))
|
|
|
|
|
;;
|
|
|
|
|
;; o It is possible to open-code a function in the same file it is defined
|
2004-04-16 12:51:06 +00:00
|
|
|
|
;; in without having to load that file before compiling it. The
|
1996-01-14 07:34:30 +00:00
|
|
|
|
;; byte-compiler has been modified to remember function definitions in
|
|
|
|
|
;; the compilation environment in the same way that it remembers macro
|
|
|
|
|
;; definitions.
|
|
|
|
|
;;
|
|
|
|
|
;; o Forms like ((lambda ...) ...) are open-coded.
|
|
|
|
|
;;
|
|
|
|
|
;; o The form `eval-when-compile' is like progn, except that the body
|
|
|
|
|
;; is evaluated at compile-time. When it appears at top-level, this
|
|
|
|
|
;; is analogous to the Common Lisp idiom (eval-when (compile) ...).
|
|
|
|
|
;; When it does not appear at top-level, it is similar to the
|
|
|
|
|
;; Common Lisp #. reader macro (but not in interpreted code).
|
|
|
|
|
;;
|
|
|
|
|
;; o The form `eval-and-compile' is similar to eval-when-compile, but
|
|
|
|
|
;; the whole form is evalled both at compile-time and at run-time.
|
|
|
|
|
;;
|
|
|
|
|
;; o The command compile-defun is analogous to eval-defun.
|
|
|
|
|
;;
|
2000-03-29 21:32:57 +00:00
|
|
|
|
;; o If you run byte-compile-file on a filename which is visited in a
|
1996-01-14 07:34:30 +00:00
|
|
|
|
;; buffer, and that buffer is modified, you are asked whether you want
|
|
|
|
|
;; to save the buffer before compiling.
|
|
|
|
|
;;
|
|
|
|
|
;; o byte-compiled files now start with the string `;ELC'.
|
|
|
|
|
;; Some versions of `file' can be customized to recognize that.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
1992-11-16 01:21:50 +00:00
|
|
|
|
(require 'backquote)
|
2009-08-28 17:02:53 +00:00
|
|
|
|
(eval-when-compile (require 'cl))
|
1992-11-16 01:21:50 +00:00
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(or (fboundp 'defsubst)
|
|
|
|
|
;; This really ought to be loaded already!
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(load "byte-run"))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2001-10-05 09:29:51 +00:00
|
|
|
|
;; The feature of compiling in a specific target Emacs version
|
|
|
|
|
;; has been turned off because compile time options are a bad idea.
|
1992-07-15 20:26:37 +00:00
|
|
|
|
(defmacro byte-compile-single-version () nil)
|
|
|
|
|
(defmacro byte-compile-version-cond (cond) cond)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2001-10-05 09:29:51 +00:00
|
|
|
|
;; The crud you see scattered through this file of the form
|
|
|
|
|
;; (or (and (boundp 'epoch::version) epoch::version)
|
|
|
|
|
;; (string-lessp emacs-version "19"))
|
|
|
|
|
;; is because the Epoch folks couldn't be bothered to follow the
|
|
|
|
|
;; normal emacs version numbering convention.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; (if (byte-compile-version-cond
|
|
|
|
|
;; (or (and (boundp 'epoch::version) epoch::version)
|
|
|
|
|
;; (string-lessp emacs-version "19")))
|
|
|
|
|
;; (progn
|
|
|
|
|
;; ;; emacs-18 compatibility.
|
|
|
|
|
;; (defvar baud-rate (baud-rate)) ;Define baud-rate if it's undefined
|
2001-10-18 21:05:16 +00:00
|
|
|
|
;;
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; (if (byte-compile-single-version)
|
* disass.el (disassemble): Add autoload cookie for this.
* bytecomp.el (byte-decompile-bytecode): Add an autoload for this.
compiled-function-p has been renamed to byte-code-function-p.
* subr.el: Define compiled-function-p as an alias for it.
* bytecomp.el: Register compiled-function-p as obsolete.
* bytecomp.el, byte-opt.el, disass.el, help.el, map-ynp.el: Change
uses.
unread-command-event has been replaced by unread-command-events.
* simple.el (prefix-arg-internal): Use this to push back all
key sequences for processing by the main command loop, instead of
trying to simulate its behavior ourselves.
* bytecomp.el: Document unread-command-event as an obsolete
variable, although nothing but the GNU Emacs 19 sources use it.
Adjust obsolescence message for unread-command-char.
* comint.el (comint-dynamic-list-completions): Change uses of
unread-command-event to work with unread-command-events.
* ebuff-menu.el (electric-buffer-list, Electric-buffer-menu-exit):
Same.
* edebug.el (edebug-outside-excursion): Same.
* ehelp.el (electric-help-command-loop): Same.
* electric.el (Electric-command-loop): Same.
* emerge.el (emerge-show-file-name): Same.
* fortran.el (fortran-abbrev-start,
fortran-window-create-momentarily): Same.
* gnus.el (gnus-Subject-next-article): Same.
* info.el (Info-summary): Same.
* isearch-mode.el (isearch-update, isearch-unread): Same.
* map-ynp.el (map-y-or-n-p): Same.
* mlsupport.el (push-back-character): Same.
* replace.el (perform-replace): Same.
* simula.el (simula-electric-label): Same.
* subr.el (read-quoted-char, momentary-string-display): Same.
* sun-mouse.el (mouse-second-hit): Same.
* terminal.el (te-escape-extended-command-unread): Same.
* vip.el (vip-escape-to-emacs, vip-prefix-arg-value,
vip-prefix-arg-com): Same.
1993-01-26 01:36:02 +00:00
|
|
|
|
;; (defmacro byte-code-function-p (x) "Emacs 18 doesn't have these." nil)
|
|
|
|
|
;; (defun byte-code-function-p (x) "Emacs 18 doesn't have these." nil))
|
2001-10-18 21:05:16 +00:00
|
|
|
|
;;
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; (or (and (fboundp 'member)
|
|
|
|
|
;; ;; avoid using someone else's possibly bogus definition of this.
|
|
|
|
|
;; (subrp (symbol-function 'member)))
|
|
|
|
|
;; (defun member (elt list)
|
|
|
|
|
;; "like memq, but uses equal instead of eq. In v19, this is a subr."
|
|
|
|
|
;; (while (and list (not (equal elt (car list))))
|
|
|
|
|
;; (setq list (cdr list)))
|
|
|
|
|
;; list))))
|
|
|
|
|
|
|
|
|
|
|
1998-01-26 10:28:01 +00:00
|
|
|
|
(defgroup bytecomp nil
|
2005-07-04 02:41:08 +00:00
|
|
|
|
"Emacs Lisp byte-compiler."
|
1998-01-26 10:28:01 +00:00
|
|
|
|
:group 'lisp)
|
|
|
|
|
|
2009-02-02 03:27:30 +00:00
|
|
|
|
(defcustom emacs-lisp-file-regexp "\\.el\\'"
|
2008-11-20 12:13:49 +00:00
|
|
|
|
"Regexp which matches Emacs Lisp source files.
|
1998-01-26 10:28:01 +00:00
|
|
|
|
You may want to redefine the function `byte-compile-dest-file'
|
|
|
|
|
if you change this variable."
|
|
|
|
|
:group 'bytecomp
|
|
|
|
|
:type 'regexp)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
1995-08-22 18:52:47 +00:00
|
|
|
|
;; This enables file name handlers such as jka-compr
|
|
|
|
|
;; to remove parts of the file name that should not be copied
|
|
|
|
|
;; through to the output file name.
|
|
|
|
|
(defun byte-compiler-base-file-name (filename)
|
|
|
|
|
(let ((handler (find-file-name-handler filename
|
|
|
|
|
'byte-compiler-base-file-name)))
|
|
|
|
|
(if handler
|
|
|
|
|
(funcall handler 'byte-compiler-base-file-name filename)
|
|
|
|
|
filename)))
|
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(or (fboundp 'byte-compile-dest-file)
|
1993-06-11 16:19:49 +00:00
|
|
|
|
;; The user may want to redefine this along with emacs-lisp-file-regexp,
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; so only define it if it is undefined.
|
|
|
|
|
(defun byte-compile-dest-file (filename)
|
2007-02-13 12:07:26 +00:00
|
|
|
|
"Convert an Emacs Lisp source file name to a compiled file name.
|
|
|
|
|
If FILENAME matches `emacs-lisp-file-regexp' (by default, files
|
|
|
|
|
with the extension `.el'), add `c' to it; otherwise add `.elc'."
|
1995-08-22 18:52:47 +00:00
|
|
|
|
(setq filename (byte-compiler-base-file-name filename))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(setq filename (file-name-sans-versions filename))
|
2008-07-31 05:33:56 +00:00
|
|
|
|
(cond ((string-match emacs-lisp-file-regexp filename)
|
1998-08-18 07:02:59 +00:00
|
|
|
|
(concat (substring filename 0 (match-beginning 0)) ".elc"))
|
|
|
|
|
(t (concat filename ".elc")))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;; This can be the 'byte-compile property of any symbol.
|
1992-07-15 20:26:37 +00:00
|
|
|
|
(autoload 'byte-compile-inline-expand "byte-opt")
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;; This is the entrypoint to the lapcode optimizer pass1.
|
1992-07-15 20:26:37 +00:00
|
|
|
|
(autoload 'byte-optimize-form "byte-opt")
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; This is the entrypoint to the lapcode optimizer pass2.
|
1992-07-15 20:26:37 +00:00
|
|
|
|
(autoload 'byte-optimize-lapcode "byte-opt")
|
|
|
|
|
(autoload 'byte-compile-unfold-lambda "byte-opt")
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
* disass.el (disassemble): Add autoload cookie for this.
* bytecomp.el (byte-decompile-bytecode): Add an autoload for this.
compiled-function-p has been renamed to byte-code-function-p.
* subr.el: Define compiled-function-p as an alias for it.
* bytecomp.el: Register compiled-function-p as obsolete.
* bytecomp.el, byte-opt.el, disass.el, help.el, map-ynp.el: Change
uses.
unread-command-event has been replaced by unread-command-events.
* simple.el (prefix-arg-internal): Use this to push back all
key sequences for processing by the main command loop, instead of
trying to simulate its behavior ourselves.
* bytecomp.el: Document unread-command-event as an obsolete
variable, although nothing but the GNU Emacs 19 sources use it.
Adjust obsolescence message for unread-command-char.
* comint.el (comint-dynamic-list-completions): Change uses of
unread-command-event to work with unread-command-events.
* ebuff-menu.el (electric-buffer-list, Electric-buffer-menu-exit):
Same.
* edebug.el (edebug-outside-excursion): Same.
* ehelp.el (electric-help-command-loop): Same.
* electric.el (Electric-command-loop): Same.
* emerge.el (emerge-show-file-name): Same.
* fortran.el (fortran-abbrev-start,
fortran-window-create-momentarily): Same.
* gnus.el (gnus-Subject-next-article): Same.
* info.el (Info-summary): Same.
* isearch-mode.el (isearch-update, isearch-unread): Same.
* map-ynp.el (map-y-or-n-p): Same.
* mlsupport.el (push-back-character): Same.
* replace.el (perform-replace): Same.
* simula.el (simula-electric-label): Same.
* subr.el (read-quoted-char, momentary-string-display): Same.
* sun-mouse.el (mouse-second-hit): Same.
* terminal.el (te-escape-extended-command-unread): Same.
* vip.el (vip-escape-to-emacs, vip-prefix-arg-value,
vip-prefix-arg-com): Same.
1993-01-26 01:36:02 +00:00
|
|
|
|
;; This is the entry point to the decompiler, which is used by the
|
|
|
|
|
;; disassembler. The disassembler just requires 'byte-compile, but
|
|
|
|
|
;; that doesn't define this function, so this seems to be a reasonable
|
|
|
|
|
;; thing to do.
|
|
|
|
|
(autoload 'byte-decompile-bytecode "byte-opt")
|
|
|
|
|
|
1998-01-26 10:28:01 +00:00
|
|
|
|
(defcustom byte-compile-verbose
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(and (not noninteractive) (> baud-rate search-slow-speed))
|
2008-11-20 12:13:49 +00:00
|
|
|
|
"Non-nil means print messages describing progress of byte-compiler."
|
1998-01-26 10:28:01 +00:00
|
|
|
|
:group 'bytecomp
|
|
|
|
|
:type 'boolean)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
1998-01-26 10:28:01 +00:00
|
|
|
|
(defcustom byte-compile-compatibility nil
|
2008-11-20 12:13:49 +00:00
|
|
|
|
"Non-nil means generate output that can run in Emacs 18.
|
2004-04-16 12:51:06 +00:00
|
|
|
|
This only means that it can run in principle, if it doesn't require
|
|
|
|
|
facilities that have been added more recently."
|
1998-01-26 10:28:01 +00:00
|
|
|
|
:group 'bytecomp
|
|
|
|
|
:type 'boolean)
|
1992-07-15 20:26:37 +00:00
|
|
|
|
|
|
|
|
|
;; (defvar byte-compile-generate-emacs19-bytecodes
|
|
|
|
|
;; (not (or (and (boundp 'epoch::version) epoch::version)
|
|
|
|
|
;; (string-lessp emacs-version "19")))
|
2000-03-29 21:32:57 +00:00
|
|
|
|
;; "*If this is true, then the byte-compiler will generate bytecode which
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; makes use of byte-ops which are present only in Emacs 19. Code generated
|
|
|
|
|
;; this way can never be run in Emacs 18, and may even cause it to crash.")
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
1998-01-26 10:28:01 +00:00
|
|
|
|
(defcustom byte-optimize t
|
2008-11-20 12:13:49 +00:00
|
|
|
|
"Enable optimization in the byte compiler.
|
2006-11-30 16:26:37 +00:00
|
|
|
|
Possible values are:
|
|
|
|
|
nil - no optimization
|
|
|
|
|
t - all optimizations
|
|
|
|
|
`source' - source-level optimizations only
|
|
|
|
|
`byte' - code-level optimizations only"
|
1998-01-26 10:28:01 +00:00
|
|
|
|
:group 'bytecomp
|
|
|
|
|
:type '(choice (const :tag "none" nil)
|
|
|
|
|
(const :tag "all" t)
|
|
|
|
|
(const :tag "source-level" source)
|
|
|
|
|
(const :tag "byte-level" byte)))
|
|
|
|
|
|
2002-09-09 00:28:38 +00:00
|
|
|
|
(defcustom byte-compile-delete-errors nil
|
2008-11-20 12:13:49 +00:00
|
|
|
|
"If non-nil, the optimizer may delete forms that may signal an error.
|
1998-01-26 10:28:01 +00:00
|
|
|
|
This includes variable references and calls to functions such as `car'."
|
|
|
|
|
:group 'bytecomp
|
|
|
|
|
:type 'boolean)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
1994-12-24 05:58:05 +00:00
|
|
|
|
(defvar byte-compile-dynamic nil
|
1998-01-26 10:28:01 +00:00
|
|
|
|
"If non-nil, compile function bodies so they load lazily.
|
1998-09-28 13:32:44 +00:00
|
|
|
|
They are hidden in comments in the compiled file,
|
|
|
|
|
and each one is brought into core when the
|
1994-12-24 05:58:05 +00:00
|
|
|
|
function is called.
|
|
|
|
|
|
|
|
|
|
To enable this option, make it a file-local variable
|
|
|
|
|
in the source file you want it to apply to.
|
|
|
|
|
For example, add -*-byte-compile-dynamic: t;-*- on the first line.
|
|
|
|
|
|
|
|
|
|
When this option is true, if you load the compiled file and then move it,
|
|
|
|
|
the functions you loaded will not be able to run.")
|
2006-05-11 15:01:41 +00:00
|
|
|
|
;;;###autoload(put 'byte-compile-dynamic 'safe-local-variable 'booleanp)
|
1994-12-24 05:58:05 +00:00
|
|
|
|
|
2007-01-29 01:22:53 +00:00
|
|
|
|
(defvar byte-compile-disable-print-circle nil
|
|
|
|
|
"If non-nil, disable `print-circle' on printing a byte-compiled code.")
|
|
|
|
|
;;;###autoload(put 'byte-compile-disable-print-circle 'safe-local-variable 'booleanp)
|
|
|
|
|
|
1998-01-26 10:28:01 +00:00
|
|
|
|
(defcustom byte-compile-dynamic-docstrings t
|
2008-11-20 12:13:49 +00:00
|
|
|
|
"If non-nil, compile doc strings for lazy access.
|
|
|
|
|
We bury the doc strings of functions and variables inside comments in
|
|
|
|
|
the file, and bring them into core only when they are actually needed.
|
1994-12-24 05:58:05 +00:00
|
|
|
|
|
|
|
|
|
When this option is true, if you load the compiled file and then move it,
|
|
|
|
|
you won't be able to find the documentation of anything in that file.
|
|
|
|
|
|
1995-05-18 20:04:09 +00:00
|
|
|
|
To disable this option for a certain file, make it a file-local variable
|
|
|
|
|
in the source file. For example, add this to the first line:
|
|
|
|
|
-*-byte-compile-dynamic-docstrings:nil;-*-
|
|
|
|
|
You can also set the variable globally.
|
|
|
|
|
|
1998-01-26 10:28:01 +00:00
|
|
|
|
This option is enabled by default because it reduces Emacs memory usage."
|
|
|
|
|
:group 'bytecomp
|
|
|
|
|
:type 'boolean)
|
2006-05-11 15:01:41 +00:00
|
|
|
|
;;;###autoload(put 'byte-compile-dynamic-docstrings 'safe-local-variable 'booleanp)
|
1994-12-24 05:58:05 +00:00
|
|
|
|
|
1998-01-26 10:28:01 +00:00
|
|
|
|
(defcustom byte-optimize-log nil
|
2008-11-20 12:13:49 +00:00
|
|
|
|
"If true, the byte-compiler will log its optimizations into *Compile-Log*.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
If this is 'source, then only source-level optimizations will be logged.
|
1998-01-26 10:28:01 +00:00
|
|
|
|
If it is 'byte, then only byte-level optimizations will be logged."
|
|
|
|
|
:group 'bytecomp
|
|
|
|
|
:type '(choice (const :tag "none" nil)
|
|
|
|
|
(const :tag "all" t)
|
|
|
|
|
(const :tag "source-level" source)
|
|
|
|
|
(const :tag "byte-level" byte)))
|
|
|
|
|
|
|
|
|
|
(defcustom byte-compile-error-on-warn nil
|
2008-11-20 12:13:49 +00:00
|
|
|
|
"If true, the byte-compiler reports warnings with `error'."
|
1998-01-26 10:28:01 +00:00
|
|
|
|
:group 'bytecomp
|
|
|
|
|
:type 'boolean)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
1994-12-26 01:28:59 +00:00
|
|
|
|
(defconst byte-compile-warning-types
|
2004-11-02 09:22:16 +00:00
|
|
|
|
'(redefine callargs free-vars unresolved
|
2007-09-21 07:17:23 +00:00
|
|
|
|
obsolete noruntime cl-functions interactive-only
|
|
|
|
|
make-local mapcar)
|
2002-07-02 18:48:34 +00:00
|
|
|
|
"The list of warning types used when `byte-compile-warnings' is t.")
|
1998-01-26 10:28:01 +00:00
|
|
|
|
(defcustom byte-compile-warnings t
|
2008-11-20 12:13:49 +00:00
|
|
|
|
"List of warnings that the byte-compiler should issue (t for all).
|
2002-07-02 18:48:34 +00:00
|
|
|
|
|
2006-11-30 16:26:37 +00:00
|
|
|
|
Elements of the list may be:
|
1992-08-12 12:57:12 +00:00
|
|
|
|
|
|
|
|
|
free-vars references to variables not in the current lexical scope.
|
|
|
|
|
unresolved calls to unknown functions.
|
2005-05-14 12:30:08 +00:00
|
|
|
|
callargs function calls with args that don't match the definition.
|
|
|
|
|
redefine function name redefined from a macro to ordinary function or vice
|
1992-08-12 12:57:12 +00:00
|
|
|
|
versa, or redefined to take a different number of arguments.
|
2002-07-02 18:48:34 +00:00
|
|
|
|
obsolete obsolete variables and functions.
|
|
|
|
|
noruntime functions that may not be defined at runtime (typically
|
|
|
|
|
defined only under `eval-when-compile').
|
2002-10-17 15:32:26 +00:00
|
|
|
|
cl-functions calls to runtime functions from the CL package (as
|
2004-11-02 09:22:16 +00:00
|
|
|
|
distinguished from macros and aliases).
|
|
|
|
|
interactive-only
|
2007-06-07 07:00:00 +00:00
|
|
|
|
commands that normally shouldn't be called from Lisp code.
|
2007-09-21 07:13:28 +00:00
|
|
|
|
make-local calls to make-variable-buffer-local that may be incorrect.
|
2007-10-28 23:53:06 +00:00
|
|
|
|
mapcar mapcar called for effect.
|
|
|
|
|
|
|
|
|
|
If the list begins with `not', then the remaining elements specify warnings to
|
|
|
|
|
suppress. For example, (not mapcar) will suppress warnings about mapcar."
|
1998-01-26 10:28:01 +00:00
|
|
|
|
:group 'bytecomp
|
2002-07-02 18:48:34 +00:00
|
|
|
|
:type `(choice (const :tag "All" t)
|
1998-04-14 10:43:27 +00:00
|
|
|
|
(set :menu-tag "Some"
|
|
|
|
|
(const free-vars) (const unresolved)
|
2002-07-02 18:48:34 +00:00
|
|
|
|
(const callargs) (const redefine)
|
2004-11-02 09:22:16 +00:00
|
|
|
|
(const obsolete) (const noruntime)
|
2007-06-07 07:00:00 +00:00
|
|
|
|
(const cl-functions) (const interactive-only)
|
2007-09-21 07:13:28 +00:00
|
|
|
|
(const make-local) (const mapcar))))
|
2007-10-26 07:35:31 +00:00
|
|
|
|
;;;###autoload(put 'byte-compile-warnings 'safe-local-variable 'byte-compile-warnings-safe-p)
|
|
|
|
|
|
2006-05-16 10:05:09 +00:00
|
|
|
|
;;;###autoload
|
|
|
|
|
(defun byte-compile-warnings-safe-p (x)
|
2008-03-31 11:02:04 +00:00
|
|
|
|
"Return non-nil if X is valid as a value of `byte-compile-warnings'."
|
2006-05-16 10:05:09 +00:00
|
|
|
|
(or (booleanp x)
|
|
|
|
|
(and (listp x)
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(if (eq (car x) 'not) (setq x (cdr x))
|
|
|
|
|
t)
|
2006-05-16 10:05:09 +00:00
|
|
|
|
(equal (mapcar
|
|
|
|
|
(lambda (e)
|
2008-03-31 11:02:04 +00:00
|
|
|
|
(when (memq e byte-compile-warning-types)
|
2006-05-16 10:05:09 +00:00
|
|
|
|
e))
|
|
|
|
|
x)
|
|
|
|
|
x))))
|
2004-11-02 09:22:16 +00:00
|
|
|
|
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(defun byte-compile-warning-enabled-p (warning)
|
|
|
|
|
"Return non-nil if WARNING is enabled, according to `byte-compile-warnings'."
|
|
|
|
|
(or (eq byte-compile-warnings t)
|
|
|
|
|
(if (eq (car byte-compile-warnings) 'not)
|
|
|
|
|
(not (memq warning byte-compile-warnings))
|
|
|
|
|
(memq warning byte-compile-warnings))))
|
|
|
|
|
|
|
|
|
|
;;;###autoload
|
|
|
|
|
(defun byte-compile-disable-warning (warning)
|
|
|
|
|
"Change `byte-compile-warnings' to disable WARNING.
|
|
|
|
|
If `byte-compile-warnings' is t, set it to `(not WARNING)'.
|
2007-10-30 06:23:06 +00:00
|
|
|
|
Otherwise, if the first element is `not', add WARNING, else remove it.
|
|
|
|
|
Normally you should let-bind `byte-compile-warnings' before calling this,
|
|
|
|
|
else the global value will be modified."
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(setq byte-compile-warnings
|
|
|
|
|
(cond ((eq byte-compile-warnings t)
|
|
|
|
|
(list 'not warning))
|
|
|
|
|
((eq (car byte-compile-warnings) 'not)
|
|
|
|
|
(if (memq warning byte-compile-warnings)
|
|
|
|
|
byte-compile-warnings
|
|
|
|
|
(append byte-compile-warnings (list warning))))
|
|
|
|
|
(t
|
|
|
|
|
(delq warning byte-compile-warnings)))))
|
|
|
|
|
|
|
|
|
|
;;;###autoload
|
|
|
|
|
(defun byte-compile-enable-warning (warning)
|
|
|
|
|
"Change `byte-compile-warnings' to enable WARNING.
|
|
|
|
|
If `byte-compile-warnings' is `t', do nothing. Otherwise, if the
|
2007-10-30 06:23:06 +00:00
|
|
|
|
first element is `not', remove WARNING, else add it.
|
|
|
|
|
Normally you should let-bind `byte-compile-warnings' before calling this,
|
|
|
|
|
else the global value will be modified."
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(or (eq byte-compile-warnings t)
|
|
|
|
|
(setq byte-compile-warnings
|
|
|
|
|
(cond ((eq (car byte-compile-warnings) 'not)
|
|
|
|
|
(delq warning byte-compile-warnings))
|
|
|
|
|
((memq warning byte-compile-warnings)
|
|
|
|
|
byte-compile-warnings)
|
|
|
|
|
(t
|
|
|
|
|
(append byte-compile-warnings (list warning)))))))
|
|
|
|
|
|
2004-11-02 09:22:16 +00:00
|
|
|
|
(defvar byte-compile-interactive-only-functions
|
|
|
|
|
'(beginning-of-buffer end-of-buffer replace-string replace-regexp
|
2009-08-10 16:28:18 +00:00
|
|
|
|
insert-file insert-buffer insert-file-literally previous-line next-line
|
2009-08-30 05:22:50 +00:00
|
|
|
|
goto-line comint-run)
|
2004-11-02 09:22:16 +00:00
|
|
|
|
"List of commands that are not meant to be called from Lisp.")
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(defvar byte-compile-not-obsolete-var nil
|
|
|
|
|
"If non-nil, this is a variable that shouldn't be reported as obsolete.")
|
|
|
|
|
|
1998-01-26 10:28:01 +00:00
|
|
|
|
(defcustom byte-compile-generate-call-tree nil
|
2008-11-20 12:13:49 +00:00
|
|
|
|
"Non-nil means collect call-graph information when compiling.
|
2004-09-08 12:04:22 +00:00
|
|
|
|
This records which functions were called and from where.
|
1992-07-15 20:26:37 +00:00
|
|
|
|
If the value is t, compilation displays the call graph when it finishes.
|
|
|
|
|
If the value is neither t nor nil, compilation asks you whether to display
|
|
|
|
|
the graph.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
The call tree only lists functions called, not macros used. Those functions
|
|
|
|
|
which the byte-code interpreter knows about directly (eq, cons, etc.) are
|
|
|
|
|
not reported.
|
|
|
|
|
|
|
|
|
|
The call tree also lists those functions which are not known to be called
|
1995-01-09 23:10:10 +00:00
|
|
|
|
\(that is, to which no calls have been compiled). Functions which can be
|
1998-01-26 10:28:01 +00:00
|
|
|
|
invoked interactively are excluded from this list."
|
|
|
|
|
:group 'bytecomp
|
|
|
|
|
:type '(choice (const :tag "Yes" t) (const :tag "No" nil)
|
1998-06-24 09:02:58 +00:00
|
|
|
|
(other :tag "Ask" lambda)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2008-11-20 12:13:49 +00:00
|
|
|
|
(defvar byte-compile-call-tree nil
|
|
|
|
|
"Alist of functions and their call tree.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
Each element looks like
|
|
|
|
|
|
|
|
|
|
\(FUNCTION CALLERS CALLS\)
|
|
|
|
|
|
|
|
|
|
where CALLERS is a list of functions that call FUNCTION, and CALLS
|
|
|
|
|
is a list of functions for which calls were generated while compiling
|
|
|
|
|
FUNCTION.")
|
|
|
|
|
|
1998-01-26 10:28:01 +00:00
|
|
|
|
(defcustom byte-compile-call-tree-sort 'name
|
2008-11-20 12:13:49 +00:00
|
|
|
|
"If non-nil, sort the call tree.
|
1992-07-15 20:26:37 +00:00
|
|
|
|
The values `name', `callers', `calls', `calls+callers'
|
1998-01-26 10:28:01 +00:00
|
|
|
|
specify different fields to sort on."
|
|
|
|
|
:group 'bytecomp
|
|
|
|
|
:type '(choice (const name) (const callers) (const calls)
|
|
|
|
|
(const calls+callers) (const nil)))
|
1992-07-15 20:26:37 +00:00
|
|
|
|
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(defvar byte-compile-debug nil)
|
|
|
|
|
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; (defvar byte-compile-overwrite-file t
|
|
|
|
|
;; "If nil, old .elc files are deleted before the new is saved, and .elc
|
|
|
|
|
;; files will have the same modes as the corresponding .el file. Otherwise,
|
|
|
|
|
;; existing .elc files will simply be overwritten, and the existing modes
|
2000-03-29 21:32:57 +00:00
|
|
|
|
;; will not be changed. If this variable is nil, then an .elc file which
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; is a symbolic link will be turned into a normal file, instead of the file
|
|
|
|
|
;; which the link points to being overwritten.")
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
(defvar byte-compile-constants nil
|
2000-03-24 18:37:48 +00:00
|
|
|
|
"List of all constants encountered during compilation of this form.")
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defvar byte-compile-variables nil
|
2000-03-24 18:37:48 +00:00
|
|
|
|
"List of all variables encountered during compilation of this form.")
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defvar byte-compile-bound-variables nil
|
1999-12-16 15:26:03 +00:00
|
|
|
|
"List of variables bound in the context of the current form.
|
|
|
|
|
This list lives partly on the stack.")
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(defvar byte-compile-const-variables nil
|
|
|
|
|
"List of variables declared as constants during compilation of this file.")
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defvar byte-compile-free-references)
|
|
|
|
|
(defvar byte-compile-free-assignments)
|
|
|
|
|
|
1992-09-13 19:05:13 +00:00
|
|
|
|
(defvar byte-compiler-error-flag)
|
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defconst byte-compile-initial-macro-environment
|
1992-07-15 20:26:37 +00:00
|
|
|
|
'(
|
|
|
|
|
;; (byte-compiler-options . (lambda (&rest forms)
|
|
|
|
|
;; (apply 'byte-compiler-options-handler forms)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(eval-when-compile . (lambda (&rest body)
|
2000-03-24 18:37:48 +00:00
|
|
|
|
(list 'quote
|
|
|
|
|
(byte-compile-eval (byte-compile-top-level
|
|
|
|
|
(cons 'progn body))))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(eval-and-compile . (lambda (&rest body)
|
2002-07-02 18:48:34 +00:00
|
|
|
|
(byte-compile-eval-before-compile (cons 'progn body))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(cons 'progn body))))
|
|
|
|
|
"The default macro-environment passed to macroexpand by the compiler.
|
|
|
|
|
Placing a macro here will cause a macro to have different semantics when
|
|
|
|
|
expanded by the compiler as when expanded by the interpreter.")
|
|
|
|
|
|
|
|
|
|
(defvar byte-compile-macro-environment byte-compile-initial-macro-environment
|
1992-07-15 20:26:37 +00:00
|
|
|
|
"Alist of macros defined in the file being compiled.
|
|
|
|
|
Each element looks like (MACRONAME . DEFINITION). It is
|
1993-06-11 16:19:49 +00:00
|
|
|
|
\(MACRONAME . nil) when a macro is redefined as a function.")
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
(defvar byte-compile-function-environment nil
|
1992-07-15 20:26:37 +00:00
|
|
|
|
"Alist of functions defined in the file being compiled.
|
|
|
|
|
This is so we can inline them when necessary.
|
|
|
|
|
Each element looks like (FUNCTIONNAME . DEFINITION). It is
|
2004-11-09 10:33:23 +00:00
|
|
|
|
\(FUNCTIONNAME . nil) when a function is redefined as a macro.
|
|
|
|
|
It is \(FUNCTIONNAME . t) when all we know is that it was defined,
|
|
|
|
|
and we don't know the definition.")
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
(defvar byte-compile-unresolved-functions nil
|
2000-03-24 18:37:48 +00:00
|
|
|
|
"Alist of undefined functions to which calls have been compiled.
|
2007-07-24 08:18:12 +00:00
|
|
|
|
This variable is only significant whilst compiling an entire buffer.
|
|
|
|
|
Used for warnings when a function is not known to be defined or is later
|
2000-03-24 18:37:48 +00:00
|
|
|
|
defined with incorrect args.")
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(defvar byte-compile-noruntime-functions nil
|
|
|
|
|
"Alist of functions called that may not be defined when the compiled code is run.
|
|
|
|
|
Used for warnings about calling a function that is defined during compilation
|
|
|
|
|
but won't necessarily be defined when the compiled file is loaded.")
|
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defvar byte-compile-tag-number 0)
|
|
|
|
|
(defvar byte-compile-output nil
|
|
|
|
|
"Alist describing contents to put in byte code string.
|
|
|
|
|
Each element is (INDEX . VALUE)")
|
|
|
|
|
(defvar byte-compile-depth 0 "Current depth of execution stack.")
|
|
|
|
|
(defvar byte-compile-maxdepth 0 "Maximum depth of execution stack.")
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
;;; The byte codes; this information is duplicated in bytecomp.c
|
|
|
|
|
|
2001-11-17 00:54:36 +00:00
|
|
|
|
(defvar byte-code-vector nil
|
1992-07-10 22:06:47 +00:00
|
|
|
|
"An array containing byte-code names indexed by byte-code values.")
|
|
|
|
|
|
2001-11-17 00:54:36 +00:00
|
|
|
|
(defvar byte-stack+-info nil
|
1992-07-10 22:06:47 +00:00
|
|
|
|
"An array with the stack adjustment for each byte-code.")
|
|
|
|
|
|
|
|
|
|
(defmacro byte-defop (opcode stack-adjust opname &optional docstring)
|
|
|
|
|
;; This is a speed-hack for building the byte-code-vector at compile-time.
|
|
|
|
|
;; We fill in the vector at macroexpand-time, and then after the last call
|
|
|
|
|
;; to byte-defop, we write the vector out as a constant instead of writing
|
|
|
|
|
;; out a bunch of calls to aset.
|
|
|
|
|
;; Actually, we don't fill in the vector itself, because that could make
|
|
|
|
|
;; it problematic to compile big changes to this compiler; we store the
|
|
|
|
|
;; values on its plist, and remove them later in -extrude.
|
|
|
|
|
(let ((v1 (or (get 'byte-code-vector 'tmp-compile-time-value)
|
|
|
|
|
(put 'byte-code-vector 'tmp-compile-time-value
|
|
|
|
|
(make-vector 256 nil))))
|
|
|
|
|
(v2 (or (get 'byte-stack+-info 'tmp-compile-time-value)
|
|
|
|
|
(put 'byte-stack+-info 'tmp-compile-time-value
|
|
|
|
|
(make-vector 256 nil)))))
|
|
|
|
|
(aset v1 opcode opname)
|
|
|
|
|
(aset v2 opcode stack-adjust))
|
|
|
|
|
(if docstring
|
|
|
|
|
(list 'defconst opname opcode (concat "Byte code opcode " docstring "."))
|
|
|
|
|
(list 'defconst opname opcode)))
|
|
|
|
|
|
|
|
|
|
(defmacro byte-extrude-byte-code-vectors ()
|
|
|
|
|
(prog1 (list 'setq 'byte-code-vector
|
|
|
|
|
(get 'byte-code-vector 'tmp-compile-time-value)
|
|
|
|
|
'byte-stack+-info
|
|
|
|
|
(get 'byte-stack+-info 'tmp-compile-time-value))
|
2000-01-06 23:38:46 +00:00
|
|
|
|
(put 'byte-code-vector 'tmp-compile-time-value nil)
|
|
|
|
|
(put 'byte-stack+-info 'tmp-compile-time-value nil)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
;; unused: 0-7
|
|
|
|
|
|
|
|
|
|
;; These opcodes are special in that they pack their argument into the
|
|
|
|
|
;; opcode word.
|
|
|
|
|
;;
|
|
|
|
|
(byte-defop 8 1 byte-varref "for variable reference")
|
|
|
|
|
(byte-defop 16 -1 byte-varset "for setting a variable")
|
|
|
|
|
(byte-defop 24 -1 byte-varbind "for binding a variable")
|
|
|
|
|
(byte-defop 32 0 byte-call "for calling a function")
|
|
|
|
|
(byte-defop 40 0 byte-unbind "for unbinding special bindings")
|
1993-06-09 11:59:12 +00:00
|
|
|
|
;; codes 8-47 are consumed by the preceding opcodes
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;; unused: 48-55
|
|
|
|
|
|
|
|
|
|
(byte-defop 56 -1 byte-nth)
|
|
|
|
|
(byte-defop 57 0 byte-symbolp)
|
|
|
|
|
(byte-defop 58 0 byte-consp)
|
|
|
|
|
(byte-defop 59 0 byte-stringp)
|
|
|
|
|
(byte-defop 60 0 byte-listp)
|
|
|
|
|
(byte-defop 61 -1 byte-eq)
|
|
|
|
|
(byte-defop 62 -1 byte-memq)
|
|
|
|
|
(byte-defop 63 0 byte-not)
|
|
|
|
|
(byte-defop 64 0 byte-car)
|
|
|
|
|
(byte-defop 65 0 byte-cdr)
|
|
|
|
|
(byte-defop 66 -1 byte-cons)
|
|
|
|
|
(byte-defop 67 0 byte-list1)
|
|
|
|
|
(byte-defop 68 -1 byte-list2)
|
|
|
|
|
(byte-defop 69 -2 byte-list3)
|
|
|
|
|
(byte-defop 70 -3 byte-list4)
|
|
|
|
|
(byte-defop 71 0 byte-length)
|
|
|
|
|
(byte-defop 72 -1 byte-aref)
|
|
|
|
|
(byte-defop 73 -2 byte-aset)
|
|
|
|
|
(byte-defop 74 0 byte-symbol-value)
|
|
|
|
|
(byte-defop 75 0 byte-symbol-function) ; this was commented out
|
|
|
|
|
(byte-defop 76 -1 byte-set)
|
|
|
|
|
(byte-defop 77 -1 byte-fset) ; this was commented out
|
|
|
|
|
(byte-defop 78 -1 byte-get)
|
|
|
|
|
(byte-defop 79 -2 byte-substring)
|
|
|
|
|
(byte-defop 80 -1 byte-concat2)
|
|
|
|
|
(byte-defop 81 -2 byte-concat3)
|
|
|
|
|
(byte-defop 82 -3 byte-concat4)
|
|
|
|
|
(byte-defop 83 0 byte-sub1)
|
|
|
|
|
(byte-defop 84 0 byte-add1)
|
|
|
|
|
(byte-defop 85 -1 byte-eqlsign)
|
|
|
|
|
(byte-defop 86 -1 byte-gtr)
|
|
|
|
|
(byte-defop 87 -1 byte-lss)
|
|
|
|
|
(byte-defop 88 -1 byte-leq)
|
|
|
|
|
(byte-defop 89 -1 byte-geq)
|
|
|
|
|
(byte-defop 90 -1 byte-diff)
|
|
|
|
|
(byte-defop 91 0 byte-negate)
|
|
|
|
|
(byte-defop 92 -1 byte-plus)
|
|
|
|
|
(byte-defop 93 -1 byte-max)
|
|
|
|
|
(byte-defop 94 -1 byte-min)
|
|
|
|
|
(byte-defop 95 -1 byte-mult) ; v19 only
|
|
|
|
|
(byte-defop 96 1 byte-point)
|
|
|
|
|
(byte-defop 98 0 byte-goto-char)
|
|
|
|
|
(byte-defop 99 0 byte-insert)
|
|
|
|
|
(byte-defop 100 1 byte-point-max)
|
|
|
|
|
(byte-defop 101 1 byte-point-min)
|
|
|
|
|
(byte-defop 102 0 byte-char-after)
|
|
|
|
|
(byte-defop 103 1 byte-following-char)
|
|
|
|
|
(byte-defop 104 1 byte-preceding-char)
|
|
|
|
|
(byte-defop 105 1 byte-current-column)
|
|
|
|
|
(byte-defop 106 0 byte-indent-to)
|
|
|
|
|
(byte-defop 107 0 byte-scan-buffer-OBSOLETE) ; no longer generated as of v18
|
|
|
|
|
(byte-defop 108 1 byte-eolp)
|
|
|
|
|
(byte-defop 109 1 byte-eobp)
|
|
|
|
|
(byte-defop 110 1 byte-bolp)
|
|
|
|
|
(byte-defop 111 1 byte-bobp)
|
|
|
|
|
(byte-defop 112 1 byte-current-buffer)
|
|
|
|
|
(byte-defop 113 0 byte-set-buffer)
|
1997-06-15 23:05:19 +00:00
|
|
|
|
(byte-defop 114 0 byte-save-current-buffer
|
|
|
|
|
"To make a binding to record the current buffer")
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-defop 115 0 byte-set-mark-OBSOLETE)
|
|
|
|
|
(byte-defop 116 1 byte-interactive-p)
|
|
|
|
|
|
|
|
|
|
;; These ops are new to v19
|
|
|
|
|
(byte-defop 117 0 byte-forward-char)
|
|
|
|
|
(byte-defop 118 0 byte-forward-word)
|
|
|
|
|
(byte-defop 119 -1 byte-skip-chars-forward)
|
|
|
|
|
(byte-defop 120 -1 byte-skip-chars-backward)
|
|
|
|
|
(byte-defop 121 0 byte-forward-line)
|
|
|
|
|
(byte-defop 122 0 byte-char-syntax)
|
|
|
|
|
(byte-defop 123 -1 byte-buffer-substring)
|
|
|
|
|
(byte-defop 124 -1 byte-delete-region)
|
|
|
|
|
(byte-defop 125 -1 byte-narrow-to-region)
|
|
|
|
|
(byte-defop 126 1 byte-widen)
|
|
|
|
|
(byte-defop 127 0 byte-end-of-line)
|
|
|
|
|
|
|
|
|
|
;; unused: 128
|
|
|
|
|
|
|
|
|
|
;; These store their argument in the next two bytes
|
|
|
|
|
(byte-defop 129 1 byte-constant2
|
|
|
|
|
"for reference to a constant with vector index >= byte-constant-limit")
|
|
|
|
|
(byte-defop 130 0 byte-goto "for unconditional jump")
|
|
|
|
|
(byte-defop 131 -1 byte-goto-if-nil "to pop value and jump if it's nil")
|
|
|
|
|
(byte-defop 132 -1 byte-goto-if-not-nil "to pop value and jump if it's not nil")
|
|
|
|
|
(byte-defop 133 -1 byte-goto-if-nil-else-pop
|
2000-03-29 21:32:57 +00:00
|
|
|
|
"to examine top-of-stack, jump and don't pop it if it's nil,
|
1992-07-10 22:06:47 +00:00
|
|
|
|
otherwise pop it")
|
|
|
|
|
(byte-defop 134 -1 byte-goto-if-not-nil-else-pop
|
2000-03-29 21:32:57 +00:00
|
|
|
|
"to examine top-of-stack, jump and don't pop it if it's non nil,
|
1992-07-10 22:06:47 +00:00
|
|
|
|
otherwise pop it")
|
|
|
|
|
|
|
|
|
|
(byte-defop 135 -1 byte-return "to pop a value and return it from `byte-code'")
|
|
|
|
|
(byte-defop 136 -1 byte-discard "to discard one value from stack")
|
|
|
|
|
(byte-defop 137 1 byte-dup "to duplicate the top of the stack")
|
|
|
|
|
|
|
|
|
|
(byte-defop 138 0 byte-save-excursion
|
|
|
|
|
"to make a binding to record the buffer, point and mark")
|
|
|
|
|
(byte-defop 139 0 byte-save-window-excursion
|
|
|
|
|
"to make a binding to record entire window configuration")
|
|
|
|
|
(byte-defop 140 0 byte-save-restriction
|
|
|
|
|
"to make a binding to record the current buffer clipping restrictions")
|
|
|
|
|
(byte-defop 141 -1 byte-catch
|
|
|
|
|
"for catch. Takes, on stack, the tag and an expression for the body")
|
|
|
|
|
(byte-defop 142 -1 byte-unwind-protect
|
|
|
|
|
"for unwind-protect. Takes, on stack, an expression for the unwind-action")
|
|
|
|
|
|
2000-03-29 21:32:57 +00:00
|
|
|
|
;; For condition-case. Takes, on stack, the variable to bind,
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; an expression for the body, and a list of clauses.
|
|
|
|
|
(byte-defop 143 -2 byte-condition-case)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; For entry to with-output-to-temp-buffer.
|
|
|
|
|
;; Takes, on stack, the buffer name.
|
|
|
|
|
;; Binds standard-output and does some other things.
|
|
|
|
|
;; Returns with temp buffer on the stack in place of buffer name.
|
|
|
|
|
(byte-defop 144 0 byte-temp-output-buffer-setup)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; For exit from with-output-to-temp-buffer.
|
|
|
|
|
;; Expects the temp buffer on the stack underneath value to return.
|
|
|
|
|
;; Pops them both, then pushes the value back on.
|
|
|
|
|
;; Unbinds standard-output and makes the temp buffer visible.
|
|
|
|
|
(byte-defop 145 -1 byte-temp-output-buffer-show)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;; these ops are new to v19
|
1992-07-15 20:26:37 +00:00
|
|
|
|
|
|
|
|
|
;; To unbind back to the beginning of this frame.
|
1995-03-24 23:43:21 +00:00
|
|
|
|
;; Not used yet, but will be needed for tail-recursion elimination.
|
1992-07-15 20:26:37 +00:00
|
|
|
|
(byte-defop 146 0 byte-unbind-all)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;; these ops are new to v19
|
|
|
|
|
(byte-defop 147 -2 byte-set-marker)
|
|
|
|
|
(byte-defop 148 0 byte-match-beginning)
|
|
|
|
|
(byte-defop 149 0 byte-match-end)
|
|
|
|
|
(byte-defop 150 0 byte-upcase)
|
|
|
|
|
(byte-defop 151 0 byte-downcase)
|
|
|
|
|
(byte-defop 152 -1 byte-string=)
|
|
|
|
|
(byte-defop 153 -1 byte-string<)
|
|
|
|
|
(byte-defop 154 -1 byte-equal)
|
|
|
|
|
(byte-defop 155 -1 byte-nthcdr)
|
|
|
|
|
(byte-defop 156 -1 byte-elt)
|
|
|
|
|
(byte-defop 157 -1 byte-member)
|
|
|
|
|
(byte-defop 158 -1 byte-assq)
|
|
|
|
|
(byte-defop 159 0 byte-nreverse)
|
|
|
|
|
(byte-defop 160 -1 byte-setcar)
|
|
|
|
|
(byte-defop 161 -1 byte-setcdr)
|
|
|
|
|
(byte-defop 162 0 byte-car-safe)
|
|
|
|
|
(byte-defop 163 0 byte-cdr-safe)
|
|
|
|
|
(byte-defop 164 -1 byte-nconc)
|
|
|
|
|
(byte-defop 165 -1 byte-quo)
|
|
|
|
|
(byte-defop 166 -1 byte-rem)
|
|
|
|
|
(byte-defop 167 0 byte-numberp)
|
|
|
|
|
(byte-defop 168 0 byte-integerp)
|
|
|
|
|
|
1992-07-22 16:55:01 +00:00
|
|
|
|
;; unused: 169-174
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-defop 175 nil byte-listN)
|
|
|
|
|
(byte-defop 176 nil byte-concatN)
|
|
|
|
|
(byte-defop 177 nil byte-insertN)
|
|
|
|
|
|
|
|
|
|
;; unused: 178-191
|
|
|
|
|
|
|
|
|
|
(byte-defop 192 1 byte-constant "for reference to a constant")
|
|
|
|
|
;; codes 193-255 are consumed by byte-constant.
|
|
|
|
|
(defconst byte-constant-limit 64
|
|
|
|
|
"Exclusive maximum index usable in the `byte-constant' opcode.")
|
|
|
|
|
|
|
|
|
|
(defconst byte-goto-ops '(byte-goto byte-goto-if-nil byte-goto-if-not-nil
|
|
|
|
|
byte-goto-if-nil-else-pop
|
|
|
|
|
byte-goto-if-not-nil-else-pop)
|
1992-07-15 20:26:37 +00:00
|
|
|
|
"List of byte-codes whose offset is a pc.")
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
(defconst byte-goto-always-pop-ops '(byte-goto-if-nil byte-goto-if-not-nil))
|
|
|
|
|
|
|
|
|
|
(byte-extrude-byte-code-vectors)
|
|
|
|
|
|
|
|
|
|
;;; lapcode generator
|
2001-10-05 09:29:51 +00:00
|
|
|
|
;;
|
|
|
|
|
;; the byte-compiler now does source -> lapcode -> bytecode instead of
|
|
|
|
|
;; source -> bytecode, because it's a lot easier to make optimizations
|
|
|
|
|
;; on lapcode than on bytecode.
|
|
|
|
|
;;
|
|
|
|
|
;; Elements of the lapcode list are of the form (<instruction> . <parameter>)
|
|
|
|
|
;; where instruction is a symbol naming a byte-code instruction,
|
|
|
|
|
;; and parameter is an argument to that instruction, if any.
|
|
|
|
|
;;
|
|
|
|
|
;; The instruction can be the pseudo-op TAG, which means that this position
|
|
|
|
|
;; in the instruction stream is a target of a goto. (car PARAMETER) will be
|
|
|
|
|
;; the PC for this location, and the whole instruction "(TAG pc)" will be the
|
|
|
|
|
;; parameter for some goto op.
|
|
|
|
|
;;
|
|
|
|
|
;; If the operation is varbind, varref, varset or push-constant, then the
|
|
|
|
|
;; parameter is (variable/constant . index_in_constant_vector).
|
|
|
|
|
;;
|
|
|
|
|
;; First, the source code is macroexpanded and optimized in various ways.
|
|
|
|
|
;; Then the resultant code is compiled into lapcode. Another set of
|
|
|
|
|
;; optimizations are then run over the lapcode. Then the variables and
|
|
|
|
|
;; constants referenced by the lapcode are collected and placed in the
|
|
|
|
|
;; constants-vector. (This happens now so that variables referenced by dead
|
|
|
|
|
;; code don't consume space.) And finally, the lapcode is transformed into
|
|
|
|
|
;; compacted byte-code.
|
|
|
|
|
;;
|
|
|
|
|
;; A distinction is made between variables and constants because the variable-
|
|
|
|
|
;; referencing instructions are more sensitive to the variables being near the
|
|
|
|
|
;; front of the constants-vector than the constant-referencing instructions.
|
|
|
|
|
;; Also, this lets us notice references to free variables.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
(defun byte-compile-lapcode (lap)
|
|
|
|
|
"Turns lapcode into bytecode. The lapcode is destroyed."
|
|
|
|
|
;; Lapcode modifications: changes the ID of a tag to be the tag's PC.
|
|
|
|
|
(let ((pc 0) ; Program counter
|
|
|
|
|
op off ; Operation & offset
|
|
|
|
|
(bytes '()) ; Put the output bytes here
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(patchlist nil)) ; List of tags and goto's to patch
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(while lap
|
|
|
|
|
(setq op (car (car lap))
|
|
|
|
|
off (cdr (car lap)))
|
|
|
|
|
(cond ((not (symbolp op))
|
1992-07-15 20:26:37 +00:00
|
|
|
|
(error "Non-symbolic opcode `%s'" op))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
((eq op 'TAG)
|
|
|
|
|
(setcar off pc)
|
|
|
|
|
(setq patchlist (cons off patchlist)))
|
|
|
|
|
((memq op byte-goto-ops)
|
|
|
|
|
(setq pc (+ pc 3))
|
|
|
|
|
(setq bytes (cons (cons pc (cdr off))
|
|
|
|
|
(cons nil
|
|
|
|
|
(cons (symbol-value op) bytes))))
|
|
|
|
|
(setq patchlist (cons bytes patchlist)))
|
|
|
|
|
(t
|
|
|
|
|
(setq bytes
|
|
|
|
|
(cond ((cond ((consp off)
|
|
|
|
|
;; Variable or constant reference
|
|
|
|
|
(setq off (cdr off))
|
|
|
|
|
(eq op 'byte-constant)))
|
|
|
|
|
(cond ((< off byte-constant-limit)
|
|
|
|
|
(setq pc (1+ pc))
|
|
|
|
|
(cons (+ byte-constant off) bytes))
|
|
|
|
|
(t
|
|
|
|
|
(setq pc (+ 3 pc))
|
|
|
|
|
(cons (lsh off -8)
|
|
|
|
|
(cons (logand off 255)
|
|
|
|
|
(cons byte-constant2 bytes))))))
|
|
|
|
|
((<= byte-listN (symbol-value op))
|
|
|
|
|
(setq pc (+ 2 pc))
|
|
|
|
|
(cons off (cons (symbol-value op) bytes)))
|
|
|
|
|
((< off 6)
|
|
|
|
|
(setq pc (1+ pc))
|
|
|
|
|
(cons (+ (symbol-value op) off) bytes))
|
|
|
|
|
((< off 256)
|
|
|
|
|
(setq pc (+ 2 pc))
|
|
|
|
|
(cons off (cons (+ (symbol-value op) 6) bytes)))
|
|
|
|
|
(t
|
|
|
|
|
(setq pc (+ 3 pc))
|
|
|
|
|
(cons (lsh off -8)
|
|
|
|
|
(cons (logand off 255)
|
|
|
|
|
(cons (+ (symbol-value op) 7)
|
|
|
|
|
bytes))))))))
|
|
|
|
|
(setq lap (cdr lap)))
|
|
|
|
|
;;(if (not (= pc (length bytes)))
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; (error "Compiler error: pc mismatch - %s %s" pc (length bytes)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; Patch PC into jumps
|
|
|
|
|
(let (bytes)
|
|
|
|
|
(while patchlist
|
|
|
|
|
(setq bytes (car patchlist))
|
|
|
|
|
(cond ((atom (car bytes))) ; Tag
|
|
|
|
|
(t ; Absolute jump
|
|
|
|
|
(setq pc (car (cdr (car bytes)))) ; Pick PC from tag
|
|
|
|
|
(setcar (cdr bytes) (logand pc 255))
|
2009-08-26 02:56:05 +00:00
|
|
|
|
(setcar bytes (lsh pc -8))
|
|
|
|
|
;; FIXME: Replace this by some workaround.
|
2009-08-26 14:47:23 +00:00
|
|
|
|
(if (> (car bytes) 255) (error "Bytecode overflow"))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(setq patchlist (cdr patchlist))))
|
2008-02-12 11:25:01 +00:00
|
|
|
|
(apply 'unibyte-string (nreverse bytes))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2000-03-24 18:37:48 +00:00
|
|
|
|
|
|
|
|
|
;;; compile-time evaluation
|
|
|
|
|
|
2000-03-26 19:52:27 +00:00
|
|
|
|
(defun byte-compile-eval (form)
|
|
|
|
|
"Eval FORM and mark the functions defined therein.
|
2004-04-16 12:51:06 +00:00
|
|
|
|
Each function's symbol gets added to `byte-compile-noruntime-functions'."
|
2000-03-24 18:37:48 +00:00
|
|
|
|
(let ((hist-orig load-history)
|
|
|
|
|
(hist-nil-orig current-load-list))
|
2000-03-26 19:52:27 +00:00
|
|
|
|
(prog1 (eval form)
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(when (byte-compile-warning-enabled-p 'noruntime)
|
2000-03-24 18:37:48 +00:00
|
|
|
|
(let ((hist-new load-history)
|
|
|
|
|
(hist-nil-new current-load-list))
|
2000-03-26 19:52:27 +00:00
|
|
|
|
;; Go through load-history, look for newly loaded files
|
|
|
|
|
;; and mark all the functions defined therein.
|
|
|
|
|
(while (and hist-new (not (eq hist-new hist-orig)))
|
2002-12-07 21:33:19 +00:00
|
|
|
|
(let ((xs (pop hist-new))
|
|
|
|
|
old-autoloads)
|
2000-03-26 19:52:27 +00:00
|
|
|
|
;; Make sure the file was not already loaded before.
|
2004-10-16 15:20:24 +00:00
|
|
|
|
(unless (or (assoc (car xs) hist-orig)
|
|
|
|
|
(equal (car xs) "cl"))
|
2000-03-26 19:52:27 +00:00
|
|
|
|
(dolist (s xs)
|
|
|
|
|
(cond
|
2002-12-07 21:33:19 +00:00
|
|
|
|
((symbolp s)
|
|
|
|
|
(unless (memq s old-autoloads)
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(push s byte-compile-noruntime-functions)))
|
2002-12-07 21:33:19 +00:00
|
|
|
|
((and (consp s) (eq t (car s)))
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(push (cdr s) old-autoloads))
|
2000-03-26 19:52:27 +00:00
|
|
|
|
((and (consp s) (eq 'autoload (car s)))
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(push (cdr s) byte-compile-noruntime-functions)))))))
|
2000-03-26 19:52:27 +00:00
|
|
|
|
;; Go through current-load-list for the locally defined funs.
|
2002-12-07 21:33:19 +00:00
|
|
|
|
(let (old-autoloads)
|
|
|
|
|
(while (and hist-nil-new (not (eq hist-nil-new hist-nil-orig)))
|
|
|
|
|
(let ((s (pop hist-nil-new)))
|
|
|
|
|
(when (and (symbolp s) (not (memq s old-autoloads)))
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(push s byte-compile-noruntime-functions))
|
2002-12-07 21:33:19 +00:00
|
|
|
|
(when (and (consp s) (eq t (car s)))
|
2004-10-16 15:20:24 +00:00
|
|
|
|
(push (cdr s) old-autoloads)))))))
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(when (byte-compile-warning-enabled-p 'cl-functions)
|
2007-06-12 21:03:32 +00:00
|
|
|
|
(let ((hist-new load-history))
|
2004-10-16 15:20:24 +00:00
|
|
|
|
;; Go through load-history, look for newly loaded files
|
|
|
|
|
;; and mark all the functions defined therein.
|
|
|
|
|
(while (and hist-new (not (eq hist-new hist-orig)))
|
2007-06-12 21:03:32 +00:00
|
|
|
|
(let ((xs (pop hist-new)))
|
2004-10-16 15:20:24 +00:00
|
|
|
|
;; Make sure the file was not already loaded before.
|
2009-08-25 07:28:16 +00:00
|
|
|
|
(and (stringp (car xs))
|
|
|
|
|
(string-match "^cl\\>" (file-name-nondirectory (car xs)))
|
|
|
|
|
(not (assoc (car xs) hist-orig))
|
|
|
|
|
(byte-compile-find-cl-functions)))))))))
|
2000-03-24 18:37:48 +00:00
|
|
|
|
|
2002-07-02 18:48:34 +00:00
|
|
|
|
(defun byte-compile-eval-before-compile (form)
|
|
|
|
|
"Evaluate FORM for `eval-and-compile'."
|
|
|
|
|
(let ((hist-nil-orig current-load-list))
|
|
|
|
|
(prog1 (eval form)
|
|
|
|
|
;; (eval-and-compile (require 'cl) turns off warnings for cl functions.
|
|
|
|
|
(let ((tem current-load-list))
|
|
|
|
|
(while (not (eq tem hist-nil-orig))
|
|
|
|
|
(when (equal (car tem) '(require . cl))
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(byte-compile-disable-warning 'cl-functions))
|
2002-07-02 18:48:34 +00:00
|
|
|
|
(setq tem (cdr tem)))))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;;; byte compiler messages
|
|
|
|
|
|
1994-12-24 05:58:05 +00:00
|
|
|
|
(defvar byte-compile-current-form nil)
|
|
|
|
|
(defvar byte-compile-dest-file nil)
|
2000-11-09 23:01:40 +00:00
|
|
|
|
(defvar byte-compile-current-file nil)
|
2008-06-08 02:07:25 +00:00
|
|
|
|
(defvar byte-compile-current-group nil)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(defvar byte-compile-current-buffer nil)
|
2000-11-09 16:07:56 +00:00
|
|
|
|
|
2002-07-20 22:01:19 +00:00
|
|
|
|
;; Log something that isn't a warning.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defmacro byte-compile-log (format-string &rest args)
|
2004-05-19 18:53:13 +00:00
|
|
|
|
`(and
|
|
|
|
|
byte-optimize
|
|
|
|
|
(memq byte-optimize-log '(t source))
|
|
|
|
|
(let ((print-escape-newlines t)
|
|
|
|
|
(print-level 4)
|
|
|
|
|
(print-length 4))
|
|
|
|
|
(byte-compile-log-1
|
|
|
|
|
(format
|
|
|
|
|
,format-string
|
|
|
|
|
,@(mapcar
|
|
|
|
|
(lambda (x) (if (symbolp x) (list 'prin1-to-string x) x))
|
|
|
|
|
args))))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2002-07-20 22:01:19 +00:00
|
|
|
|
;; Log something that isn't a warning.
|
|
|
|
|
(defun byte-compile-log-1 (string)
|
2004-05-19 18:53:13 +00:00
|
|
|
|
(with-current-buffer "*Compile-Log*"
|
2004-10-16 15:20:24 +00:00
|
|
|
|
(let ((inhibit-read-only t))
|
|
|
|
|
(goto-char (point-max))
|
|
|
|
|
(byte-compile-warning-prefix nil nil)
|
|
|
|
|
(cond (noninteractive
|
|
|
|
|
(message " %s" string))
|
|
|
|
|
(t
|
|
|
|
|
(insert (format "%s\n" string)))))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(defvar byte-compile-read-position nil
|
|
|
|
|
"Character position we began the last `read' from.")
|
|
|
|
|
(defvar byte-compile-last-position nil
|
|
|
|
|
"Last known character position in the input.")
|
|
|
|
|
|
|
|
|
|
;; copied from gnus-util.el
|
2002-07-25 18:18:10 +00:00
|
|
|
|
(defsubst byte-compile-delete-first (elt list)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(if (eq (car list) elt)
|
|
|
|
|
(cdr list)
|
|
|
|
|
(let ((total list))
|
|
|
|
|
(while (and (cdr list)
|
|
|
|
|
(not (eq (cadr list) elt)))
|
|
|
|
|
(setq list (cdr list)))
|
|
|
|
|
(when (cdr list)
|
|
|
|
|
(setcdr list (cddr list)))
|
|
|
|
|
total)))
|
|
|
|
|
|
|
|
|
|
;; The purpose of this function is to iterate through the
|
|
|
|
|
;; `read-symbol-positions-list'. Each time we process, say, a
|
|
|
|
|
;; function definition (`defun') we remove `defun' from
|
|
|
|
|
;; `read-symbol-positions-list', and set `byte-compile-last-position'
|
|
|
|
|
;; to that symbol's character position. Similarly, if we encounter a
|
|
|
|
|
;; variable reference, like in (1+ foo), we remove `foo' from the
|
|
|
|
|
;; list. If our current position is after the symbol's position, we
|
|
|
|
|
;; assume we've already passed that point, and look for the next
|
2002-10-17 15:32:26 +00:00
|
|
|
|
;; occurrence of the symbol.
|
2005-10-23 07:33:45 +00:00
|
|
|
|
;;
|
|
|
|
|
;; This function should not be called twice for the same occurrence of
|
|
|
|
|
;; a symbol, and it should not be called for symbols generated by the
|
|
|
|
|
;; byte compiler itself; because rather than just fail looking up the
|
|
|
|
|
;; symbol, we may find an occurrence of the symbol further ahead, and
|
|
|
|
|
;; then `byte-compile-last-position' as advanced too far.
|
|
|
|
|
;;
|
2002-10-17 15:32:26 +00:00
|
|
|
|
;; So your're probably asking yourself: Isn't this function a
|
2002-05-28 17:40:47 +00:00
|
|
|
|
;; gross hack? And the answer, of course, would be yes.
|
|
|
|
|
(defun byte-compile-set-symbol-position (sym &optional allow-previous)
|
|
|
|
|
(when byte-compile-read-position
|
2002-07-25 18:18:10 +00:00
|
|
|
|
(let (last entry)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(while (progn
|
2004-11-21 00:47:13 +00:00
|
|
|
|
(setq last byte-compile-last-position
|
|
|
|
|
entry (assq sym read-symbol-positions-list))
|
|
|
|
|
(when entry
|
|
|
|
|
(setq byte-compile-last-position
|
|
|
|
|
(+ byte-compile-read-position (cdr entry))
|
|
|
|
|
read-symbol-positions-list
|
|
|
|
|
(byte-compile-delete-first
|
|
|
|
|
entry read-symbol-positions-list)))
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(or (and allow-previous (not (= last byte-compile-last-position)))
|
|
|
|
|
(> last byte-compile-last-position)))))))
|
2001-10-11 12:57:18 +00:00
|
|
|
|
|
2002-07-20 22:01:19 +00:00
|
|
|
|
(defvar byte-compile-last-warned-form nil)
|
|
|
|
|
(defvar byte-compile-last-logged-file nil)
|
|
|
|
|
|
|
|
|
|
;; This is used as warning-prefix for the compiler.
|
2002-08-29 17:26:47 +00:00
|
|
|
|
;; It is always called with the warnings buffer current.
|
2002-07-20 22:01:19 +00:00
|
|
|
|
(defun byte-compile-warning-prefix (level entry)
|
2004-10-16 15:20:24 +00:00
|
|
|
|
(let* ((inhibit-read-only t)
|
|
|
|
|
(dir default-directory)
|
2002-08-29 17:26:47 +00:00
|
|
|
|
(file (cond ((stringp byte-compile-current-file)
|
|
|
|
|
(format "%s:" (file-relative-name byte-compile-current-file dir)))
|
2001-10-11 12:57:18 +00:00
|
|
|
|
((bufferp byte-compile-current-file)
|
2001-10-18 21:05:16 +00:00
|
|
|
|
(format "Buffer %s:"
|
2001-10-11 12:57:18 +00:00
|
|
|
|
(buffer-name byte-compile-current-file)))
|
|
|
|
|
(t "")))
|
2001-10-18 21:05:16 +00:00
|
|
|
|
(pos (if (and byte-compile-current-file
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(integerp byte-compile-read-position))
|
|
|
|
|
(with-current-buffer byte-compile-current-buffer
|
2007-09-01 23:33:15 +00:00
|
|
|
|
(format "%d:%d:"
|
2007-03-11 21:16:09 +00:00
|
|
|
|
(save-excursion
|
|
|
|
|
(goto-char byte-compile-last-position)
|
|
|
|
|
(1+ (count-lines (point-min) (point-at-bol))))
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(save-excursion
|
|
|
|
|
(goto-char byte-compile-last-position)
|
|
|
|
|
(1+ (current-column)))))
|
2001-10-11 12:57:18 +00:00
|
|
|
|
""))
|
2002-08-29 17:26:47 +00:00
|
|
|
|
(form (if (eq byte-compile-current-form :end) "end of data"
|
|
|
|
|
(or byte-compile-current-form "toplevel form"))))
|
|
|
|
|
(when (or (and byte-compile-current-file
|
|
|
|
|
(not (equal byte-compile-current-file
|
|
|
|
|
byte-compile-last-logged-file)))
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(and byte-compile-current-form
|
2002-08-29 17:26:47 +00:00
|
|
|
|
(not (eq byte-compile-current-form
|
|
|
|
|
byte-compile-last-warned-form))))
|
2002-07-20 22:01:19 +00:00
|
|
|
|
(insert (format "\nIn %s:\n" form)))
|
2002-08-29 17:26:47 +00:00
|
|
|
|
(when level
|
|
|
|
|
(insert (format "%s%s" file pos))))
|
2000-10-23 09:16:47 +00:00
|
|
|
|
(setq byte-compile-last-logged-file byte-compile-current-file
|
2002-07-20 22:01:19 +00:00
|
|
|
|
byte-compile-last-warned-form byte-compile-current-form)
|
|
|
|
|
entry)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2002-08-29 17:26:47 +00:00
|
|
|
|
;; This no-op function is used as the value of warning-series
|
|
|
|
|
;; to tell inner calls to displaying-byte-compile-warnings
|
|
|
|
|
;; not to bind warning-series.
|
|
|
|
|
(defun byte-compile-warning-series (&rest ignore)
|
|
|
|
|
nil)
|
|
|
|
|
|
2007-11-19 00:10:38 +00:00
|
|
|
|
;; (compile-mode) will cause this to be loaded.
|
2007-12-06 04:05:51 +00:00
|
|
|
|
(declare-function compilation-forget-errors "compile" ())
|
2007-11-19 00:10:38 +00:00
|
|
|
|
|
1995-04-09 05:32:47 +00:00
|
|
|
|
;; Log the start of a file in *Compile-Log*, and mark it as done.
|
2002-07-20 22:01:19 +00:00
|
|
|
|
;; Return the position of the start of the page in the log buffer.
|
1995-04-09 05:32:47 +00:00
|
|
|
|
;; But do nothing in batch mode.
|
|
|
|
|
(defun byte-compile-log-file ()
|
2002-08-29 17:26:47 +00:00
|
|
|
|
(and (not (equal byte-compile-current-file byte-compile-last-logged-file))
|
2000-10-23 09:16:47 +00:00
|
|
|
|
(not noninteractive)
|
2007-08-22 15:51:13 +00:00
|
|
|
|
(with-current-buffer (get-buffer-create "*Compile-Log*")
|
1995-04-13 22:20:11 +00:00
|
|
|
|
(goto-char (point-max))
|
2004-10-16 15:20:24 +00:00
|
|
|
|
(let* ((inhibit-read-only t)
|
|
|
|
|
(dir (and byte-compile-current-file
|
2002-08-29 17:26:47 +00:00
|
|
|
|
(file-name-directory byte-compile-current-file)))
|
|
|
|
|
(was-same (equal default-directory dir))
|
|
|
|
|
pt)
|
|
|
|
|
(when dir
|
|
|
|
|
(unless was-same
|
|
|
|
|
(insert (format "Leaving directory `%s'\n" default-directory))))
|
|
|
|
|
(unless (bolp)
|
|
|
|
|
(insert "\n"))
|
|
|
|
|
(setq pt (point-marker))
|
|
|
|
|
(if byte-compile-current-file
|
|
|
|
|
(insert "\f\nCompiling "
|
|
|
|
|
(if (stringp byte-compile-current-file)
|
|
|
|
|
(concat "file " byte-compile-current-file)
|
|
|
|
|
(concat "buffer " (buffer-name byte-compile-current-file)))
|
|
|
|
|
" at " (current-time-string) "\n")
|
|
|
|
|
(insert "\f\nCompiling no file at " (current-time-string) "\n"))
|
|
|
|
|
(when dir
|
|
|
|
|
(setq default-directory dir)
|
|
|
|
|
(unless was-same
|
|
|
|
|
(insert (format "Entering directory `%s'\n" default-directory))))
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(setq byte-compile-last-logged-file byte-compile-current-file
|
|
|
|
|
byte-compile-last-warned-form nil)
|
2003-04-19 04:18:37 +00:00
|
|
|
|
;; Do this after setting default-directory.
|
2007-09-07 15:04:09 +00:00
|
|
|
|
(unless (derived-mode-p 'compilation-mode) (compilation-mode))
|
2004-05-19 18:53:13 +00:00
|
|
|
|
(compilation-forget-errors)
|
2002-07-20 22:01:19 +00:00
|
|
|
|
pt))))
|
|
|
|
|
|
|
|
|
|
;; Log a message STRING in *Compile-Log*.
|
|
|
|
|
;; Also log the current function and file if not already done.
|
|
|
|
|
(defun byte-compile-log-warning (string &optional fill level)
|
|
|
|
|
(let ((warning-prefix-function 'byte-compile-warning-prefix)
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(warning-type-format "")
|
2004-10-16 15:20:24 +00:00
|
|
|
|
(warning-fill-prefix (if fill " "))
|
|
|
|
|
(inhibit-read-only t))
|
2002-07-20 22:01:19 +00:00
|
|
|
|
(display-warning 'bytecomp string level "*Compile-Log*")))
|
1995-04-09 05:32:47 +00:00
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defun byte-compile-warn (format &rest args)
|
2002-07-20 22:01:19 +00:00
|
|
|
|
"Issue a byte compiler warning; use (format FORMAT ARGS...) for message."
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(setq format (apply 'format format args))
|
|
|
|
|
(if byte-compile-error-on-warn
|
|
|
|
|
(error "%s" format) ; byte-compile-file catches and logs it
|
2002-07-20 22:01:19 +00:00
|
|
|
|
(byte-compile-log-warning format t :warning)))
|
|
|
|
|
|
2008-04-26 02:32:51 +00:00
|
|
|
|
(defun byte-compile-warn-obsolete (symbol)
|
|
|
|
|
"Warn that SYMBOL (a variable or function) is obsolete."
|
|
|
|
|
(when (byte-compile-warning-enabled-p 'obsolete)
|
|
|
|
|
(let* ((funcp (get symbol 'byte-obsolete-info))
|
|
|
|
|
(obsolete (or funcp (get symbol 'byte-obsolete-variable)))
|
|
|
|
|
(instead (car obsolete))
|
|
|
|
|
(asof (if funcp (nth 2 obsolete) (cdr obsolete))))
|
|
|
|
|
(byte-compile-warn "`%s' is an obsolete %s%s%s" symbol
|
|
|
|
|
(if funcp "function" "variable")
|
|
|
|
|
(if asof (concat " (as of Emacs " asof ")") "")
|
|
|
|
|
(cond ((stringp instead)
|
|
|
|
|
(concat "; " instead))
|
|
|
|
|
(instead
|
|
|
|
|
(format "; use `%s' instead." instead))
|
|
|
|
|
(t "."))))))
|
|
|
|
|
|
1992-08-04 04:09:07 +00:00
|
|
|
|
(defun byte-compile-report-error (error-info)
|
2002-07-20 22:01:19 +00:00
|
|
|
|
"Report Lisp error in compilation. ERROR-INFO is the error data."
|
1992-09-13 19:05:13 +00:00
|
|
|
|
(setq byte-compiler-error-flag t)
|
2002-07-20 22:01:19 +00:00
|
|
|
|
(byte-compile-log-warning
|
|
|
|
|
(error-message-string error-info)
|
|
|
|
|
nil :error))
|
1992-08-04 04:09:07 +00:00
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;;; Used by make-obsolete.
|
|
|
|
|
(defun byte-compile-obsolete (form)
|
2008-04-26 02:32:51 +00:00
|
|
|
|
(byte-compile-set-symbol-position (car form))
|
|
|
|
|
(byte-compile-warn-obsolete (car form))
|
|
|
|
|
(funcall (or (cadr (get (car form) 'byte-obsolete-info)) ; handler
|
|
|
|
|
'byte-compile-normal-call) form))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;; Compiler options
|
|
|
|
|
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; (defvar byte-compiler-valid-options
|
|
|
|
|
;; '((optimize byte-optimize (t nil source byte) val)
|
|
|
|
|
;; (file-format byte-compile-compatibility (emacs18 emacs19)
|
|
|
|
|
;; (eq val 'emacs18))
|
|
|
|
|
;; ;; (new-bytecodes byte-compile-generate-emacs19-bytecodes (t nil) val)
|
|
|
|
|
;; (delete-errors byte-compile-delete-errors (t nil) val)
|
|
|
|
|
;; (verbose byte-compile-verbose (t nil) val)
|
|
|
|
|
;; (warnings byte-compile-warnings ((callargs redefine free-vars unresolved))
|
|
|
|
|
;; val)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;; Inhibit v18/v19 selectors if the version is hardcoded.
|
2000-03-29 21:32:57 +00:00
|
|
|
|
;; #### This should print a warning if the user tries to change something
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; than can't be changed because the running compiler doesn't support it.
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; (cond
|
|
|
|
|
;; ((byte-compile-single-version)
|
|
|
|
|
;; (setcar (cdr (cdr (assq 'new-bytecodes byte-compiler-valid-options)))
|
|
|
|
|
;; (list (byte-compile-version-cond
|
|
|
|
|
;; byte-compile-generate-emacs19-bytecodes)))
|
|
|
|
|
;; (setcar (cdr (cdr (assq 'file-format byte-compiler-valid-options)))
|
|
|
|
|
;; (if (byte-compile-version-cond byte-compile-compatibility)
|
|
|
|
|
;; '(emacs18) '(emacs19)))))
|
|
|
|
|
|
|
|
|
|
;; (defun byte-compiler-options-handler (&rest args)
|
|
|
|
|
;; (let (key val desc choices)
|
|
|
|
|
;; (while args
|
|
|
|
|
;; (if (or (atom (car args)) (nthcdr 2 (car args)) (null (cdr (car args))))
|
|
|
|
|
;; (error "Malformed byte-compiler option `%s'" (car args)))
|
|
|
|
|
;; (setq key (car (car args))
|
|
|
|
|
;; val (car (cdr (car args)))
|
|
|
|
|
;; desc (assq key byte-compiler-valid-options))
|
|
|
|
|
;; (or desc
|
|
|
|
|
;; (error "Unknown byte-compiler option `%s'" key))
|
|
|
|
|
;; (setq choices (nth 2 desc))
|
|
|
|
|
;; (if (consp (car choices))
|
|
|
|
|
;; (let (this
|
|
|
|
|
;; (handler 'cons)
|
|
|
|
|
;; (ret (and (memq (car val) '(+ -))
|
|
|
|
|
;; (copy-sequence (if (eq t (symbol-value (nth 1 desc)))
|
|
|
|
|
;; choices
|
|
|
|
|
;; (symbol-value (nth 1 desc)))))))
|
|
|
|
|
;; (setq choices (car choices))
|
|
|
|
|
;; (while val
|
|
|
|
|
;; (setq this (car val))
|
|
|
|
|
;; (cond ((memq this choices)
|
|
|
|
|
;; (setq ret (funcall handler this ret)))
|
|
|
|
|
;; ((eq this '+) (setq handler 'cons))
|
|
|
|
|
;; ((eq this '-) (setq handler 'delq))
|
|
|
|
|
;; ((error "`%s' only accepts %s" key choices)))
|
|
|
|
|
;; (setq val (cdr val)))
|
|
|
|
|
;; (set (nth 1 desc) ret))
|
|
|
|
|
;; (or (memq val choices)
|
|
|
|
|
;; (error "`%s' must be one of `%s'" key choices))
|
|
|
|
|
;; (set (nth 1 desc) (eval (nth 3 desc))))
|
|
|
|
|
;; (setq args (cdr args)))
|
|
|
|
|
;; nil))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;;; sanity-checking arglists
|
|
|
|
|
|
2004-11-09 10:33:23 +00:00
|
|
|
|
;; If a function has an entry saying (FUNCTION . t).
|
|
|
|
|
;; that means we know it is defined but we don't know how.
|
|
|
|
|
;; If a function has an entry saying (FUNCTION . nil),
|
|
|
|
|
;; that means treat it as not defined.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defun byte-compile-fdefinition (name macro-p)
|
|
|
|
|
(let* ((list (if macro-p
|
|
|
|
|
byte-compile-macro-environment
|
1994-06-29 18:06:09 +00:00
|
|
|
|
byte-compile-function-environment))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(env (cdr (assq name list))))
|
|
|
|
|
(or env
|
|
|
|
|
(let ((fn name))
|
|
|
|
|
(while (and (symbolp fn)
|
|
|
|
|
(fboundp fn)
|
|
|
|
|
(or (symbolp (symbol-function fn))
|
|
|
|
|
(consp (symbol-function fn))
|
|
|
|
|
(and (not macro-p)
|
* disass.el (disassemble): Add autoload cookie for this.
* bytecomp.el (byte-decompile-bytecode): Add an autoload for this.
compiled-function-p has been renamed to byte-code-function-p.
* subr.el: Define compiled-function-p as an alias for it.
* bytecomp.el: Register compiled-function-p as obsolete.
* bytecomp.el, byte-opt.el, disass.el, help.el, map-ynp.el: Change
uses.
unread-command-event has been replaced by unread-command-events.
* simple.el (prefix-arg-internal): Use this to push back all
key sequences for processing by the main command loop, instead of
trying to simulate its behavior ourselves.
* bytecomp.el: Document unread-command-event as an obsolete
variable, although nothing but the GNU Emacs 19 sources use it.
Adjust obsolescence message for unread-command-char.
* comint.el (comint-dynamic-list-completions): Change uses of
unread-command-event to work with unread-command-events.
* ebuff-menu.el (electric-buffer-list, Electric-buffer-menu-exit):
Same.
* edebug.el (edebug-outside-excursion): Same.
* ehelp.el (electric-help-command-loop): Same.
* electric.el (Electric-command-loop): Same.
* emerge.el (emerge-show-file-name): Same.
* fortran.el (fortran-abbrev-start,
fortran-window-create-momentarily): Same.
* gnus.el (gnus-Subject-next-article): Same.
* info.el (Info-summary): Same.
* isearch-mode.el (isearch-update, isearch-unread): Same.
* map-ynp.el (map-y-or-n-p): Same.
* mlsupport.el (push-back-character): Same.
* replace.el (perform-replace): Same.
* simula.el (simula-electric-label): Same.
* subr.el (read-quoted-char, momentary-string-display): Same.
* sun-mouse.el (mouse-second-hit): Same.
* terminal.el (te-escape-extended-command-unread): Same.
* vip.el (vip-escape-to-emacs, vip-prefix-arg-value,
vip-prefix-arg-com): Same.
1993-01-26 01:36:02 +00:00
|
|
|
|
(byte-code-function-p (symbol-function fn)))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(setq fn (symbol-function fn)))
|
* disass.el (disassemble): Add autoload cookie for this.
* bytecomp.el (byte-decompile-bytecode): Add an autoload for this.
compiled-function-p has been renamed to byte-code-function-p.
* subr.el: Define compiled-function-p as an alias for it.
* bytecomp.el: Register compiled-function-p as obsolete.
* bytecomp.el, byte-opt.el, disass.el, help.el, map-ynp.el: Change
uses.
unread-command-event has been replaced by unread-command-events.
* simple.el (prefix-arg-internal): Use this to push back all
key sequences for processing by the main command loop, instead of
trying to simulate its behavior ourselves.
* bytecomp.el: Document unread-command-event as an obsolete
variable, although nothing but the GNU Emacs 19 sources use it.
Adjust obsolescence message for unread-command-char.
* comint.el (comint-dynamic-list-completions): Change uses of
unread-command-event to work with unread-command-events.
* ebuff-menu.el (electric-buffer-list, Electric-buffer-menu-exit):
Same.
* edebug.el (edebug-outside-excursion): Same.
* ehelp.el (electric-help-command-loop): Same.
* electric.el (Electric-command-loop): Same.
* emerge.el (emerge-show-file-name): Same.
* fortran.el (fortran-abbrev-start,
fortran-window-create-momentarily): Same.
* gnus.el (gnus-Subject-next-article): Same.
* info.el (Info-summary): Same.
* isearch-mode.el (isearch-update, isearch-unread): Same.
* map-ynp.el (map-y-or-n-p): Same.
* mlsupport.el (push-back-character): Same.
* replace.el (perform-replace): Same.
* simula.el (simula-electric-label): Same.
* subr.el (read-quoted-char, momentary-string-display): Same.
* sun-mouse.el (mouse-second-hit): Same.
* terminal.el (te-escape-extended-command-unread): Same.
* vip.el (vip-escape-to-emacs, vip-prefix-arg-value,
vip-prefix-arg-com): Same.
1993-01-26 01:36:02 +00:00
|
|
|
|
(if (and (not macro-p) (byte-code-function-p fn))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
fn
|
|
|
|
|
(and (consp fn)
|
|
|
|
|
(if (eq 'macro (car fn))
|
|
|
|
|
(cdr fn)
|
|
|
|
|
(if macro-p
|
|
|
|
|
nil
|
|
|
|
|
(if (eq 'autoload (car fn))
|
|
|
|
|
nil
|
|
|
|
|
fn)))))))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-arglist-signature (arglist)
|
|
|
|
|
(let ((args 0)
|
|
|
|
|
opts
|
|
|
|
|
restp)
|
|
|
|
|
(while arglist
|
|
|
|
|
(cond ((eq (car arglist) '&optional)
|
|
|
|
|
(or opts (setq opts 0)))
|
|
|
|
|
((eq (car arglist) '&rest)
|
|
|
|
|
(if (cdr arglist)
|
|
|
|
|
(setq restp t
|
|
|
|
|
arglist nil)))
|
|
|
|
|
(t
|
|
|
|
|
(if opts
|
|
|
|
|
(setq opts (1+ opts))
|
|
|
|
|
(setq args (1+ args)))))
|
|
|
|
|
(setq arglist (cdr arglist)))
|
|
|
|
|
(cons args (if restp nil (if opts (+ args opts) args)))))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-arglist-signatures-congruent-p (old new)
|
|
|
|
|
(not (or
|
|
|
|
|
(> (car new) (car old)) ; requires more args now
|
1996-01-05 22:21:28 +00:00
|
|
|
|
(and (null (cdr old)) ; took rest-args, doesn't any more
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(cdr new))
|
|
|
|
|
(and (cdr new) (cdr old) ; can't take as many args now
|
|
|
|
|
(< (cdr new) (cdr old)))
|
|
|
|
|
)))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-arglist-signature-string (signature)
|
|
|
|
|
(cond ((null (cdr signature))
|
|
|
|
|
(format "%d+" (car signature)))
|
|
|
|
|
((= (car signature) (cdr signature))
|
|
|
|
|
(format "%d" (car signature)))
|
|
|
|
|
(t (format "%d-%d" (car signature) (cdr signature)))))
|
|
|
|
|
|
|
|
|
|
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; Warn if the form is calling a function with the wrong number of arguments.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defun byte-compile-callargs-warn (form)
|
|
|
|
|
(let* ((def (or (byte-compile-fdefinition (car form) nil)
|
|
|
|
|
(byte-compile-fdefinition (car form) t)))
|
2004-11-09 10:33:23 +00:00
|
|
|
|
(sig (if (and def (not (eq def t)))
|
2000-05-26 10:35:38 +00:00
|
|
|
|
(byte-compile-arglist-signature
|
2007-11-17 03:46:23 +00:00
|
|
|
|
(if (memq (car-safe def) '(declared lambda))
|
2000-05-26 10:35:38 +00:00
|
|
|
|
(nth 1 def)
|
|
|
|
|
(if (byte-code-function-p def)
|
|
|
|
|
(aref def 0)
|
|
|
|
|
'(&rest def))))
|
|
|
|
|
(if (and (fboundp (car form))
|
|
|
|
|
(subrp (symbol-function (car form))))
|
|
|
|
|
(subr-arity (symbol-function (car form))))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(ncall (length (cdr form))))
|
2000-05-26 10:35:38 +00:00
|
|
|
|
;; Check many or unevalled from subr-arity.
|
|
|
|
|
(if (and (cdr-safe sig)
|
|
|
|
|
(not (numberp (cdr sig))))
|
|
|
|
|
(setcdr sig nil))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(if sig
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(when (or (< ncall (car sig))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(and (cdr sig) (> ncall (cdr sig))))
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(byte-compile-set-symbol-position (car form))
|
|
|
|
|
(byte-compile-warn
|
|
|
|
|
"%s called with %d argument%s, but %s %s"
|
|
|
|
|
(car form) ncall
|
|
|
|
|
(if (= 1 ncall) "" "s")
|
|
|
|
|
(if (< ncall (car sig))
|
|
|
|
|
"requires"
|
|
|
|
|
"accepts only")
|
2002-06-25 01:09:52 +00:00
|
|
|
|
(byte-compile-arglist-signature-string sig))))
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(byte-compile-format-warn form)
|
2002-06-25 01:09:52 +00:00
|
|
|
|
;; Check to see if the function will be available at runtime
|
|
|
|
|
;; and/or remember its arity if it's unknown.
|
2004-11-09 10:33:23 +00:00
|
|
|
|
(or (and (or def (fboundp (car form))) ; might be a subr or autoload.
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(not (memq (car form) byte-compile-noruntime-functions)))
|
2002-06-25 01:09:52 +00:00
|
|
|
|
(eq (car form) byte-compile-current-form) ; ## this doesn't work
|
|
|
|
|
; with recursion.
|
|
|
|
|
;; It's a currently-undefined function.
|
|
|
|
|
;; Remember number of args in call.
|
|
|
|
|
(let ((cons (assq (car form) byte-compile-unresolved-functions))
|
|
|
|
|
(n (length (cdr form))))
|
|
|
|
|
(if cons
|
|
|
|
|
(or (memq n (cdr cons))
|
|
|
|
|
(setcdr cons (cons n (cdr cons))))
|
2004-11-11 22:44:46 +00:00
|
|
|
|
(push (list (car form) n)
|
|
|
|
|
byte-compile-unresolved-functions))))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(defun byte-compile-format-warn (form)
|
|
|
|
|
"Warn if FORM is `format'-like with inconsistent args.
|
|
|
|
|
Applies if head of FORM is a symbol with non-nil property
|
|
|
|
|
`byte-compile-format-like' and first arg is a constant string.
|
|
|
|
|
Then check the number of format fields matches the number of
|
|
|
|
|
extra args."
|
|
|
|
|
(when (and (symbolp (car form))
|
|
|
|
|
(stringp (nth 1 form))
|
|
|
|
|
(get (car form) 'byte-compile-format-like))
|
|
|
|
|
(let ((nfields (with-temp-buffer
|
|
|
|
|
(insert (nth 1 form))
|
2007-06-12 21:03:32 +00:00
|
|
|
|
(goto-char (point-min))
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(let ((n 0))
|
|
|
|
|
(while (re-search-forward "%." nil t)
|
|
|
|
|
(unless (eq ?% (char-after (1+ (match-beginning 0))))
|
|
|
|
|
(setq n (1+ n))))
|
|
|
|
|
n)))
|
|
|
|
|
(nargs (- (length form) 2)))
|
|
|
|
|
(unless (= nargs nfields)
|
|
|
|
|
(byte-compile-warn
|
|
|
|
|
"`%s' called with %d args to fill %d format field(s)" (car form)
|
|
|
|
|
nargs nfields)))))
|
|
|
|
|
|
|
|
|
|
(dolist (elt '(format message error))
|
|
|
|
|
(put elt 'byte-compile-format-like t))
|
|
|
|
|
|
2005-05-14 12:30:08 +00:00
|
|
|
|
;; Warn if a custom definition fails to specify :group.
|
|
|
|
|
(defun byte-compile-nogroup-warn (form)
|
2008-06-08 02:07:25 +00:00
|
|
|
|
(if (and (memq (car form) '(custom-declare-face custom-declare-variable))
|
|
|
|
|
byte-compile-current-group)
|
|
|
|
|
;; The group will be provided implicitly.
|
|
|
|
|
nil
|
|
|
|
|
(let ((keyword-args (cdr (cdr (cdr (cdr form)))))
|
|
|
|
|
(name (cadr form)))
|
|
|
|
|
(or (not (eq (car-safe name) 'quote))
|
2007-06-14 21:25:12 +00:00
|
|
|
|
(and (eq (car form) 'custom-declare-group)
|
|
|
|
|
(equal name ''emacs))
|
|
|
|
|
(plist-get keyword-args :group)
|
|
|
|
|
(not (and (consp name) (eq (car name) 'quote)))
|
|
|
|
|
(byte-compile-warn
|
|
|
|
|
"%s for `%s' fails to specify containing group"
|
|
|
|
|
(cdr (assq (car form)
|
2008-06-08 02:07:25 +00:00
|
|
|
|
'((custom-declare-group . defgroup)
|
|
|
|
|
(custom-declare-face . defface)
|
|
|
|
|
(custom-declare-variable . defcustom))))
|
|
|
|
|
(cadr name)))
|
|
|
|
|
;; Update the current group, if needed.
|
|
|
|
|
(if (and byte-compile-current-file ;Only when byte-compiling a whole file.
|
|
|
|
|
(eq (car form) 'custom-declare-group)
|
|
|
|
|
(eq (car-safe name) 'quote))
|
|
|
|
|
(setq byte-compile-current-group (cadr name))))))
|
2005-05-14 12:30:08 +00:00
|
|
|
|
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; Warn if the function or macro is being redefined with a different
|
|
|
|
|
;; number of arguments.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defun byte-compile-arglist-warn (form macrop)
|
|
|
|
|
(let ((old (byte-compile-fdefinition (nth 1 form) macrop)))
|
2004-11-09 10:33:23 +00:00
|
|
|
|
(if (and old (not (eq old t)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(let ((sig1 (byte-compile-arglist-signature
|
|
|
|
|
(if (eq 'lambda (car-safe old))
|
|
|
|
|
(nth 1 old)
|
1994-12-24 05:58:05 +00:00
|
|
|
|
(if (byte-code-function-p old)
|
1994-06-29 18:06:09 +00:00
|
|
|
|
(aref old 0)
|
|
|
|
|
'(&rest def)))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(sig2 (byte-compile-arglist-signature (nth 2 form))))
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(unless (byte-compile-arglist-signatures-congruent-p sig1 sig2)
|
|
|
|
|
(byte-compile-set-symbol-position (nth 1 form))
|
|
|
|
|
(byte-compile-warn
|
|
|
|
|
"%s %s used to take %s %s, now takes %s"
|
|
|
|
|
(if (eq (car form) 'defun) "function" "macro")
|
|
|
|
|
(nth 1 form)
|
|
|
|
|
(byte-compile-arglist-signature-string sig1)
|
|
|
|
|
(if (equal sig1 '(1 . 1)) "argument" "arguments")
|
|
|
|
|
(byte-compile-arglist-signature-string sig2))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; This is the first definition. See if previous calls are compatible.
|
|
|
|
|
(let ((calls (assq (nth 1 form) byte-compile-unresolved-functions))
|
|
|
|
|
nums sig min max)
|
|
|
|
|
(if calls
|
|
|
|
|
(progn
|
|
|
|
|
(setq sig (byte-compile-arglist-signature (nth 2 form))
|
|
|
|
|
nums (sort (copy-sequence (cdr calls)) (function <))
|
|
|
|
|
min (car nums)
|
|
|
|
|
max (car (nreverse nums)))
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(when (or (< min (car sig))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(and (cdr sig) (> max (cdr sig))))
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(byte-compile-set-symbol-position (nth 1 form))
|
|
|
|
|
(byte-compile-warn
|
|
|
|
|
"%s being defined to take %s%s, but was previously called with %s"
|
|
|
|
|
(nth 1 form)
|
|
|
|
|
(byte-compile-arglist-signature-string sig)
|
|
|
|
|
(if (equal sig '(1 . 1)) " arg" " args")
|
|
|
|
|
(byte-compile-arglist-signature-string (cons min max))))
|
2001-10-18 21:05:16 +00:00
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(setq byte-compile-unresolved-functions
|
|
|
|
|
(delq calls byte-compile-unresolved-functions)))))
|
|
|
|
|
)))
|
|
|
|
|
|
2002-07-24 03:58:02 +00:00
|
|
|
|
(defvar byte-compile-cl-functions nil
|
|
|
|
|
"List of functions defined in CL.")
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-find-cl-functions ()
|
|
|
|
|
(unless byte-compile-cl-functions
|
|
|
|
|
(dolist (elt load-history)
|
2002-07-31 22:05:16 +00:00
|
|
|
|
(when (and (stringp (car elt))
|
2007-06-10 16:15:10 +00:00
|
|
|
|
(string-match
|
|
|
|
|
"^cl\\>" (file-name-nondirectory (car elt))))
|
2008-04-27 01:17:03 +00:00
|
|
|
|
(dolist (e (cdr elt))
|
|
|
|
|
(when (memq (car-safe e) '(autoload defun))
|
|
|
|
|
(push (cdr e) byte-compile-cl-functions)))))))
|
2002-07-24 03:58:02 +00:00
|
|
|
|
|
2002-07-02 18:48:34 +00:00
|
|
|
|
(defun byte-compile-cl-warn (form)
|
|
|
|
|
"Warn if FORM is a call of a function from the CL package."
|
2002-07-24 03:58:02 +00:00
|
|
|
|
(let ((func (car-safe form)))
|
|
|
|
|
(if (and byte-compile-cl-functions
|
|
|
|
|
(memq func byte-compile-cl-functions)
|
2004-04-16 12:51:06 +00:00
|
|
|
|
;; Aliases which won't have been expanded at this point.
|
2002-07-02 18:48:34 +00:00
|
|
|
|
;; These aren't all aliases of subrs, so not trivial to
|
|
|
|
|
;; avoid hardwiring the list.
|
|
|
|
|
(not (memq func
|
2002-07-19 23:01:24 +00:00
|
|
|
|
'(cl-block-wrapper cl-block-throw
|
|
|
|
|
multiple-value-call nth-value
|
2002-07-24 03:58:02 +00:00
|
|
|
|
copy-seq first second rest endp cl-member
|
2002-12-07 21:33:19 +00:00
|
|
|
|
;; These are included in generated code
|
|
|
|
|
;; that can't be called except at compile time
|
|
|
|
|
;; or unless cl is loaded anyway.
|
|
|
|
|
cl-defsubst-expand cl-struct-setf-expander
|
2002-08-29 14:49:48 +00:00
|
|
|
|
;; These would sometimes be warned about
|
|
|
|
|
;; but such warnings are never useful,
|
|
|
|
|
;; so don't warn about them.
|
2003-04-28 22:05:17 +00:00
|
|
|
|
macroexpand cl-macroexpand-all
|
|
|
|
|
cl-compiling-file)))
|
|
|
|
|
;; Avoid warnings for things which are safe because they
|
|
|
|
|
;; have suitable compiler macros, but those aren't
|
|
|
|
|
;; expanded at this stage. There should probably be more
|
|
|
|
|
;; here than caaar and friends.
|
|
|
|
|
(not (and (eq (get func 'byte-compile)
|
|
|
|
|
'cl-byte-compile-compiler-macro)
|
2003-04-29 02:56:25 +00:00
|
|
|
|
(string-match "\\`c[ad]+r\\'" (symbol-name func)))))
|
2002-07-02 18:48:34 +00:00
|
|
|
|
(byte-compile-warn "Function `%s' from cl package called at runtime"
|
|
|
|
|
func)))
|
|
|
|
|
form)
|
|
|
|
|
|
2000-03-24 18:37:48 +00:00
|
|
|
|
(defun byte-compile-print-syms (str1 strn syms)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(when syms
|
|
|
|
|
(byte-compile-set-symbol-position (car syms) t))
|
2001-10-11 12:57:18 +00:00
|
|
|
|
(cond ((and (cdr syms) (not noninteractive))
|
|
|
|
|
(let* ((str strn)
|
|
|
|
|
(L (length str))
|
|
|
|
|
s)
|
|
|
|
|
(while syms
|
|
|
|
|
(setq s (symbol-name (pop syms))
|
|
|
|
|
L (+ L (length s) 2))
|
|
|
|
|
(if (< L (1- fill-column))
|
|
|
|
|
(setq str (concat str " " s (and syms ",")))
|
|
|
|
|
(setq str (concat str "\n " s (and syms ","))
|
|
|
|
|
L (+ (length s) 4))))
|
|
|
|
|
(byte-compile-warn "%s" str)))
|
|
|
|
|
((cdr syms)
|
2001-10-18 21:05:16 +00:00
|
|
|
|
(byte-compile-warn "%s %s"
|
2001-10-11 12:57:18 +00:00
|
|
|
|
strn
|
|
|
|
|
(mapconcat #'symbol-name syms ", ")))
|
|
|
|
|
|
|
|
|
|
(syms
|
|
|
|
|
(byte-compile-warn str1 (car syms)))))
|
2000-03-24 18:37:48 +00:00
|
|
|
|
|
2001-10-18 21:05:16 +00:00
|
|
|
|
;; If we have compiled any calls to functions which are not known to be
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; defined, issue a warning enumerating them.
|
|
|
|
|
;; `unresolved' in the list `byte-compile-warnings' disables this.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defun byte-compile-warn-about-unresolved-functions ()
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(when (byte-compile-warning-enabled-p 'unresolved)
|
2001-10-11 12:57:18 +00:00
|
|
|
|
(let ((byte-compile-current-form :end)
|
2000-03-24 18:37:48 +00:00
|
|
|
|
(noruntime nil)
|
|
|
|
|
(unresolved nil))
|
|
|
|
|
;; Separate the functions that will not be available at runtime
|
|
|
|
|
;; from the truly unresolved ones.
|
|
|
|
|
(dolist (f byte-compile-unresolved-functions)
|
|
|
|
|
(setq f (car f))
|
|
|
|
|
(if (fboundp f) (push f noruntime) (push f unresolved)))
|
|
|
|
|
;; Complain about the no-run-time functions
|
|
|
|
|
(byte-compile-print-syms
|
2001-10-11 12:57:18 +00:00
|
|
|
|
"the function `%s' might not be defined at runtime."
|
|
|
|
|
"the following functions might not be defined at runtime:"
|
2000-03-24 18:37:48 +00:00
|
|
|
|
noruntime)
|
|
|
|
|
;; Complain about the unresolved functions
|
|
|
|
|
(byte-compile-print-syms
|
2001-10-11 12:57:18 +00:00
|
|
|
|
"the function `%s' is not known to be defined."
|
|
|
|
|
"the following functions are not known to be defined:"
|
2000-03-24 18:37:48 +00:00
|
|
|
|
unresolved)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
nil)
|
|
|
|
|
|
|
|
|
|
|
2003-04-16 20:10:33 +00:00
|
|
|
|
(defsubst byte-compile-const-symbol-p (symbol &optional any-value)
|
2003-04-12 20:28:10 +00:00
|
|
|
|
"Non-nil if SYMBOL is constant.
|
2003-04-16 20:10:33 +00:00
|
|
|
|
If ANY-VALUE is nil, only return non-nil if the value of the symbol is the
|
2003-04-12 20:28:10 +00:00
|
|
|
|
symbol itself."
|
2000-02-23 12:29:05 +00:00
|
|
|
|
(or (memq symbol '(nil t))
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(keywordp symbol)
|
2009-08-29 14:44:45 +00:00
|
|
|
|
(if any-value
|
|
|
|
|
(or (memq symbol byte-compile-const-variables)
|
|
|
|
|
;; FIXME: We should provide a less intrusive way to find out
|
|
|
|
|
;; is a variable is "constant".
|
|
|
|
|
(and (boundp symbol)
|
|
|
|
|
(condition-case nil
|
|
|
|
|
(progn (set symbol (symbol-value symbol)) nil)
|
|
|
|
|
(setting-constant t)))))))
|
2000-02-23 12:29:05 +00:00
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defmacro byte-compile-constp (form)
|
2000-03-29 21:32:57 +00:00
|
|
|
|
"Return non-nil if FORM is a constant."
|
2000-02-23 12:29:05 +00:00
|
|
|
|
`(cond ((consp ,form) (eq (car ,form) 'quote))
|
|
|
|
|
((not (symbolp ,form)))
|
|
|
|
|
((byte-compile-const-symbol-p ,form))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
(defmacro byte-compile-close-variables (&rest body)
|
|
|
|
|
(cons 'let
|
|
|
|
|
(cons '(;;
|
|
|
|
|
;; Close over these variables to encapsulate the
|
|
|
|
|
;; compilation state
|
|
|
|
|
;;
|
|
|
|
|
(byte-compile-macro-environment
|
|
|
|
|
;; Copy it because the compiler may patch into the
|
|
|
|
|
;; macroenvironment.
|
|
|
|
|
(copy-alist byte-compile-initial-macro-environment))
|
|
|
|
|
(byte-compile-function-environment nil)
|
|
|
|
|
(byte-compile-bound-variables nil)
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(byte-compile-const-variables nil)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-free-references nil)
|
|
|
|
|
(byte-compile-free-assignments nil)
|
|
|
|
|
;;
|
|
|
|
|
;; Close over these variables so that `byte-compiler-options'
|
|
|
|
|
;; can change them on a per-file basis.
|
|
|
|
|
;;
|
|
|
|
|
(byte-compile-verbose byte-compile-verbose)
|
|
|
|
|
(byte-optimize byte-optimize)
|
1994-12-24 05:58:05 +00:00
|
|
|
|
(byte-compile-compatibility byte-compile-compatibility)
|
|
|
|
|
(byte-compile-dynamic byte-compile-dynamic)
|
|
|
|
|
(byte-compile-dynamic-docstrings
|
|
|
|
|
byte-compile-dynamic-docstrings)
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; (byte-compile-generate-emacs19-bytecodes
|
|
|
|
|
;; byte-compile-generate-emacs19-bytecodes)
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(byte-compile-warnings byte-compile-warnings)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
)
|
|
|
|
|
body)))
|
|
|
|
|
|
|
|
|
|
(defmacro displaying-byte-compile-warnings (&rest body)
|
2002-08-29 17:26:47 +00:00
|
|
|
|
`(let* ((--displaying-byte-compile-warnings-fn (lambda () ,@body))
|
|
|
|
|
(warning-series-started
|
|
|
|
|
(and (markerp warning-series)
|
|
|
|
|
(eq (marker-buffer warning-series)
|
|
|
|
|
(get-buffer "*Compile-Log*")))))
|
2002-07-24 03:58:02 +00:00
|
|
|
|
(byte-compile-find-cl-functions)
|
2002-08-29 17:26:47 +00:00
|
|
|
|
(if (or (eq warning-series 'byte-compile-warning-series)
|
|
|
|
|
warning-series-started)
|
|
|
|
|
;; warning-series does come from compilation,
|
|
|
|
|
;; so don't bind it, but maybe do set it.
|
|
|
|
|
(let (tem)
|
|
|
|
|
;; Log the file name. Record position of that text.
|
|
|
|
|
(setq tem (byte-compile-log-file))
|
|
|
|
|
(unless warning-series-started
|
|
|
|
|
(setq warning-series (or tem 'byte-compile-warning-series)))
|
|
|
|
|
(if byte-compile-debug
|
|
|
|
|
(funcall --displaying-byte-compile-warnings-fn)
|
|
|
|
|
(condition-case error-info
|
|
|
|
|
(funcall --displaying-byte-compile-warnings-fn)
|
|
|
|
|
(error (byte-compile-report-error error-info)))))
|
|
|
|
|
;; warning-series does not come from compilation, so bind it.
|
|
|
|
|
(let ((warning-series
|
|
|
|
|
;; Log the file name. Record position of that text.
|
|
|
|
|
(or (byte-compile-log-file) 'byte-compile-warning-series)))
|
|
|
|
|
(if byte-compile-debug
|
2002-07-20 22:01:19 +00:00
|
|
|
|
(funcall --displaying-byte-compile-warnings-fn)
|
2002-08-29 17:26:47 +00:00
|
|
|
|
(condition-case error-info
|
|
|
|
|
(funcall --displaying-byte-compile-warnings-fn)
|
|
|
|
|
(error (byte-compile-report-error error-info))))))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
1992-07-19 01:07:07 +00:00
|
|
|
|
;;;###autoload
|
1995-10-30 18:01:22 +00:00
|
|
|
|
(defun byte-force-recompile (directory)
|
|
|
|
|
"Recompile every `.el' file in DIRECTORY that already has a `.elc' file.
|
|
|
|
|
Files in subdirectories of DIRECTORY are processed also."
|
1995-11-10 17:16:57 +00:00
|
|
|
|
(interactive "DByte force recompile (directory): ")
|
1995-10-30 18:01:22 +00:00
|
|
|
|
(byte-recompile-directory directory nil t))
|
|
|
|
|
|
2008-03-01 21:11:37 +00:00
|
|
|
|
;; The `bytecomp-' prefix is applied to all local variables with
|
|
|
|
|
;; otherwise common names in this and similar functions for the sake
|
|
|
|
|
;; of the boundp test in byte-compile-variable-ref.
|
|
|
|
|
;; http://lists.gnu.org/archive/html/emacs-devel/2008-01/msg00237.html
|
|
|
|
|
;; http://lists.gnu.org/archive/html/bug-gnu-emacs/2008-02/msg00134.html
|
1995-10-30 18:01:22 +00:00
|
|
|
|
;;;###autoload
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(defun byte-recompile-directory (bytecomp-directory &optional bytecomp-arg
|
|
|
|
|
bytecomp-force)
|
|
|
|
|
"Recompile every `.el' file in BYTECOMP-DIRECTORY that needs recompilation.
|
2008-11-20 12:13:49 +00:00
|
|
|
|
This happens when a `.elc' file exists but is older than the `.el' file.
|
2008-03-01 21:11:37 +00:00
|
|
|
|
Files in subdirectories of BYTECOMP-DIRECTORY are processed also.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2002-06-15 20:37:01 +00:00
|
|
|
|
If the `.elc' file does not exist, normally this function *does not*
|
2008-03-01 21:11:37 +00:00
|
|
|
|
compile the corresponding `.el' file. However, if the prefix argument
|
|
|
|
|
BYTECOMP-ARG is 0, that means do compile all those files. A nonzero
|
|
|
|
|
BYTECOMP-ARG means ask the user, for each such `.el' file, whether to
|
|
|
|
|
compile it. A nonzero BYTECOMP-ARG also means ask about each subdirectory
|
|
|
|
|
before scanning it.
|
|
|
|
|
|
|
|
|
|
If the third argument BYTECOMP-FORCE is non-nil, recompile every `.el' file
|
|
|
|
|
that already has a `.elc' file."
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(interactive "DByte recompile directory: \nP")
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(if bytecomp-arg
|
|
|
|
|
(setq bytecomp-arg (prefix-numeric-value bytecomp-arg)))
|
1993-06-11 16:19:49 +00:00
|
|
|
|
(if noninteractive
|
|
|
|
|
nil
|
|
|
|
|
(save-some-buffers)
|
1995-04-25 22:32:49 +00:00
|
|
|
|
(force-mode-line-update))
|
2007-08-22 15:51:13 +00:00
|
|
|
|
(with-current-buffer (get-buffer-create "*Compile-Log*")
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(setq default-directory (expand-file-name bytecomp-directory))
|
2003-04-19 04:18:37 +00:00
|
|
|
|
;; compilation-mode copies value of default-directory.
|
|
|
|
|
(unless (eq major-mode 'compilation-mode)
|
|
|
|
|
(compilation-mode))
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(let ((bytecomp-directories (list default-directory))
|
2002-09-09 19:35:57 +00:00
|
|
|
|
(default-directory default-directory)
|
|
|
|
|
(skip-count 0)
|
|
|
|
|
(fail-count 0)
|
|
|
|
|
(file-count 0)
|
|
|
|
|
(dir-count 0)
|
|
|
|
|
last-dir)
|
|
|
|
|
(displaying-byte-compile-warnings
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(while bytecomp-directories
|
|
|
|
|
(setq bytecomp-directory (car bytecomp-directories))
|
|
|
|
|
(message "Checking %s..." bytecomp-directory)
|
|
|
|
|
(let ((bytecomp-files (directory-files bytecomp-directory))
|
|
|
|
|
bytecomp-source bytecomp-dest)
|
|
|
|
|
(dolist (bytecomp-file bytecomp-files)
|
|
|
|
|
(setq bytecomp-source
|
|
|
|
|
(expand-file-name bytecomp-file bytecomp-directory))
|
|
|
|
|
(if (and (not (member bytecomp-file '("RCS" "CVS")))
|
|
|
|
|
(not (eq ?\. (aref bytecomp-file 0)))
|
|
|
|
|
(file-directory-p bytecomp-source)
|
|
|
|
|
(not (file-symlink-p bytecomp-source)))
|
2002-09-09 19:35:57 +00:00
|
|
|
|
;; This file is a subdirectory. Handle them differently.
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(when (or (null bytecomp-arg)
|
|
|
|
|
(eq 0 bytecomp-arg)
|
|
|
|
|
(y-or-n-p (concat "Check " bytecomp-source "? ")))
|
|
|
|
|
(setq bytecomp-directories
|
|
|
|
|
(nconc bytecomp-directories (list bytecomp-source))))
|
2002-09-09 19:35:57 +00:00
|
|
|
|
;; It is an ordinary file. Decide whether to compile it.
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(if (and (string-match emacs-lisp-file-regexp bytecomp-source)
|
|
|
|
|
(file-readable-p bytecomp-source)
|
|
|
|
|
(not (auto-save-file-name-p bytecomp-source))
|
|
|
|
|
(setq bytecomp-dest
|
|
|
|
|
(byte-compile-dest-file bytecomp-source))
|
|
|
|
|
(if (file-exists-p bytecomp-dest)
|
2002-09-09 19:35:57 +00:00
|
|
|
|
;; File was already compiled.
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(or bytecomp-force
|
|
|
|
|
(file-newer-than-file-p bytecomp-source
|
|
|
|
|
bytecomp-dest))
|
2002-09-09 19:35:57 +00:00
|
|
|
|
;; No compiled file exists yet.
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(and bytecomp-arg
|
|
|
|
|
(or (eq 0 bytecomp-arg)
|
|
|
|
|
(y-or-n-p (concat "Compile "
|
|
|
|
|
bytecomp-source "? "))))))
|
2002-09-09 19:35:57 +00:00
|
|
|
|
(progn (if (and noninteractive (not byte-compile-verbose))
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(message "Compiling %s..." bytecomp-source))
|
|
|
|
|
(let ((bytecomp-res (byte-compile-file
|
|
|
|
|
bytecomp-source)))
|
|
|
|
|
(cond ((eq bytecomp-res 'no-byte-compile)
|
2002-09-09 19:35:57 +00:00
|
|
|
|
(setq skip-count (1+ skip-count)))
|
2008-03-01 21:11:37 +00:00
|
|
|
|
((eq bytecomp-res t)
|
2002-09-09 19:35:57 +00:00
|
|
|
|
(setq file-count (1+ file-count)))
|
2008-03-01 21:11:37 +00:00
|
|
|
|
((eq bytecomp-res nil)
|
2002-09-09 19:35:57 +00:00
|
|
|
|
(setq fail-count (1+ fail-count)))))
|
|
|
|
|
(or noninteractive
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(message "Checking %s..." bytecomp-directory))
|
|
|
|
|
(if (not (eq last-dir bytecomp-directory))
|
|
|
|
|
(setq last-dir bytecomp-directory
|
2002-09-09 19:35:57 +00:00
|
|
|
|
dir-count (1+ dir-count)))
|
|
|
|
|
)))))
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(setq bytecomp-directories (cdr bytecomp-directories))))
|
2002-09-09 19:35:57 +00:00
|
|
|
|
(message "Done (Total of %d file%s compiled%s%s%s)"
|
|
|
|
|
file-count (if (= file-count 1) "" "s")
|
|
|
|
|
(if (> fail-count 0) (format ", %d failed" fail-count) "")
|
|
|
|
|
(if (> skip-count 0) (format ", %d skipped" skip-count) "")
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(if (> dir-count 1)
|
|
|
|
|
(format " in %d directories" dir-count) "")))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2001-11-17 00:54:36 +00:00
|
|
|
|
(defvar no-byte-compile nil
|
2008-11-20 12:13:49 +00:00
|
|
|
|
"Non-nil to prevent byte-compiling of Emacs Lisp code.
|
2001-11-17 00:54:36 +00:00
|
|
|
|
This is normally set in local file variables at the end of the elisp file:
|
|
|
|
|
|
|
|
|
|
;; Local Variables:\n;; no-byte-compile: t\n;; End: ")
|
2006-05-11 15:01:41 +00:00
|
|
|
|
;;;###autoload(put 'no-byte-compile 'safe-local-variable 'booleanp)
|
2001-11-17 00:54:36 +00:00
|
|
|
|
|
1992-07-19 01:07:07 +00:00
|
|
|
|
;;;###autoload
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(defun byte-compile-file (bytecomp-filename &optional load)
|
|
|
|
|
"Compile a file of Lisp code named BYTECOMP-FILENAME into a file of byte code.
|
|
|
|
|
The output file's name is generated by passing BYTECOMP-FILENAME to the
|
2008-04-27 01:41:46 +00:00
|
|
|
|
function `byte-compile-dest-file' (which see).
|
2001-10-05 09:29:51 +00:00
|
|
|
|
With prefix arg (noninteractively: 2nd arg), LOAD the file after compiling.
|
2001-10-29 17:26:26 +00:00
|
|
|
|
The value is non-nil if there were no errors, nil if errors."
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; (interactive "fByte compile file: \nP")
|
|
|
|
|
(interactive
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(let ((bytecomp-file buffer-file-name)
|
|
|
|
|
(bytecomp-file-name nil)
|
|
|
|
|
(bytecomp-file-dir nil))
|
|
|
|
|
(and bytecomp-file
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(eq (cdr (assq 'major-mode (buffer-local-variables)))
|
|
|
|
|
'emacs-lisp-mode)
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(setq bytecomp-file-name (file-name-nondirectory bytecomp-file)
|
|
|
|
|
bytecomp-file-dir (file-name-directory bytecomp-file)))
|
1992-07-15 20:26:37 +00:00
|
|
|
|
(list (read-file-name (if current-prefix-arg
|
|
|
|
|
"Byte compile and load file: "
|
|
|
|
|
"Byte compile file: ")
|
2008-03-01 21:11:37 +00:00
|
|
|
|
bytecomp-file-dir bytecomp-file-name nil)
|
1992-07-19 01:07:07 +00:00
|
|
|
|
current-prefix-arg)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; Expand now so we get the current buffer's defaults
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(setq bytecomp-filename (expand-file-name bytecomp-filename))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;; If we're compiling a file that's in a buffer and is modified, offer
|
|
|
|
|
;; to save it first.
|
|
|
|
|
(or noninteractive
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(let ((b (get-file-buffer (expand-file-name bytecomp-filename))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(if (and b (buffer-modified-p b)
|
2000-03-24 18:37:48 +00:00
|
|
|
|
(y-or-n-p (format "Save buffer %s first? " (buffer-name b))))
|
2007-08-22 15:51:13 +00:00
|
|
|
|
(with-current-buffer b (save-buffer)))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2002-08-29 17:26:47 +00:00
|
|
|
|
;; Force logging of the file name for each file compiled.
|
|
|
|
|
(setq byte-compile-last-logged-file nil)
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(let ((byte-compile-current-file bytecomp-filename)
|
2008-06-08 02:07:25 +00:00
|
|
|
|
(byte-compile-current-group nil)
|
1998-07-05 20:30:39 +00:00
|
|
|
|
(set-auto-coding-for-load t)
|
1994-12-24 05:58:05 +00:00
|
|
|
|
target-file input-buffer output-buffer
|
|
|
|
|
byte-compile-dest-file)
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(setq target-file (byte-compile-dest-file bytecomp-filename))
|
1994-12-24 05:58:05 +00:00
|
|
|
|
(setq byte-compile-dest-file target-file)
|
2007-09-01 23:33:15 +00:00
|
|
|
|
(with-current-buffer
|
2007-08-22 15:51:13 +00:00
|
|
|
|
(setq input-buffer (get-buffer-create " *Compiler Input*"))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(erase-buffer)
|
1999-04-06 19:56:24 +00:00
|
|
|
|
(setq buffer-file-coding-system nil)
|
1998-04-23 21:24:29 +00:00
|
|
|
|
;; Always compile an Emacs Lisp file as multibyte
|
1999-12-16 15:26:03 +00:00
|
|
|
|
;; unless the file itself forces unibyte with -*-coding: raw-text;-*-
|
1998-04-23 21:24:29 +00:00
|
|
|
|
(set-buffer-multibyte t)
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(insert-file-contents bytecomp-filename)
|
2003-05-06 05:10:59 +00:00
|
|
|
|
;; Mimic the way after-insert-file-set-coding can make the
|
|
|
|
|
;; buffer unibyte when visiting this file.
|
1999-04-06 19:56:24 +00:00
|
|
|
|
(when (or (eq last-coding-system-used 'no-conversion)
|
|
|
|
|
(eq (coding-system-type last-coding-system-used) 5))
|
|
|
|
|
;; For coding systems no-conversion and raw-text...,
|
|
|
|
|
;; edit the buffer as unibyte.
|
|
|
|
|
(set-buffer-multibyte nil))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; Run hooks including the uncompression hook.
|
|
|
|
|
;; If they change the file name, then change it for the output also.
|
2009-08-28 17:02:53 +00:00
|
|
|
|
(letf ((buffer-file-name bytecomp-filename)
|
|
|
|
|
((default-value 'major-mode) 'emacs-lisp-mode)
|
|
|
|
|
;; Ignore unsafe local variables.
|
|
|
|
|
;; We only care about a few of them for our purposes.
|
|
|
|
|
(enable-local-variables :safe)
|
|
|
|
|
(enable-local-eval nil))
|
2006-04-11 17:58:58 +00:00
|
|
|
|
;; Arg of t means don't alter enable-local-variables.
|
|
|
|
|
(normal-mode t)
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(setq bytecomp-filename buffer-file-name))
|
1996-12-30 18:52:14 +00:00
|
|
|
|
;; Set the default directory, in case an eval-when-compile uses it.
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(setq default-directory (file-name-directory bytecomp-filename)))
|
2001-10-05 09:29:51 +00:00
|
|
|
|
;; Check if the file's local variables explicitly specify not to
|
|
|
|
|
;; compile this file.
|
2001-11-17 00:54:36 +00:00
|
|
|
|
(if (with-current-buffer input-buffer no-byte-compile)
|
2001-10-05 09:29:51 +00:00
|
|
|
|
(progn
|
2004-04-16 12:51:06 +00:00
|
|
|
|
;; (message "%s not compiled because of `no-byte-compile: %s'"
|
2008-03-01 21:11:37 +00:00
|
|
|
|
;; (file-relative-name bytecomp-filename)
|
2004-04-16 12:51:06 +00:00
|
|
|
|
;; (with-current-buffer input-buffer no-byte-compile))
|
|
|
|
|
(when (file-exists-p target-file)
|
|
|
|
|
(message "%s deleted because of `no-byte-compile: %s'"
|
|
|
|
|
(file-relative-name target-file)
|
|
|
|
|
(buffer-local-value 'no-byte-compile input-buffer))
|
|
|
|
|
(condition-case nil (delete-file target-file) (error nil)))
|
2001-10-07 23:34:07 +00:00
|
|
|
|
;; We successfully didn't compile this file.
|
2001-10-29 17:26:26 +00:00
|
|
|
|
'no-byte-compile)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(when byte-compile-verbose
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(message "Compiling %s..." bytecomp-filename))
|
2001-10-07 23:34:07 +00:00
|
|
|
|
(setq byte-compiler-error-flag nil)
|
|
|
|
|
;; It is important that input-buffer not be current at this call,
|
|
|
|
|
;; so that the value of point set in input-buffer
|
|
|
|
|
;; within byte-compile-from-buffer lingers in that buffer.
|
2002-09-09 21:41:34 +00:00
|
|
|
|
(setq output-buffer
|
|
|
|
|
(save-current-buffer
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(byte-compile-from-buffer input-buffer bytecomp-filename)))
|
2001-10-07 23:34:07 +00:00
|
|
|
|
(if byte-compiler-error-flag
|
|
|
|
|
nil
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(when byte-compile-verbose
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(message "Compiling %s...done" bytecomp-filename))
|
2001-10-07 23:34:07 +00:00
|
|
|
|
(kill-buffer input-buffer)
|
|
|
|
|
(with-current-buffer output-buffer
|
|
|
|
|
(goto-char (point-max))
|
|
|
|
|
(insert "\n") ; aaah, unix.
|
|
|
|
|
(if (file-writable-p target-file)
|
|
|
|
|
;; We must disable any code conversion here.
|
|
|
|
|
(let ((coding-system-for-write 'no-conversion))
|
|
|
|
|
(if (memq system-type '(ms-dos 'windows-nt))
|
|
|
|
|
(setq buffer-file-type t))
|
|
|
|
|
(when (file-exists-p target-file)
|
|
|
|
|
;; Remove the target before writing it, so that any
|
|
|
|
|
;; hard-links continue to point to the old file (this makes
|
|
|
|
|
;; it possible for installed files to share disk space with
|
|
|
|
|
;; the build tree, without causing problems when emacs-lisp
|
|
|
|
|
;; files in the build tree are recompiled).
|
|
|
|
|
(delete-file target-file))
|
2002-06-25 01:09:52 +00:00
|
|
|
|
(write-region (point-min) (point-max) target-file))
|
2001-10-07 23:34:07 +00:00
|
|
|
|
;; This is just to give a better error message than write-region
|
|
|
|
|
(signal 'file-error
|
|
|
|
|
(list "Opening output file"
|
|
|
|
|
(if (file-exists-p target-file)
|
|
|
|
|
"cannot overwrite file"
|
|
|
|
|
"directory not writable or nonexistent")
|
2008-07-31 05:33:56 +00:00
|
|
|
|
target-file)))
|
2001-10-07 23:34:07 +00:00
|
|
|
|
(kill-buffer (current-buffer)))
|
|
|
|
|
(if (and byte-compile-generate-call-tree
|
|
|
|
|
(or (eq t byte-compile-generate-call-tree)
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(y-or-n-p (format "Report call tree for %s? "
|
|
|
|
|
bytecomp-filename))))
|
2001-10-07 23:34:07 +00:00
|
|
|
|
(save-excursion
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(display-call-tree bytecomp-filename)))
|
2001-10-07 23:34:07 +00:00
|
|
|
|
(if load
|
|
|
|
|
(load target-file))
|
|
|
|
|
t))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;;(defun byte-compile-and-load-file (&optional filename)
|
|
|
|
|
;; "Compile a file of Lisp code named FILENAME into a file of byte code,
|
2000-03-29 21:32:57 +00:00
|
|
|
|
;;and then load it. The output file's name is made by appending \"c\" to
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;;the end of FILENAME."
|
|
|
|
|
;; (interactive)
|
|
|
|
|
;; (if filename ; I don't get it, (interactive-p) doesn't always work
|
|
|
|
|
;; (byte-compile-file filename t)
|
|
|
|
|
;; (let ((current-prefix-arg '(4)))
|
|
|
|
|
;; (call-interactively 'byte-compile-file))))
|
|
|
|
|
|
|
|
|
|
;;(defun byte-compile-buffer (&optional buffer)
|
|
|
|
|
;; "Byte-compile and evaluate contents of BUFFER (default: the current buffer)."
|
|
|
|
|
;; (interactive "bByte compile buffer: ")
|
|
|
|
|
;; (setq buffer (if buffer (get-buffer buffer) (current-buffer)))
|
|
|
|
|
;; (message "Compiling %s..." (buffer-name buffer))
|
|
|
|
|
;; (let* ((filename (or (buffer-file-name buffer)
|
|
|
|
|
;; (concat "#<buffer " (buffer-name buffer) ">")))
|
|
|
|
|
;; (byte-compile-current-file buffer))
|
1994-03-04 04:03:46 +00:00
|
|
|
|
;; (byte-compile-from-buffer buffer nil))
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; (message "Compiling %s...done" (buffer-name buffer))
|
|
|
|
|
;; t)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;;; compiling a single function
|
1992-07-19 01:07:07 +00:00
|
|
|
|
;;;###autoload
|
1992-07-15 20:26:37 +00:00
|
|
|
|
(defun compile-defun (&optional arg)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
"Compile and evaluate the current top-level form.
|
2004-04-16 12:51:06 +00:00
|
|
|
|
Print the result in the echo area.
|
2008-11-20 12:13:49 +00:00
|
|
|
|
With argument ARG, insert value in current buffer after the form."
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(interactive "P")
|
|
|
|
|
(save-excursion
|
|
|
|
|
(end-of-defun)
|
|
|
|
|
(beginning-of-defun)
|
|
|
|
|
(let* ((byte-compile-current-file nil)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(byte-compile-current-buffer (current-buffer))
|
|
|
|
|
(byte-compile-read-position (point))
|
|
|
|
|
(byte-compile-last-position byte-compile-read-position)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-last-warned-form 'nothing)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(value (eval
|
2002-07-19 23:01:24 +00:00
|
|
|
|
(let ((read-with-symbol-positions (current-buffer))
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(read-symbol-positions-list nil))
|
|
|
|
|
(displaying-byte-compile-warnings
|
|
|
|
|
(byte-compile-sexp (read (current-buffer))))))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(cond (arg
|
|
|
|
|
(message "Compiling from buffer... done.")
|
|
|
|
|
(prin1 value (current-buffer))
|
|
|
|
|
(insert "\n"))
|
|
|
|
|
((message "%s" (prin1-to-string value)))))))
|
|
|
|
|
|
|
|
|
|
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(defun byte-compile-from-buffer (bytecomp-inbuffer &optional bytecomp-filename)
|
1994-03-04 04:03:46 +00:00
|
|
|
|
;; Filename is used for the loading-into-Emacs-18 error message.
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(let (bytecomp-outbuffer
|
|
|
|
|
(byte-compile-current-buffer bytecomp-inbuffer)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(byte-compile-read-position nil)
|
|
|
|
|
(byte-compile-last-position nil)
|
1994-12-24 05:58:05 +00:00
|
|
|
|
;; Prevent truncation of flonums and lists as we read and print them
|
|
|
|
|
(float-output-format nil)
|
|
|
|
|
(case-fold-search nil)
|
|
|
|
|
(print-length nil)
|
1995-10-06 22:42:19 +00:00
|
|
|
|
(print-level nil)
|
1998-02-02 01:21:18 +00:00
|
|
|
|
;; Prevent edebug from interfering when we compile
|
|
|
|
|
;; and put the output into a file.
|
2002-05-28 17:40:47 +00:00
|
|
|
|
;; (edebug-all-defs nil)
|
|
|
|
|
;; (edebug-all-forms nil)
|
1994-12-24 05:58:05 +00:00
|
|
|
|
;; Simulate entry to byte-compile-top-level
|
|
|
|
|
(byte-compile-constants nil)
|
|
|
|
|
(byte-compile-variables nil)
|
|
|
|
|
(byte-compile-tag-number 0)
|
|
|
|
|
(byte-compile-depth 0)
|
|
|
|
|
(byte-compile-maxdepth 0)
|
|
|
|
|
(byte-compile-output nil)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
;; This allows us to get the positions of symbols read; it's
|
2005-02-09 15:50:47 +00:00
|
|
|
|
;; new in Emacs 22.1.
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(read-with-symbol-positions bytecomp-inbuffer)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(read-symbol-positions-list nil)
|
1994-12-24 05:58:05 +00:00
|
|
|
|
;; #### This is bound in b-c-close-variables.
|
2007-10-28 23:53:06 +00:00
|
|
|
|
;; (byte-compile-warnings byte-compile-warnings)
|
1994-12-24 05:58:05 +00:00
|
|
|
|
)
|
|
|
|
|
(byte-compile-close-variables
|
2007-06-12 21:03:32 +00:00
|
|
|
|
(with-current-buffer
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(setq bytecomp-outbuffer (get-buffer-create " *Compiler Output*"))
|
1998-08-05 17:59:36 +00:00
|
|
|
|
(set-buffer-multibyte t)
|
1994-12-24 05:58:05 +00:00
|
|
|
|
(erase-buffer)
|
|
|
|
|
;; (emacs-lisp-mode)
|
|
|
|
|
(setq case-fold-search nil)
|
|
|
|
|
;; This is a kludge. Some operating systems (OS/2, DOS) need to
|
|
|
|
|
;; write files containing binary information specially.
|
|
|
|
|
;; Under most circumstances, such files will be in binary
|
|
|
|
|
;; overwrite mode, so those OS's use that flag to guess how
|
|
|
|
|
;; they should write their data. Advise them that .elc files
|
|
|
|
|
;; need to be written carefully.
|
|
|
|
|
(setq overwrite-mode 'overwrite-mode-binary))
|
|
|
|
|
(displaying-byte-compile-warnings
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(and bytecomp-filename
|
|
|
|
|
(byte-compile-insert-header bytecomp-filename bytecomp-inbuffer
|
|
|
|
|
bytecomp-outbuffer))
|
|
|
|
|
(with-current-buffer bytecomp-inbuffer
|
2007-06-12 21:03:32 +00:00
|
|
|
|
(goto-char (point-min))
|
2007-07-24 08:18:12 +00:00
|
|
|
|
;; Should we always do this? When calling multiple files, it
|
|
|
|
|
;; would be useful to delay this warning until all have been
|
|
|
|
|
;; compiled. A: Yes! b-c-u-f might contain dross from a
|
|
|
|
|
;; previous byte-compile.
|
|
|
|
|
(setq byte-compile-unresolved-functions nil)
|
1994-12-24 05:58:05 +00:00
|
|
|
|
|
|
|
|
|
;; Compile the forms from the input buffer.
|
|
|
|
|
(while (progn
|
|
|
|
|
(while (progn (skip-chars-forward " \t\n\^l")
|
|
|
|
|
(looking-at ";"))
|
|
|
|
|
(forward-line 1))
|
|
|
|
|
(not (eobp)))
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(setq byte-compile-read-position (point)
|
|
|
|
|
byte-compile-last-position byte-compile-read-position)
|
2007-08-23 18:19:56 +00:00
|
|
|
|
(let* ((old-style-backquotes nil)
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(form (read bytecomp-inbuffer)))
|
2007-08-23 18:19:56 +00:00
|
|
|
|
;; Warn about the use of old-style backquotes.
|
|
|
|
|
(when old-style-backquotes
|
|
|
|
|
(byte-compile-warn "!! The file uses old-style backquotes !!
|
|
|
|
|
This functionality has been obsolete for more than 10 years already
|
|
|
|
|
and will be removed soon. See (elisp)Backquote in the manual."))
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(byte-compile-file-form form)))
|
1994-12-24 05:58:05 +00:00
|
|
|
|
;; Compile pending forms at end of file.
|
|
|
|
|
(byte-compile-flush-pending)
|
2003-04-19 04:18:37 +00:00
|
|
|
|
;; Make warnings about unresolved functions
|
|
|
|
|
;; give the end of the file as their position.
|
|
|
|
|
(setq byte-compile-last-position (point-max))
|
2007-07-24 08:18:12 +00:00
|
|
|
|
(byte-compile-warn-about-unresolved-functions))
|
1998-05-19 02:59:42 +00:00
|
|
|
|
;; Fix up the header at the front of the output
|
|
|
|
|
;; if the buffer contains multibyte characters.
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(and bytecomp-filename
|
|
|
|
|
(byte-compile-fix-header bytecomp-filename bytecomp-inbuffer
|
|
|
|
|
bytecomp-outbuffer))))
|
|
|
|
|
bytecomp-outbuffer))
|
1994-03-04 04:03:46 +00:00
|
|
|
|
|
1998-05-19 02:59:42 +00:00
|
|
|
|
(defun byte-compile-fix-header (filename inbuffer outbuffer)
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(with-current-buffer outbuffer
|
1998-05-19 02:59:42 +00:00
|
|
|
|
;; See if the buffer has any multibyte characters.
|
2000-08-07 01:47:27 +00:00
|
|
|
|
(when (< (point-max) (position-bytes (point-max)))
|
1998-05-19 02:59:42 +00:00
|
|
|
|
(when (byte-compile-version-cond byte-compile-compatibility)
|
|
|
|
|
(error "Version-18 compatibility not valid with multibyte characters"))
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
;; Find the comment that describes the version test.
|
|
|
|
|
(search-forward "\n;;; This file")
|
|
|
|
|
(beginning-of-line)
|
|
|
|
|
(narrow-to-region (point) (point-max))
|
|
|
|
|
;; Find the line of ballast semicolons.
|
|
|
|
|
(search-forward ";;;;;;;;;;")
|
|
|
|
|
(beginning-of-line)
|
|
|
|
|
|
|
|
|
|
(narrow-to-region (point-min) (point))
|
|
|
|
|
(let ((old-header-end (point))
|
|
|
|
|
delta)
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
(delete-region (point) (progn (re-search-forward "^(")
|
|
|
|
|
(beginning-of-line)
|
|
|
|
|
(point)))
|
2002-06-24 18:25:16 +00:00
|
|
|
|
(insert ";;; This file contains utf-8 non-ASCII characters\n"
|
2009-08-06 00:07:12 +00:00
|
|
|
|
";;; and therefore cannot be loaded into Emacs 22 or earlier.\n")
|
|
|
|
|
;; Replace "19" or "19.29" with "23", twice.
|
1998-05-19 02:59:42 +00:00
|
|
|
|
(re-search-forward "19\\(\\.[0-9]+\\)")
|
2005-02-14 03:40:07 +00:00
|
|
|
|
(replace-match "23")
|
1998-05-19 02:59:42 +00:00
|
|
|
|
(re-search-forward "19\\(\\.[0-9]+\\)")
|
2005-02-14 03:40:07 +00:00
|
|
|
|
(replace-match "23")
|
1998-05-19 02:59:42 +00:00
|
|
|
|
;; Now compensate for the change in size,
|
|
|
|
|
;; to make sure all positions in the file remain valid.
|
|
|
|
|
(setq delta (- (point-max) old-header-end))
|
|
|
|
|
(goto-char (point-max))
|
|
|
|
|
(widen)
|
|
|
|
|
(delete-char delta)))))
|
|
|
|
|
|
1995-08-10 22:44:21 +00:00
|
|
|
|
(defun byte-compile-insert-header (filename inbuffer outbuffer)
|
2008-01-04 05:35:12 +00:00
|
|
|
|
(with-current-buffer inbuffer
|
|
|
|
|
(let ((dynamic-docstrings byte-compile-dynamic-docstrings)
|
|
|
|
|
(dynamic byte-compile-dynamic))
|
|
|
|
|
(set-buffer outbuffer)
|
|
|
|
|
(goto-char (point-min))
|
|
|
|
|
;; The magic number of .elc files is ";ELC", or 0x3B454C43. After
|
2008-01-09 01:21:15 +00:00
|
|
|
|
;; that is the file-format version number (18, 19, 20, or 23) as a
|
2008-01-04 05:35:12 +00:00
|
|
|
|
;; byte, followed by some nulls. The primary motivation for doing
|
|
|
|
|
;; this is to get some binary characters up in the first line of
|
|
|
|
|
;; the file so that `diff' will simply say "Binary files differ"
|
|
|
|
|
;; instead of actually doing a diff of two .elc files. An extra
|
|
|
|
|
;; benefit is that you can add this to /etc/magic:
|
|
|
|
|
|
|
|
|
|
;; 0 string ;ELC GNU Emacs Lisp compiled file,
|
|
|
|
|
;; >4 byte x version %d
|
|
|
|
|
|
|
|
|
|
(insert
|
|
|
|
|
";ELC"
|
2008-01-09 01:21:15 +00:00
|
|
|
|
(if (byte-compile-version-cond byte-compile-compatibility) 18 23)
|
2008-01-04 05:35:12 +00:00
|
|
|
|
"\000\000\000\n"
|
|
|
|
|
)
|
|
|
|
|
(insert ";;; Compiled by "
|
|
|
|
|
(or (and (boundp 'user-mail-address) user-mail-address)
|
|
|
|
|
(concat (user-login-name) "@" (system-name)))
|
|
|
|
|
" on "
|
|
|
|
|
(current-time-string) "\n;;; from file " filename "\n")
|
|
|
|
|
(insert ";;; in Emacs version " emacs-version "\n")
|
|
|
|
|
(insert ";;; "
|
|
|
|
|
(cond
|
|
|
|
|
((eq byte-optimize 'source) "with source-level optimization only")
|
|
|
|
|
((eq byte-optimize 'byte) "with byte-level optimization only")
|
|
|
|
|
(byte-optimize "with all optimizations")
|
|
|
|
|
(t "without optimization"))
|
|
|
|
|
(if (byte-compile-version-cond byte-compile-compatibility)
|
|
|
|
|
"; compiled with Emacs 18 compatibility.\n"
|
|
|
|
|
".\n"))
|
|
|
|
|
(if dynamic
|
|
|
|
|
(insert ";;; Function definitions are lazy-loaded.\n"))
|
|
|
|
|
(if (not (byte-compile-version-cond byte-compile-compatibility))
|
|
|
|
|
(let (intro-string minimum-version)
|
|
|
|
|
;; Figure out which Emacs version to require,
|
|
|
|
|
;; and what comment to use to explain why.
|
|
|
|
|
;; Note that this fails to take account of whether
|
|
|
|
|
;; the buffer contains multibyte characters. We may have to
|
|
|
|
|
;; compensate at the end in byte-compile-fix-header.
|
|
|
|
|
(if dynamic-docstrings
|
1998-05-13 00:03:19 +00:00
|
|
|
|
(setq intro-string
|
1998-05-19 02:59:42 +00:00
|
|
|
|
";;; This file uses dynamic docstrings, first added in Emacs 19.29.\n"
|
|
|
|
|
minimum-version "19.29")
|
|
|
|
|
(setq intro-string
|
|
|
|
|
";;; This file uses opcodes which do not exist in Emacs 18.\n"
|
|
|
|
|
minimum-version "19"))
|
1998-05-13 00:03:19 +00:00
|
|
|
|
;; Now insert the comment and the error check.
|
|
|
|
|
(insert
|
1998-05-19 02:59:42 +00:00
|
|
|
|
"\n"
|
1998-05-13 00:03:19 +00:00
|
|
|
|
intro-string
|
|
|
|
|
;; Have to check if emacs-version is bound so that this works
|
|
|
|
|
;; in files loaded early in loadup.el.
|
1998-05-19 02:59:42 +00:00
|
|
|
|
"(if (and (boundp 'emacs-version)\n"
|
1998-05-13 00:03:19 +00:00
|
|
|
|
;; If there is a name at the end of emacs-version,
|
|
|
|
|
;; don't try to check the version number.
|
|
|
|
|
"\t (< (aref emacs-version (1- (length emacs-version))) ?A)\n"
|
|
|
|
|
"\t (or (and (boundp 'epoch::version) epoch::version)\n"
|
|
|
|
|
(format "\t (string-lessp emacs-version \"%s\")))\n"
|
|
|
|
|
minimum-version)
|
|
|
|
|
" (error \"`"
|
|
|
|
|
;; prin1-to-string is used to quote backslashes.
|
|
|
|
|
(substring (prin1-to-string (file-name-nondirectory filename))
|
|
|
|
|
1 -1)
|
|
|
|
|
(format "' was compiled for Emacs %s or later\"))\n\n"
|
1998-05-19 02:59:42 +00:00
|
|
|
|
minimum-version)
|
|
|
|
|
;; Insert semicolons as ballast, so that byte-compile-fix-header
|
|
|
|
|
;; can delete them so as to keep the buffer positions
|
|
|
|
|
;; constant for the actual compiled code.
|
2002-06-24 18:25:16 +00:00
|
|
|
|
";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n\n"))
|
1998-05-13 00:03:19 +00:00
|
|
|
|
;; Here if we want Emacs 18 compatibility.
|
1998-05-19 02:59:42 +00:00
|
|
|
|
(when dynamic-docstrings
|
|
|
|
|
(error "Version-18 compatibility doesn't support dynamic doc strings"))
|
|
|
|
|
(when byte-compile-dynamic
|
|
|
|
|
(error "Version-18 compatibility doesn't support dynamic byte code"))
|
1995-08-10 22:44:21 +00:00
|
|
|
|
(insert "(or (boundp 'current-load-list) (setq current-load-list nil))\n"
|
2008-01-04 05:35:12 +00:00
|
|
|
|
"\n")))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2009-07-23 02:53:29 +00:00
|
|
|
|
;; Dynamically bound in byte-compile-from-buffer.
|
|
|
|
|
;; NB also used in cl.el and cl-macs.el.
|
|
|
|
|
(defvar bytecomp-outbuffer)
|
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defun byte-compile-output-file-form (form)
|
|
|
|
|
;; writes the given form to the output buffer, being careful of docstrings
|
1997-08-31 17:07:28 +00:00
|
|
|
|
;; in defun, defmacro, defvar, defconst, autoload and
|
|
|
|
|
;; custom-declare-variable because make-docfile is so amazingly stupid.
|
1993-04-23 03:43:33 +00:00
|
|
|
|
;; defalias calls are output directly by byte-compile-file-form-defmumble;
|
|
|
|
|
;; it does not pay to first build the defalias in defmumble and then parse
|
|
|
|
|
;; it here.
|
1997-08-31 17:07:28 +00:00
|
|
|
|
(if (and (memq (car-safe form) '(defun defmacro defvar defconst autoload
|
|
|
|
|
custom-declare-variable))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(stringp (nth 3 form)))
|
1994-12-24 05:58:05 +00:00
|
|
|
|
(byte-compile-output-docform nil nil '("\n(" 3 ")") form nil
|
1997-08-31 17:07:28 +00:00
|
|
|
|
(memq (car form)
|
|
|
|
|
'(autoload custom-declare-variable)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(let ((print-escape-newlines t)
|
1995-07-17 22:46:25 +00:00
|
|
|
|
(print-length nil)
|
|
|
|
|
(print-level nil)
|
1996-09-10 23:00:29 +00:00
|
|
|
|
(print-quoted t)
|
2007-01-24 13:57:38 +00:00
|
|
|
|
(print-gensym t)
|
2007-01-29 01:22:53 +00:00
|
|
|
|
(print-circle ; handle circular data structures
|
|
|
|
|
(not byte-compile-disable-print-circle)))
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(princ "\n" bytecomp-outbuffer)
|
|
|
|
|
(prin1 form bytecomp-outbuffer)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
nil)))
|
|
|
|
|
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(defvar print-gensym-alist) ;Used before print-circle existed.
|
|
|
|
|
|
1994-12-24 05:58:05 +00:00
|
|
|
|
(defun byte-compile-output-docform (preface name info form specindex quoted)
|
1995-08-07 08:45:00 +00:00
|
|
|
|
"Print a form with a doc string. INFO is (prefix doc-index postfix).
|
|
|
|
|
If PREFACE and NAME are non-nil, print them too,
|
|
|
|
|
before INFO and the FORM but after the doc string itself.
|
|
|
|
|
If SPECINDEX is non-nil, it is the index in FORM
|
|
|
|
|
of the function bytecode string. In that case,
|
2008-11-20 12:13:49 +00:00
|
|
|
|
we output that argument and the following argument
|
|
|
|
|
\(the constants vector) together, for lazy loading.
|
1995-08-07 08:45:00 +00:00
|
|
|
|
QUOTED says that we have to put a quote before the
|
|
|
|
|
list that represents a doc string reference.
|
1997-08-31 17:07:28 +00:00
|
|
|
|
`autoload' and `custom-declare-variable' need that."
|
1995-08-07 08:45:00 +00:00
|
|
|
|
;; We need to examine byte-compile-dynamic-docstrings
|
|
|
|
|
;; in the input buffer (now current), not in the output buffer.
|
|
|
|
|
(let ((dynamic-docstrings byte-compile-dynamic-docstrings))
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(with-current-buffer bytecomp-outbuffer
|
2007-08-23 19:58:31 +00:00
|
|
|
|
(let (position)
|
|
|
|
|
|
|
|
|
|
;; Insert the doc string, and make it a comment with #@LENGTH.
|
|
|
|
|
(and (>= (nth 1 info) 0)
|
|
|
|
|
dynamic-docstrings
|
|
|
|
|
(not byte-compile-compatibility)
|
|
|
|
|
(progn
|
|
|
|
|
;; Make the doc string start at beginning of line
|
|
|
|
|
;; for make-docfile's sake.
|
|
|
|
|
(insert "\n")
|
|
|
|
|
(setq position
|
|
|
|
|
(byte-compile-output-as-comment
|
|
|
|
|
(nth (nth 1 info) form) nil))
|
|
|
|
|
(setq position (- (position-bytes position) (point-min) -1))
|
|
|
|
|
;; If the doc string starts with * (a user variable),
|
|
|
|
|
;; negate POSITION.
|
|
|
|
|
(if (and (stringp (nth (nth 1 info) form))
|
|
|
|
|
(> (length (nth (nth 1 info) form)) 0)
|
|
|
|
|
(eq (aref (nth (nth 1 info) form) 0) ?*))
|
|
|
|
|
(setq position (- position)))))
|
|
|
|
|
|
|
|
|
|
(if preface
|
|
|
|
|
(progn
|
|
|
|
|
(insert preface)
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(prin1 name bytecomp-outbuffer)))
|
2007-08-23 19:58:31 +00:00
|
|
|
|
(insert (car info))
|
|
|
|
|
(let ((print-escape-newlines t)
|
|
|
|
|
(print-quoted t)
|
|
|
|
|
;; For compatibility with code before print-circle,
|
|
|
|
|
;; use a cons cell to say that we want
|
|
|
|
|
;; print-gensym-alist not to be cleared
|
|
|
|
|
;; between calls to print functions.
|
|
|
|
|
(print-gensym '(t))
|
|
|
|
|
(print-circle ; handle circular data structures
|
|
|
|
|
(not byte-compile-disable-print-circle))
|
|
|
|
|
print-gensym-alist ; was used before print-circle existed.
|
|
|
|
|
(print-continuous-numbering t)
|
|
|
|
|
print-number-table
|
|
|
|
|
(index 0))
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(prin1 (car form) bytecomp-outbuffer)
|
2007-08-23 19:58:31 +00:00
|
|
|
|
(while (setq form (cdr form))
|
|
|
|
|
(setq index (1+ index))
|
|
|
|
|
(insert " ")
|
|
|
|
|
(cond ((and (numberp specindex) (= index specindex)
|
|
|
|
|
;; Don't handle the definition dynamically
|
|
|
|
|
;; if it refers (or might refer)
|
|
|
|
|
;; to objects already output
|
|
|
|
|
;; (for instance, gensyms in the arg list).
|
|
|
|
|
(let (non-nil)
|
|
|
|
|
(dotimes (i (length print-number-table))
|
|
|
|
|
(if (aref print-number-table i)
|
|
|
|
|
(setq non-nil t)))
|
|
|
|
|
(not non-nil)))
|
|
|
|
|
;; Output the byte code and constants specially
|
|
|
|
|
;; for lazy dynamic loading.
|
|
|
|
|
(let ((position
|
|
|
|
|
(byte-compile-output-as-comment
|
|
|
|
|
(cons (car form) (nth 1 form))
|
|
|
|
|
t)))
|
|
|
|
|
(setq position (- (position-bytes position) (point-min) -1))
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(princ (format "(#$ . %d) nil" position) bytecomp-outbuffer)
|
2007-08-23 19:58:31 +00:00
|
|
|
|
(setq form (cdr form))
|
|
|
|
|
(setq index (1+ index))))
|
|
|
|
|
((= index (nth 1 info))
|
|
|
|
|
(if position
|
|
|
|
|
(princ (format (if quoted "'(#$ . %d)" "(#$ . %d)")
|
|
|
|
|
position)
|
2009-07-23 02:53:29 +00:00
|
|
|
|
bytecomp-outbuffer)
|
2007-08-23 19:58:31 +00:00
|
|
|
|
(let ((print-escape-newlines nil))
|
|
|
|
|
(goto-char (prog1 (1+ (point))
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(prin1 (car form) bytecomp-outbuffer)))
|
2007-08-23 19:58:31 +00:00
|
|
|
|
(insert "\\\n")
|
|
|
|
|
(goto-char (point-max)))))
|
|
|
|
|
(t
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(prin1 (car form) bytecomp-outbuffer)))))
|
2007-08-23 19:58:31 +00:00
|
|
|
|
(insert (nth 2 info)))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
nil)
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-keep-pending (form &optional handler)
|
|
|
|
|
(if (memq byte-optimize '(t source))
|
|
|
|
|
(setq form (byte-optimize-form form t)))
|
|
|
|
|
(if handler
|
|
|
|
|
(let ((for-effect t))
|
|
|
|
|
;; To avoid consing up monstrously large forms at load time, we split
|
|
|
|
|
;; the output regularly.
|
1993-07-02 17:46:43 +00:00
|
|
|
|
(and (memq (car-safe form) '(fset defalias))
|
|
|
|
|
(nthcdr 300 byte-compile-output)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-flush-pending))
|
|
|
|
|
(funcall handler form)
|
|
|
|
|
(if for-effect
|
|
|
|
|
(byte-compile-discard)))
|
|
|
|
|
(byte-compile-form form t))
|
|
|
|
|
nil)
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-flush-pending ()
|
|
|
|
|
(if byte-compile-output
|
|
|
|
|
(let ((form (byte-compile-out-toplevel t 'file)))
|
|
|
|
|
(cond ((eq (car-safe form) 'progn)
|
2000-05-26 10:35:38 +00:00
|
|
|
|
(mapc 'byte-compile-output-file-form (cdr form)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(form
|
|
|
|
|
(byte-compile-output-file-form form)))
|
|
|
|
|
(setq byte-compile-constants nil
|
|
|
|
|
byte-compile-variables nil
|
|
|
|
|
byte-compile-depth 0
|
|
|
|
|
byte-compile-maxdepth 0
|
|
|
|
|
byte-compile-output nil))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-file-form (form)
|
|
|
|
|
(let ((byte-compile-current-form nil) ; close over this for warnings.
|
|
|
|
|
handler)
|
|
|
|
|
(cond
|
|
|
|
|
((not (consp form))
|
|
|
|
|
(byte-compile-keep-pending form))
|
|
|
|
|
((and (symbolp (car form))
|
|
|
|
|
(setq handler (get (car form) 'byte-hunk-handler)))
|
|
|
|
|
(cond ((setq form (funcall handler form))
|
|
|
|
|
(byte-compile-flush-pending)
|
|
|
|
|
(byte-compile-output-file-form form))))
|
|
|
|
|
((eq form (setq form (macroexpand form byte-compile-macro-environment)))
|
|
|
|
|
(byte-compile-keep-pending form))
|
|
|
|
|
(t
|
|
|
|
|
(byte-compile-file-form form)))))
|
|
|
|
|
|
|
|
|
|
;; Functions and variables with doc strings must be output separately,
|
|
|
|
|
;; so make-docfile can recognise them. Most other things can be output
|
|
|
|
|
;; as byte-code.
|
|
|
|
|
|
|
|
|
|
(put 'defsubst 'byte-hunk-handler 'byte-compile-file-form-defsubst)
|
|
|
|
|
(defun byte-compile-file-form-defsubst (form)
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(when (assq (nth 1 form) byte-compile-unresolved-functions)
|
|
|
|
|
(setq byte-compile-current-form (nth 1 form))
|
2004-06-13 22:01:36 +00:00
|
|
|
|
(byte-compile-warn "defsubst `%s' was used before it was defined"
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(nth 1 form)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-file-form
|
|
|
|
|
(macroexpand form byte-compile-macro-environment))
|
|
|
|
|
;; Return nil so the form is not output twice.
|
|
|
|
|
nil)
|
|
|
|
|
|
|
|
|
|
(put 'autoload 'byte-hunk-handler 'byte-compile-file-form-autoload)
|
|
|
|
|
(defun byte-compile-file-form-autoload (form)
|
|
|
|
|
(and (let ((form form))
|
|
|
|
|
(while (if (setq form (cdr form)) (byte-compile-constp (car form))))
|
|
|
|
|
(null form)) ;Constants only
|
|
|
|
|
(eval (nth 5 form)) ;Macro
|
|
|
|
|
(eval form)) ;Define the autoload.
|
2000-03-29 21:32:57 +00:00
|
|
|
|
;; Avoid undefined function warnings for the autoload.
|
2000-03-31 11:28:14 +00:00
|
|
|
|
(if (and (consp (nth 1 form))
|
2000-03-29 21:32:57 +00:00
|
|
|
|
(eq (car (nth 1 form)) 'quote)
|
|
|
|
|
(consp (cdr (nth 1 form)))
|
|
|
|
|
(symbolp (nth 1 (nth 1 form))))
|
2004-11-11 22:44:46 +00:00
|
|
|
|
(push (cons (nth 1 (nth 1 form))
|
|
|
|
|
(cons 'autoload (cdr (cdr form))))
|
|
|
|
|
byte-compile-function-environment))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(if (stringp (nth 3 form))
|
|
|
|
|
form
|
|
|
|
|
;; No doc string, so we can compile this as a normal form.
|
|
|
|
|
(byte-compile-keep-pending form 'byte-compile-normal-call)))
|
|
|
|
|
|
|
|
|
|
(put 'defvar 'byte-hunk-handler 'byte-compile-file-form-defvar)
|
|
|
|
|
(put 'defconst 'byte-hunk-handler 'byte-compile-file-form-defvar)
|
|
|
|
|
(defun byte-compile-file-form-defvar (form)
|
|
|
|
|
(if (null (nth 3 form))
|
|
|
|
|
;; Since there is no doc string, we can compile this as a normal form,
|
|
|
|
|
;; and not do a file-boundary.
|
|
|
|
|
(byte-compile-keep-pending form)
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(when (byte-compile-warning-enabled-p 'free-vars)
|
2003-04-12 21:39:50 +00:00
|
|
|
|
(push (nth 1 form) byte-compile-bound-variables)
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(if (eq (car form) 'defconst)
|
|
|
|
|
(push (nth 1 form) byte-compile-const-variables)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(cond ((consp (nth 2 form))
|
|
|
|
|
(setq form (copy-sequence form))
|
|
|
|
|
(setcar (cdr (cdr form))
|
|
|
|
|
(byte-compile-top-level (nth 2 form) nil 'file))))
|
|
|
|
|
form))
|
|
|
|
|
|
2007-11-09 15:57:46 +00:00
|
|
|
|
(put 'define-abbrev-table 'byte-hunk-handler 'byte-compile-file-form-define-abbrev-table)
|
|
|
|
|
(defun byte-compile-file-form-define-abbrev-table (form)
|
|
|
|
|
(when (and (byte-compile-warning-enabled-p 'free-vars)
|
|
|
|
|
(eq 'quote (car-safe (car-safe (cdr form)))))
|
|
|
|
|
(push (car-safe (cdr (cadr form))) byte-compile-bound-variables))
|
|
|
|
|
(byte-compile-keep-pending form))
|
|
|
|
|
|
1997-05-08 16:28:07 +00:00
|
|
|
|
(put 'custom-declare-variable 'byte-hunk-handler
|
|
|
|
|
'byte-compile-file-form-custom-declare-variable)
|
|
|
|
|
(defun byte-compile-file-form-custom-declare-variable (form)
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(when (byte-compile-warning-enabled-p 'callargs)
|
2005-05-19 15:39:21 +00:00
|
|
|
|
(byte-compile-nogroup-warn form))
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(when (byte-compile-warning-enabled-p 'free-vars)
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(push (nth 1 (nth 1 form)) byte-compile-bound-variables))
|
2007-11-22 18:03:05 +00:00
|
|
|
|
;; Don't compile the expression because it may be displayed to the user.
|
|
|
|
|
;; (when (eq (car-safe (nth 2 form)) 'quote)
|
|
|
|
|
;; ;; (nth 2 form) is meant to evaluate to an expression, so if we have the
|
|
|
|
|
;; ;; final value already, we can byte-compile it.
|
|
|
|
|
;; (setcar (cdr (nth 2 form))
|
|
|
|
|
;; (byte-compile-top-level (cadr (nth 2 form)) nil 'file)))
|
2003-01-25 19:44:24 +00:00
|
|
|
|
(let ((tail (nthcdr 4 form)))
|
|
|
|
|
(while tail
|
2007-11-22 18:03:05 +00:00
|
|
|
|
(unless (keywordp (car tail)) ;No point optimizing keywords.
|
|
|
|
|
;; Compile the keyword arguments.
|
|
|
|
|
(setcar tail (byte-compile-top-level (car tail) nil 'file)))
|
2003-01-25 19:44:24 +00:00
|
|
|
|
(setq tail (cdr tail))))
|
1997-05-08 16:28:07 +00:00
|
|
|
|
form)
|
|
|
|
|
|
2004-10-16 15:20:24 +00:00
|
|
|
|
(put 'require 'byte-hunk-handler 'byte-compile-file-form-require)
|
|
|
|
|
(defun byte-compile-file-form-require (form)
|
2007-06-12 21:03:32 +00:00
|
|
|
|
(let ((args (mapcar 'eval (cdr form))))
|
2004-10-16 15:20:24 +00:00
|
|
|
|
(apply 'require args)
|
2004-12-21 11:50:52 +00:00
|
|
|
|
;; Detect (require 'cl) in a way that works even if cl is already loaded.
|
2009-08-25 07:36:49 +00:00
|
|
|
|
(when (and (member (car args) '("cl" cl))
|
|
|
|
|
(byte-compile-warning-enabled-p 'cl-functions))
|
|
|
|
|
(byte-compile-warn "cl package required at runtime")
|
2009-08-25 07:28:16 +00:00
|
|
|
|
(byte-compile-disable-warning 'cl-functions)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-keep-pending form 'byte-compile-normal-call))
|
|
|
|
|
|
|
|
|
|
(put 'progn 'byte-hunk-handler 'byte-compile-file-form-progn)
|
|
|
|
|
(put 'prog1 'byte-hunk-handler 'byte-compile-file-form-progn)
|
|
|
|
|
(put 'prog2 'byte-hunk-handler 'byte-compile-file-form-progn)
|
|
|
|
|
(defun byte-compile-file-form-progn (form)
|
2000-05-26 10:35:38 +00:00
|
|
|
|
(mapc 'byte-compile-file-form (cdr form))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; Return nil so the forms are not output twice.
|
|
|
|
|
nil)
|
|
|
|
|
|
|
|
|
|
;; This handler is not necessary, but it makes the output from dont-compile
|
|
|
|
|
;; and similar macros cleaner.
|
|
|
|
|
(put 'eval 'byte-hunk-handler 'byte-compile-file-form-eval)
|
|
|
|
|
(defun byte-compile-file-form-eval (form)
|
|
|
|
|
(if (eq (car-safe (nth 1 form)) 'quote)
|
|
|
|
|
(nth 1 (nth 1 form))
|
|
|
|
|
(byte-compile-keep-pending form)))
|
|
|
|
|
|
|
|
|
|
(put 'defun 'byte-hunk-handler 'byte-compile-file-form-defun)
|
|
|
|
|
(defun byte-compile-file-form-defun (form)
|
|
|
|
|
(byte-compile-file-form-defmumble form nil))
|
|
|
|
|
|
|
|
|
|
(put 'defmacro 'byte-hunk-handler 'byte-compile-file-form-defmacro)
|
|
|
|
|
(defun byte-compile-file-form-defmacro (form)
|
|
|
|
|
(byte-compile-file-form-defmumble form t))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-file-form-defmumble (form macrop)
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(let* ((bytecomp-name (car (cdr form)))
|
|
|
|
|
(bytecomp-this-kind (if macrop 'byte-compile-macro-environment
|
1992-07-10 22:06:47 +00:00
|
|
|
|
'byte-compile-function-environment))
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(bytecomp-that-kind (if macrop 'byte-compile-function-environment
|
1992-07-10 22:06:47 +00:00
|
|
|
|
'byte-compile-macro-environment))
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(bytecomp-this-one (assq bytecomp-name
|
|
|
|
|
(symbol-value bytecomp-this-kind)))
|
|
|
|
|
(bytecomp-that-one (assq bytecomp-name
|
|
|
|
|
(symbol-value bytecomp-that-kind)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-free-references nil)
|
|
|
|
|
(byte-compile-free-assignments nil))
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(byte-compile-set-symbol-position bytecomp-name)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; When a function or macro is defined, add it to the call tree so that
|
|
|
|
|
;; we can tell when functions are not used.
|
|
|
|
|
(if byte-compile-generate-call-tree
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(or (assq bytecomp-name byte-compile-call-tree)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(setq byte-compile-call-tree
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(cons (list bytecomp-name nil nil) byte-compile-call-tree))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(setq byte-compile-current-form bytecomp-name) ; for warnings
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(if (byte-compile-warning-enabled-p 'redefine)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-arglist-warn form macrop))
|
|
|
|
|
(if byte-compile-verbose
|
2009-07-23 02:53:29 +00:00
|
|
|
|
;; bytecomp-filename is from byte-compile-from-buffer.
|
|
|
|
|
(message "Compiling %s... (%s)" (or bytecomp-filename "") (nth 1 form)))
|
|
|
|
|
(cond (bytecomp-that-one
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(if (and (byte-compile-warning-enabled-p 'redefine)
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; don't warn when compiling the stubs in byte-run...
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(not (assq (nth 1 form)
|
|
|
|
|
byte-compile-initial-macro-environment)))
|
|
|
|
|
(byte-compile-warn
|
2004-06-13 22:01:36 +00:00
|
|
|
|
"`%s' defined multiple times, as both function and macro"
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(nth 1 form)))
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(setcdr bytecomp-that-one nil))
|
|
|
|
|
(bytecomp-this-one
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(when (and (byte-compile-warning-enabled-p 'redefine)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; hack: don't warn when compiling the magic internal
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; byte-compiler macros in byte-run.el...
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(not (assq (nth 1 form)
|
|
|
|
|
byte-compile-initial-macro-environment)))
|
2004-06-13 22:01:36 +00:00
|
|
|
|
(byte-compile-warn "%s `%s' defined multiple times in this file"
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(if macrop "macro" "function")
|
|
|
|
|
(nth 1 form))))
|
2009-07-23 02:53:29 +00:00
|
|
|
|
((and (fboundp bytecomp-name)
|
|
|
|
|
(eq (car-safe (symbol-function bytecomp-name))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(if macrop 'lambda 'macro)))
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(when (byte-compile-warning-enabled-p 'redefine)
|
2004-06-13 22:01:36 +00:00
|
|
|
|
(byte-compile-warn "%s `%s' being redefined as a %s"
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(if macrop "function" "macro")
|
|
|
|
|
(nth 1 form)
|
|
|
|
|
(if macrop "macro" "function")))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; shadow existing definition
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(set bytecomp-this-kind
|
|
|
|
|
(cons (cons bytecomp-name nil)
|
|
|
|
|
(symbol-value bytecomp-this-kind))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
)
|
|
|
|
|
(let ((body (nthcdr 3 form)))
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(when (and (stringp (car body))
|
|
|
|
|
(symbolp (car-safe (cdr-safe body)))
|
|
|
|
|
(car-safe (cdr-safe body))
|
|
|
|
|
(stringp (car-safe (cdr-safe (cdr-safe body)))))
|
|
|
|
|
(byte-compile-set-symbol-position (nth 1 form))
|
|
|
|
|
(byte-compile-warn "probable `\"' without `\\' in doc string of %s"
|
|
|
|
|
(nth 1 form))))
|
2002-10-17 15:32:26 +00:00
|
|
|
|
|
2002-03-24 19:48:27 +00:00
|
|
|
|
;; Generate code for declarations in macro definitions.
|
|
|
|
|
;; Remove declarations from the body of the macro definition.
|
|
|
|
|
(when macrop
|
|
|
|
|
(let ((tail (nthcdr 2 form)))
|
|
|
|
|
(when (stringp (car (cdr tail)))
|
|
|
|
|
(setq tail (cdr tail)))
|
|
|
|
|
(while (and (consp (car (cdr tail)))
|
|
|
|
|
(eq (car (car (cdr tail))) 'declare))
|
|
|
|
|
(let ((declaration (car (cdr tail))))
|
|
|
|
|
(setcdr tail (cdr (cdr tail)))
|
2007-03-26 03:30:53 +00:00
|
|
|
|
(prin1 `(if macro-declaration-function
|
2002-03-24 19:48:27 +00:00
|
|
|
|
(funcall macro-declaration-function
|
2009-07-23 02:53:29 +00:00
|
|
|
|
',bytecomp-name ',declaration))
|
|
|
|
|
bytecomp-outbuffer)))))
|
2002-10-17 15:32:26 +00:00
|
|
|
|
|
2005-10-23 07:33:45 +00:00
|
|
|
|
(let* ((new-one (byte-compile-lambda (nthcdr 2 form) t))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(code (byte-compile-byte-code-maker new-one)))
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(if bytecomp-this-one
|
|
|
|
|
(setcdr bytecomp-this-one new-one)
|
|
|
|
|
(set bytecomp-this-kind
|
|
|
|
|
(cons (cons bytecomp-name new-one)
|
|
|
|
|
(symbol-value bytecomp-this-kind))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(if (and (stringp (nth 3 form))
|
|
|
|
|
(eq 'quote (car-safe code))
|
|
|
|
|
(eq 'lambda (car-safe (nth 1 code))))
|
|
|
|
|
(cons (car form)
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(cons bytecomp-name (cdr (nth 1 code))))
|
1994-12-24 05:58:05 +00:00
|
|
|
|
(byte-compile-flush-pending)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(if (not (stringp (nth 3 form)))
|
1994-12-24 05:58:05 +00:00
|
|
|
|
;; No doc string. Provide -1 as the "doc string index"
|
|
|
|
|
;; so that no element will be treated as a doc string.
|
|
|
|
|
(byte-compile-output-docform
|
|
|
|
|
(if (byte-compile-version-cond byte-compile-compatibility)
|
|
|
|
|
"\n(fset '" "\n(defalias '")
|
2009-07-23 02:53:29 +00:00
|
|
|
|
bytecomp-name
|
1994-12-24 05:58:05 +00:00
|
|
|
|
(cond ((atom code)
|
|
|
|
|
(if macrop '(" '(macro . #[" -1 "])") '(" #[" -1 "]")))
|
|
|
|
|
((eq (car code) 'quote)
|
|
|
|
|
(setq code new-one)
|
|
|
|
|
(if macrop '(" '(macro " -1 ")") '(" '(" -1 ")")))
|
|
|
|
|
((if macrop '(" (cons 'macro (" -1 "))") '(" (" -1 ")"))))
|
|
|
|
|
(append code nil)
|
|
|
|
|
(and (atom code) byte-compile-dynamic
|
|
|
|
|
1)
|
|
|
|
|
nil)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; Output the form by hand, that's much simpler than having
|
1993-04-23 03:43:33 +00:00
|
|
|
|
;; b-c-output-file-form analyze the defalias.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-output-docform
|
1994-12-24 05:58:05 +00:00
|
|
|
|
(if (byte-compile-version-cond byte-compile-compatibility)
|
|
|
|
|
"\n(fset '" "\n(defalias '")
|
2009-07-23 02:53:29 +00:00
|
|
|
|
bytecomp-name
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(cond ((atom code)
|
|
|
|
|
(if macrop '(" '(macro . #[" 4 "])") '(" #[" 4 "]")))
|
|
|
|
|
((eq (car code) 'quote)
|
|
|
|
|
(setq code new-one)
|
|
|
|
|
(if macrop '(" '(macro " 2 ")") '(" '(" 2 ")")))
|
|
|
|
|
((if macrop '(" (cons 'macro (" 5 "))") '(" (" 5 ")"))))
|
1994-12-24 05:58:05 +00:00
|
|
|
|
(append code nil)
|
|
|
|
|
(and (atom code) byte-compile-dynamic
|
|
|
|
|
1)
|
|
|
|
|
nil))
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(princ ")" bytecomp-outbuffer)
|
1994-12-24 05:58:05 +00:00
|
|
|
|
nil))))
|
|
|
|
|
|
|
|
|
|
;; Print Lisp object EXP in the output file, inside a comment,
|
|
|
|
|
;; and return the file position it will have.
|
|
|
|
|
;; If QUOTED is non-nil, print with quoting; otherwise, print without quoting.
|
|
|
|
|
(defun byte-compile-output-as-comment (exp quoted)
|
1998-08-28 12:22:39 +00:00
|
|
|
|
(let ((position (point)))
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(with-current-buffer bytecomp-outbuffer
|
2007-08-23 19:58:31 +00:00
|
|
|
|
|
|
|
|
|
;; Insert EXP, and make it a comment with #@LENGTH.
|
|
|
|
|
(insert " ")
|
|
|
|
|
(if quoted
|
2009-07-23 02:53:29 +00:00
|
|
|
|
(prin1 exp bytecomp-outbuffer)
|
|
|
|
|
(princ exp bytecomp-outbuffer))
|
2007-08-23 19:58:31 +00:00
|
|
|
|
(goto-char position)
|
|
|
|
|
;; Quote certain special characters as needed.
|
|
|
|
|
;; get_doc_string in doc.c does the unquoting.
|
|
|
|
|
(while (search-forward "\^A" nil t)
|
|
|
|
|
(replace-match "\^A\^A" t t))
|
|
|
|
|
(goto-char position)
|
|
|
|
|
(while (search-forward "\000" nil t)
|
|
|
|
|
(replace-match "\^A0" t t))
|
|
|
|
|
(goto-char position)
|
|
|
|
|
(while (search-forward "\037" nil t)
|
|
|
|
|
(replace-match "\^A_" t t))
|
|
|
|
|
(goto-char (point-max))
|
|
|
|
|
(insert "\037")
|
|
|
|
|
(goto-char position)
|
|
|
|
|
(insert "#@" (format "%d" (- (position-bytes (point-max))
|
|
|
|
|
(position-bytes position))))
|
|
|
|
|
|
|
|
|
|
;; Save the file position of the object.
|
|
|
|
|
;; Note we should add 1 to skip the space
|
|
|
|
|
;; that we inserted before the actual doc string,
|
|
|
|
|
;; and subtract 1 to convert from an 1-origin Emacs position
|
|
|
|
|
;; to a file position; they cancel.
|
|
|
|
|
(setq position (point))
|
|
|
|
|
(goto-char (point-max)))
|
1994-12-24 05:58:05 +00:00
|
|
|
|
position))
|
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
|
1992-07-19 01:07:07 +00:00
|
|
|
|
;;;###autoload
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defun byte-compile (form)
|
|
|
|
|
"If FORM is a symbol, byte-compile its function definition.
|
|
|
|
|
If FORM is a lambda or a macro, byte-compile it as a function."
|
|
|
|
|
(displaying-byte-compile-warnings
|
|
|
|
|
(byte-compile-close-variables
|
|
|
|
|
(let* ((fun (if (symbolp form)
|
|
|
|
|
(and (fboundp form) (symbol-function form))
|
|
|
|
|
form))
|
|
|
|
|
(macro (eq (car-safe fun) 'macro)))
|
|
|
|
|
(if macro
|
|
|
|
|
(setq fun (cdr fun)))
|
|
|
|
|
(cond ((eq (car-safe fun) 'lambda)
|
|
|
|
|
(setq fun (if macro
|
|
|
|
|
(cons 'macro (byte-compile-lambda fun))
|
|
|
|
|
(byte-compile-lambda fun)))
|
|
|
|
|
(if (symbolp form)
|
1993-04-23 03:43:33 +00:00
|
|
|
|
(defalias form fun)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
fun)))))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-sexp (sexp)
|
|
|
|
|
"Compile and return SEXP."
|
|
|
|
|
(displaying-byte-compile-warnings
|
|
|
|
|
(byte-compile-close-variables
|
|
|
|
|
(byte-compile-top-level sexp))))
|
|
|
|
|
|
|
|
|
|
;; Given a function made by byte-compile-lambda, make a form which produces it.
|
|
|
|
|
(defun byte-compile-byte-code-maker (fun)
|
|
|
|
|
(cond
|
1992-07-15 20:26:37 +00:00
|
|
|
|
((byte-compile-version-cond byte-compile-compatibility)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; Return (quote (lambda ...)).
|
|
|
|
|
(list 'quote (byte-compile-byte-code-unmake fun)))
|
|
|
|
|
;; ## atom is faster than compiled-func-p.
|
|
|
|
|
((atom fun) ; compiled function.
|
|
|
|
|
;; generate-emacs19-bytecodes must be on, otherwise byte-compile-lambda
|
|
|
|
|
;; would have produced a lambda.
|
1996-09-10 19:22:12 +00:00
|
|
|
|
fun)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; b-c-lambda didn't produce a compiled-function, so it's either a trivial
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; function, or this is Emacs 18, or generate-emacs19-bytecodes is off.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
((let (tmp)
|
|
|
|
|
(if (and (setq tmp (assq 'byte-code (cdr-safe (cdr fun))))
|
|
|
|
|
(null (cdr (memq tmp fun))))
|
|
|
|
|
;; Generate a make-byte-code call.
|
|
|
|
|
(let* ((interactive (assq 'interactive (cdr (cdr fun)))))
|
|
|
|
|
(nconc (list 'make-byte-code
|
|
|
|
|
(list 'quote (nth 1 fun)) ;arglist
|
|
|
|
|
(nth 1 tmp) ;bytes
|
|
|
|
|
(nth 2 tmp) ;consts
|
|
|
|
|
(nth 3 tmp)) ;depth
|
|
|
|
|
(cond ((stringp (nth 2 fun))
|
|
|
|
|
(list (nth 2 fun))) ;doc
|
|
|
|
|
(interactive
|
|
|
|
|
(list nil)))
|
|
|
|
|
(cond (interactive
|
|
|
|
|
(list (if (or (null (nth 1 interactive))
|
|
|
|
|
(stringp (nth 1 interactive)))
|
|
|
|
|
(nth 1 interactive)
|
|
|
|
|
;; Interactive spec is a list or a variable
|
|
|
|
|
;; (if it is correct).
|
|
|
|
|
(list 'quote (nth 1 interactive))))))))
|
|
|
|
|
;; a non-compiled function (probably trivial)
|
|
|
|
|
(list 'quote fun))))))
|
|
|
|
|
|
|
|
|
|
;; Turn a function into an ordinary lambda. Needed for v18 files.
|
|
|
|
|
(defun byte-compile-byte-code-unmake (function)
|
|
|
|
|
(if (consp function)
|
|
|
|
|
function;;It already is a lambda.
|
|
|
|
|
(setq function (append function nil)) ; turn it into a list
|
|
|
|
|
(nconc (list 'lambda (nth 0 function))
|
|
|
|
|
(and (nth 4 function) (list (nth 4 function)))
|
|
|
|
|
(if (nthcdr 5 function)
|
|
|
|
|
(list (cons 'interactive (if (nth 5 function)
|
|
|
|
|
(nthcdr 5 function)))))
|
|
|
|
|
(list (list 'byte-code
|
|
|
|
|
(nth 1 function) (nth 2 function)
|
|
|
|
|
(nth 3 function))))))
|
|
|
|
|
|
|
|
|
|
|
2001-10-12 14:20:14 +00:00
|
|
|
|
(defun byte-compile-check-lambda-list (list)
|
|
|
|
|
"Check lambda-list LIST for errors."
|
|
|
|
|
(let (vars)
|
|
|
|
|
(while list
|
|
|
|
|
(let ((arg (car list)))
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(when (symbolp arg)
|
|
|
|
|
(byte-compile-set-symbol-position arg))
|
2001-10-18 21:05:16 +00:00
|
|
|
|
(cond ((or (not (symbolp arg))
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(byte-compile-const-symbol-p arg t))
|
2001-10-12 14:20:14 +00:00
|
|
|
|
(error "Invalid lambda variable %s" arg))
|
|
|
|
|
((eq arg '&rest)
|
|
|
|
|
(unless (cdr list)
|
|
|
|
|
(error "&rest without variable name"))
|
|
|
|
|
(when (cddr list)
|
|
|
|
|
(error "Garbage following &rest VAR in lambda-list")))
|
|
|
|
|
((eq arg '&optional)
|
|
|
|
|
(unless (cdr list)
|
|
|
|
|
(error "Variable name missing after &optional")))
|
|
|
|
|
((memq arg vars)
|
2001-10-12 21:59:38 +00:00
|
|
|
|
(byte-compile-warn "repeated variable %s in lambda-list" arg))
|
2001-10-18 21:05:16 +00:00
|
|
|
|
(t
|
2001-10-12 14:20:14 +00:00
|
|
|
|
(push arg vars))))
|
|
|
|
|
(setq list (cdr list)))))
|
|
|
|
|
|
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; Byte-compile a lambda-expression and return a valid function.
|
|
|
|
|
;; The value is usually a compiled function but may be the original
|
|
|
|
|
;; lambda-expression.
|
2005-10-23 07:33:45 +00:00
|
|
|
|
;; When ADD-LAMBDA is non-nil, the symbol `lambda' is added as head
|
|
|
|
|
;; of the list FUN and `byte-compile-set-symbol-position' is not called.
|
|
|
|
|
;; Use this feature to avoid calling `byte-compile-set-symbol-position'
|
|
|
|
|
;; for symbols generated by the byte compiler itself.
|
|
|
|
|
(defun byte-compile-lambda (fun &optional add-lambda)
|
|
|
|
|
(if add-lambda
|
|
|
|
|
(setq fun (cons 'lambda fun))
|
|
|
|
|
(unless (eq 'lambda (car-safe fun))
|
|
|
|
|
(error "Not a lambda list: %S" fun))
|
|
|
|
|
(byte-compile-set-symbol-position 'lambda))
|
2001-10-12 14:20:14 +00:00
|
|
|
|
(byte-compile-check-lambda-list (nth 1 fun))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(let* ((arglist (nth 1 fun))
|
|
|
|
|
(byte-compile-bound-variables
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(nconc (and (byte-compile-warning-enabled-p 'free-vars)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(delq '&rest (delq '&optional (copy-sequence arglist))))
|
|
|
|
|
byte-compile-bound-variables))
|
|
|
|
|
(body (cdr (cdr fun)))
|
|
|
|
|
(doc (if (stringp (car body))
|
|
|
|
|
(prog1 (car body)
|
1996-09-17 19:01:09 +00:00
|
|
|
|
;; Discard the doc string
|
|
|
|
|
;; unless it is the last element of the body.
|
1998-06-04 06:11:30 +00:00
|
|
|
|
(if (cdr body)
|
1996-09-17 19:01:09 +00:00
|
|
|
|
(setq body (cdr body))))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(int (assq 'interactive body)))
|
2003-04-12 20:28:10 +00:00
|
|
|
|
;; Process the interactive spec.
|
|
|
|
|
(when int
|
|
|
|
|
(byte-compile-set-symbol-position 'interactive)
|
|
|
|
|
;; Skip (interactive) if it is in front (the most usual location).
|
|
|
|
|
(if (eq int (car body))
|
|
|
|
|
(setq body (cdr body)))
|
|
|
|
|
(cond ((consp (cdr int))
|
|
|
|
|
(if (cdr (cdr int))
|
|
|
|
|
(byte-compile-warn "malformed interactive spec: %s"
|
|
|
|
|
(prin1-to-string int)))
|
2004-04-16 12:51:06 +00:00
|
|
|
|
;; If the interactive spec is a call to `list', don't
|
|
|
|
|
;; compile it, because `call-interactively' looks at the
|
|
|
|
|
;; args of `list'. Actually, compile it to get warnings,
|
|
|
|
|
;; but don't use the result.
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(let ((form (nth 1 int)))
|
|
|
|
|
(while (memq (car-safe form) '(let let* progn save-excursion))
|
|
|
|
|
(while (consp (cdr form))
|
|
|
|
|
(setq form (cdr form)))
|
|
|
|
|
(setq form (car form)))
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(if (eq (car-safe form) 'list)
|
|
|
|
|
(byte-compile-top-level (nth 1 int))
|
|
|
|
|
(setq int (list 'interactive
|
|
|
|
|
(byte-compile-top-level (nth 1 int)))))))
|
2003-04-12 20:28:10 +00:00
|
|
|
|
((cdr int)
|
|
|
|
|
(byte-compile-warn "malformed interactive spec: %s"
|
|
|
|
|
(prin1-to-string int)))))
|
|
|
|
|
;; Process the body.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(let ((compiled (byte-compile-top-level (cons 'progn body) nil 'lambda)))
|
2003-04-12 20:28:10 +00:00
|
|
|
|
;; Build the actual byte-coded function.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(if (and (eq 'byte-code (car-safe compiled))
|
1993-02-17 20:29:57 +00:00
|
|
|
|
(not (byte-compile-version-cond
|
|
|
|
|
byte-compile-compatibility)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(apply 'make-byte-code
|
|
|
|
|
(append (list arglist)
|
|
|
|
|
;; byte-string, constants-vector, stack depth
|
|
|
|
|
(cdr compiled)
|
|
|
|
|
;; optionally, the doc string.
|
|
|
|
|
(if (or doc int)
|
|
|
|
|
(list doc))
|
|
|
|
|
;; optionally, the interactive spec.
|
|
|
|
|
(if int
|
|
|
|
|
(list (nth 1 int)))))
|
|
|
|
|
(setq compiled
|
|
|
|
|
(nconc (if int (list int))
|
|
|
|
|
(cond ((eq (car-safe compiled) 'progn) (cdr compiled))
|
|
|
|
|
(compiled (list compiled)))))
|
|
|
|
|
(nconc (list 'lambda arglist)
|
|
|
|
|
(if (or doc (stringp (car compiled)))
|
|
|
|
|
(cons doc (cond (compiled)
|
|
|
|
|
(body (list nil))))
|
|
|
|
|
compiled))))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-constants-vector ()
|
|
|
|
|
;; Builds the constants-vector from the current variables and constants.
|
|
|
|
|
;; This modifies the constants from (const . nil) to (const . offset).
|
|
|
|
|
;; To keep the byte-codes to look up the vector as short as possible:
|
|
|
|
|
;; First 6 elements are vars, as there are one-byte varref codes for those.
|
|
|
|
|
;; Next up to byte-constant-limit are constants, still with one-byte codes.
|
|
|
|
|
;; Next variables again, to get 2-byte codes for variable lookup.
|
|
|
|
|
;; The rest of the constants and variables need 3-byte byte-codes.
|
|
|
|
|
(let* ((i -1)
|
|
|
|
|
(rest (nreverse byte-compile-variables)) ; nreverse because the first
|
|
|
|
|
(other (nreverse byte-compile-constants)) ; vars often are used most.
|
|
|
|
|
ret tmp
|
|
|
|
|
(limits '(5 ; Use the 1-byte varref codes,
|
|
|
|
|
63 ; 1-constlim ; 1-byte byte-constant codes,
|
|
|
|
|
255 ; 2-byte varref codes,
|
|
|
|
|
65535)) ; 3-byte codes for the rest.
|
|
|
|
|
limit)
|
|
|
|
|
(while (or rest other)
|
|
|
|
|
(setq limit (car limits))
|
|
|
|
|
(while (and rest (not (eq i limit)))
|
|
|
|
|
(if (setq tmp (assq (car (car rest)) ret))
|
|
|
|
|
(setcdr (car rest) (cdr tmp))
|
|
|
|
|
(setcdr (car rest) (setq i (1+ i)))
|
|
|
|
|
(setq ret (cons (car rest) ret)))
|
|
|
|
|
(setq rest (cdr rest)))
|
|
|
|
|
(setq limits (cdr limits)
|
|
|
|
|
rest (prog1 other
|
|
|
|
|
(setq other rest))))
|
|
|
|
|
(apply 'vector (nreverse (mapcar 'car ret)))))
|
|
|
|
|
|
|
|
|
|
;; Given an expression FORM, compile it and return an equivalent byte-code
|
|
|
|
|
;; expression (a call to the function byte-code).
|
|
|
|
|
(defun byte-compile-top-level (form &optional for-effect output-type)
|
|
|
|
|
;; OUTPUT-TYPE advises about how form is expected to be used:
|
|
|
|
|
;; 'eval or nil -> a single form,
|
|
|
|
|
;; 'progn or t -> a list of forms,
|
|
|
|
|
;; 'lambda -> body of a lambda,
|
|
|
|
|
;; 'file -> used at file-level.
|
1994-08-04 21:47:55 +00:00
|
|
|
|
(let ((byte-compile-constants nil)
|
|
|
|
|
(byte-compile-variables nil)
|
|
|
|
|
(byte-compile-tag-number 0)
|
|
|
|
|
(byte-compile-depth 0)
|
|
|
|
|
(byte-compile-maxdepth 0)
|
|
|
|
|
(byte-compile-output nil))
|
1994-02-25 00:54:15 +00:00
|
|
|
|
(if (memq byte-optimize '(t source))
|
|
|
|
|
(setq form (byte-optimize-form form for-effect)))
|
|
|
|
|
(while (and (eq (car-safe form) 'progn) (null (cdr (cdr form))))
|
|
|
|
|
(setq form (nth 1 form)))
|
|
|
|
|
(if (and (eq 'byte-code (car-safe form))
|
|
|
|
|
(not (memq byte-optimize '(t byte)))
|
|
|
|
|
(stringp (nth 1 form)) (vectorp (nth 2 form))
|
|
|
|
|
(natnump (nth 3 form)))
|
|
|
|
|
form
|
|
|
|
|
(byte-compile-form form for-effect)
|
1994-08-04 21:47:55 +00:00
|
|
|
|
(byte-compile-out-toplevel for-effect output-type))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
(defun byte-compile-out-toplevel (&optional for-effect output-type)
|
|
|
|
|
(if for-effect
|
|
|
|
|
;; The stack is empty. Push a value to be returned from (byte-code ..).
|
|
|
|
|
(if (eq (car (car byte-compile-output)) 'byte-discard)
|
|
|
|
|
(setq byte-compile-output (cdr byte-compile-output))
|
|
|
|
|
(byte-compile-push-constant
|
|
|
|
|
;; Push any constant - preferably one which already is used, and
|
|
|
|
|
;; a number or symbol - ie not some big sequence. The return value
|
|
|
|
|
;; isn't returned, but it would be a shame if some textually large
|
|
|
|
|
;; constant was not optimized away because we chose to return it.
|
|
|
|
|
(and (not (assq nil byte-compile-constants)) ; Nil is often there.
|
|
|
|
|
(let ((tmp (reverse byte-compile-constants)))
|
2002-06-25 01:09:52 +00:00
|
|
|
|
(while (and tmp (not (or (symbolp (caar tmp))
|
|
|
|
|
(numberp (caar tmp)))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(setq tmp (cdr tmp)))
|
2002-06-25 01:09:52 +00:00
|
|
|
|
(caar tmp))))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-out 'byte-return 0)
|
|
|
|
|
(setq byte-compile-output (nreverse byte-compile-output))
|
|
|
|
|
(if (memq byte-optimize '(t byte))
|
|
|
|
|
(setq byte-compile-output
|
|
|
|
|
(byte-optimize-lapcode byte-compile-output for-effect)))
|
2001-10-18 21:05:16 +00:00
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; Decompile trivial functions:
|
|
|
|
|
;; only constants and variables, or a single funcall except in lambdas.
|
|
|
|
|
;; Except for Lisp_Compiled objects, forms like (foo "hi")
|
|
|
|
|
;; are still quicker than (byte-code "..." [foo "hi"] 2).
|
|
|
|
|
;; Note that even (quote foo) must be parsed just as any subr by the
|
|
|
|
|
;; interpreter, so quote should be compiled into byte-code in some contexts.
|
|
|
|
|
;; What to leave uncompiled:
|
1995-03-24 23:43:21 +00:00
|
|
|
|
;; lambda -> never. we used to leave it uncompiled if the body was
|
|
|
|
|
;; a single atom, but that causes confusion if the docstring
|
|
|
|
|
;; uses the (file . pos) syntax. Besides, now that we have
|
|
|
|
|
;; the Lisp_Compiled type, the compiled form is faster.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; eval -> atom, quote or (function atom atom atom)
|
|
|
|
|
;; progn -> as <<same-as-eval>> or (progn <<same-as-eval>> atom)
|
|
|
|
|
;; file -> as progn, but takes both quotes and atoms, and longer forms.
|
|
|
|
|
(let (rest
|
|
|
|
|
(maycall (not (eq output-type 'lambda))) ; t if we may make a funcall.
|
|
|
|
|
tmp body)
|
|
|
|
|
(cond
|
|
|
|
|
;; #### This should be split out into byte-compile-nontrivial-function-p.
|
1995-03-24 23:43:21 +00:00
|
|
|
|
((or (eq output-type 'lambda)
|
|
|
|
|
(nthcdr (if (eq output-type 'file) 50 8) byte-compile-output)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(assq 'TAG byte-compile-output) ; Not necessary, but speeds up a bit.
|
|
|
|
|
(not (setq tmp (assq 'byte-return byte-compile-output)))
|
|
|
|
|
(progn
|
|
|
|
|
(setq rest (nreverse
|
|
|
|
|
(cdr (memq tmp (reverse byte-compile-output)))))
|
|
|
|
|
(while (cond
|
|
|
|
|
((memq (car (car rest)) '(byte-varref byte-constant))
|
|
|
|
|
(setq tmp (car (cdr (car rest))))
|
1996-09-10 19:22:12 +00:00
|
|
|
|
(if (if (eq (car (car rest)) 'byte-constant)
|
|
|
|
|
(or (consp tmp)
|
|
|
|
|
(and (symbolp tmp)
|
2000-02-23 12:29:05 +00:00
|
|
|
|
(not (byte-compile-const-symbol-p tmp)))))
|
1996-09-10 19:22:12 +00:00
|
|
|
|
(if maycall
|
|
|
|
|
(setq body (cons (list 'quote tmp) body)))
|
|
|
|
|
(setq body (cons tmp body))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
((and maycall
|
|
|
|
|
;; Allow a funcall if at most one atom follows it.
|
|
|
|
|
(null (nthcdr 3 rest))
|
|
|
|
|
(setq tmp (get (car (car rest)) 'byte-opcode-invert))
|
|
|
|
|
(or (null (cdr rest))
|
|
|
|
|
(and (memq output-type '(file progn t))
|
|
|
|
|
(cdr (cdr rest))
|
|
|
|
|
(eq (car (nth 1 rest)) 'byte-discard)
|
|
|
|
|
(progn (setq rest (cdr rest)) t))))
|
|
|
|
|
(setq maycall nil) ; Only allow one real function call.
|
|
|
|
|
(setq body (nreverse body))
|
|
|
|
|
(setq body (list
|
|
|
|
|
(if (and (eq tmp 'funcall)
|
|
|
|
|
(eq (car-safe (car body)) 'quote))
|
|
|
|
|
(cons (nth 1 (car body)) (cdr body))
|
|
|
|
|
(cons tmp body))))
|
|
|
|
|
(or (eq output-type 'file)
|
|
|
|
|
(not (delq nil (mapcar 'consp (cdr (car body))))))))
|
|
|
|
|
(setq rest (cdr rest)))
|
1995-03-24 23:43:21 +00:00
|
|
|
|
rest))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(let ((byte-compile-vector (byte-compile-constants-vector)))
|
|
|
|
|
(list 'byte-code (byte-compile-lapcode byte-compile-output)
|
|
|
|
|
byte-compile-vector byte-compile-maxdepth)))
|
|
|
|
|
;; it's a trivial function
|
|
|
|
|
((cdr body) (cons 'progn (nreverse body)))
|
|
|
|
|
((car body)))))
|
|
|
|
|
|
|
|
|
|
;; Given BODY, compile it and return a new body.
|
|
|
|
|
(defun byte-compile-top-level-body (body &optional for-effect)
|
|
|
|
|
(setq body (byte-compile-top-level (cons 'progn body) for-effect t))
|
|
|
|
|
(cond ((eq (car-safe body) 'progn)
|
|
|
|
|
(cdr body))
|
|
|
|
|
(body
|
|
|
|
|
(list body))))
|
2007-11-17 03:46:23 +00:00
|
|
|
|
|
|
|
|
|
(put 'declare-function 'byte-hunk-handler 'byte-compile-declare-function)
|
|
|
|
|
(defun byte-compile-declare-function (form)
|
|
|
|
|
(push (cons (nth 1 form)
|
2007-12-02 21:41:33 +00:00
|
|
|
|
(if (and (> (length form) 3)
|
|
|
|
|
(listp (nth 3 form)))
|
|
|
|
|
(list 'declared (nth 3 form))
|
|
|
|
|
t)) ; arglist not specified
|
2007-11-17 03:46:23 +00:00
|
|
|
|
byte-compile-function-environment)
|
2007-12-05 03:36:23 +00:00
|
|
|
|
;; We are stating that it _will_ be defined at runtime.
|
|
|
|
|
(setq byte-compile-noruntime-functions
|
|
|
|
|
(delq (nth 1 form) byte-compile-noruntime-functions))
|
2007-11-17 03:46:23 +00:00
|
|
|
|
nil)
|
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2000-03-29 21:32:57 +00:00
|
|
|
|
;; This is the recursive entry point for compiling each subform of an
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; expression.
|
|
|
|
|
;; If for-effect is non-nil, byte-compile-form will output a byte-discard
|
|
|
|
|
;; before terminating (ie no value will be left on the stack).
|
|
|
|
|
;; A byte-compile handler may, when for-effect is non-nil, choose output code
|
|
|
|
|
;; which does not leave a value on the stack, and then set for-effect to nil
|
|
|
|
|
;; (to prevent byte-compile-form from outputting the byte-discard).
|
|
|
|
|
;; If a handler wants to call another handler, it should do so via
|
|
|
|
|
;; byte-compile-form, or take extreme care to handle for-effect correctly.
|
|
|
|
|
;; (Use byte-compile-form-do-effect to reset the for-effect flag too.)
|
|
|
|
|
;;
|
|
|
|
|
(defun byte-compile-form (form &optional for-effect)
|
|
|
|
|
(setq form (macroexpand form byte-compile-macro-environment))
|
|
|
|
|
(cond ((not (consp form))
|
2000-02-23 12:29:05 +00:00
|
|
|
|
(cond ((or (not (symbolp form)) (byte-compile-const-symbol-p form))
|
2004-11-21 00:47:13 +00:00
|
|
|
|
(when (symbolp form)
|
|
|
|
|
(byte-compile-set-symbol-position form))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-constant form))
|
|
|
|
|
((and for-effect byte-compile-delete-errors)
|
2004-11-21 00:47:13 +00:00
|
|
|
|
(when (symbolp form)
|
|
|
|
|
(byte-compile-set-symbol-position form))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(setq for-effect nil))
|
|
|
|
|
(t (byte-compile-variable-ref 'byte-varref form))))
|
|
|
|
|
((symbolp (car form))
|
|
|
|
|
(let* ((fn (car form))
|
|
|
|
|
(handler (get fn 'byte-compile)))
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(when (byte-compile-const-symbol-p fn)
|
2004-06-13 22:01:36 +00:00
|
|
|
|
(byte-compile-warn "`%s' called as a function" fn))
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(and (byte-compile-warning-enabled-p 'interactive-only)
|
2005-05-14 12:30:08 +00:00
|
|
|
|
(memq fn byte-compile-interactive-only-functions)
|
2004-11-02 09:22:16 +00:00
|
|
|
|
(byte-compile-warn "`%s' used from Lisp code\n\
|
|
|
|
|
That command is designed for interactive use only" fn))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(if (and handler
|
2006-04-08 14:56:21 +00:00
|
|
|
|
;; Make sure that function exists. This is important
|
|
|
|
|
;; for CL compiler macros since the symbol may be
|
|
|
|
|
;; `cl-byte-compile-compiler-macro' but if CL isn't
|
|
|
|
|
;; loaded, this function doesn't exist.
|
|
|
|
|
(or (not (memq handler '(cl-byte-compile-compiler-macro)))
|
2006-07-07 16:34:44 +00:00
|
|
|
|
(functionp handler))
|
2006-04-08 14:56:21 +00:00
|
|
|
|
(not (and (byte-compile-version-cond
|
|
|
|
|
byte-compile-compatibility)
|
|
|
|
|
(get (get fn 'byte-opcode) 'emacs19-opcode))))
|
2005-10-23 07:33:45 +00:00
|
|
|
|
(funcall handler form)
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(when (byte-compile-warning-enabled-p 'callargs)
|
2005-05-14 12:30:08 +00:00
|
|
|
|
(if (memq fn '(custom-declare-group custom-declare-variable custom-declare-face))
|
|
|
|
|
(byte-compile-nogroup-warn form))
|
|
|
|
|
(byte-compile-callargs-warn form))
|
2002-07-02 18:48:34 +00:00
|
|
|
|
(byte-compile-normal-call form))
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(if (byte-compile-warning-enabled-p 'cl-functions)
|
2002-07-02 18:48:34 +00:00
|
|
|
|
(byte-compile-cl-warn form))))
|
* disass.el (disassemble): Add autoload cookie for this.
* bytecomp.el (byte-decompile-bytecode): Add an autoload for this.
compiled-function-p has been renamed to byte-code-function-p.
* subr.el: Define compiled-function-p as an alias for it.
* bytecomp.el: Register compiled-function-p as obsolete.
* bytecomp.el, byte-opt.el, disass.el, help.el, map-ynp.el: Change
uses.
unread-command-event has been replaced by unread-command-events.
* simple.el (prefix-arg-internal): Use this to push back all
key sequences for processing by the main command loop, instead of
trying to simulate its behavior ourselves.
* bytecomp.el: Document unread-command-event as an obsolete
variable, although nothing but the GNU Emacs 19 sources use it.
Adjust obsolescence message for unread-command-char.
* comint.el (comint-dynamic-list-completions): Change uses of
unread-command-event to work with unread-command-events.
* ebuff-menu.el (electric-buffer-list, Electric-buffer-menu-exit):
Same.
* edebug.el (edebug-outside-excursion): Same.
* ehelp.el (electric-help-command-loop): Same.
* electric.el (Electric-command-loop): Same.
* emerge.el (emerge-show-file-name): Same.
* fortran.el (fortran-abbrev-start,
fortran-window-create-momentarily): Same.
* gnus.el (gnus-Subject-next-article): Same.
* info.el (Info-summary): Same.
* isearch-mode.el (isearch-update, isearch-unread): Same.
* map-ynp.el (map-y-or-n-p): Same.
* mlsupport.el (push-back-character): Same.
* replace.el (perform-replace): Same.
* simula.el (simula-electric-label): Same.
* subr.el (read-quoted-char, momentary-string-display): Same.
* sun-mouse.el (mouse-second-hit): Same.
* terminal.el (te-escape-extended-command-unread): Same.
* vip.el (vip-escape-to-emacs, vip-prefix-arg-value,
vip-prefix-arg-com): Same.
1993-01-26 01:36:02 +00:00
|
|
|
|
((and (or (byte-code-function-p (car form))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(eq (car-safe (car form)) 'lambda))
|
|
|
|
|
;; if the form comes out the same way it went in, that's
|
|
|
|
|
;; because it was malformed, and we couldn't unfold it.
|
|
|
|
|
(not (eq form (setq form (byte-compile-unfold-lambda form)))))
|
|
|
|
|
(byte-compile-form form for-effect)
|
|
|
|
|
(setq for-effect nil))
|
|
|
|
|
((byte-compile-normal-call form)))
|
|
|
|
|
(if for-effect
|
|
|
|
|
(byte-compile-discard)))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-normal-call (form)
|
|
|
|
|
(if byte-compile-generate-call-tree
|
|
|
|
|
(byte-compile-annotate-call-tree form))
|
2007-09-21 07:13:28 +00:00
|
|
|
|
(when (and for-effect (eq (car form) 'mapcar)
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(byte-compile-warning-enabled-p 'mapcar))
|
2007-09-21 04:24:53 +00:00
|
|
|
|
(byte-compile-set-symbol-position 'mapcar)
|
|
|
|
|
(byte-compile-warn
|
|
|
|
|
"`mapcar' called for effect; use `mapc' or `dolist' instead"))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-push-constant (car form))
|
2000-05-26 10:35:38 +00:00
|
|
|
|
(mapc 'byte-compile-form (cdr form)) ; wasteful, but faster.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-out 'byte-call (length (cdr form))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-variable-ref (base-op var)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(when (symbolp var)
|
|
|
|
|
(byte-compile-set-symbol-position var))
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(if (or (not (symbolp var))
|
|
|
|
|
(byte-compile-const-symbol-p var (not (eq base-op 'byte-varref))))
|
|
|
|
|
(byte-compile-warn
|
2004-06-13 22:01:36 +00:00
|
|
|
|
(cond ((eq base-op 'byte-varbind) "attempt to let-bind %s `%s'")
|
|
|
|
|
((eq base-op 'byte-varset) "variable assignment to %s `%s'")
|
|
|
|
|
(t "variable reference to %s `%s'"))
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(if (symbolp var) "constant" "nonvariable")
|
|
|
|
|
(prin1-to-string var))
|
2008-04-26 02:32:51 +00:00
|
|
|
|
(and (get var 'byte-obsolete-variable)
|
|
|
|
|
(not (eq var byte-compile-not-obsolete-var))
|
|
|
|
|
(byte-compile-warn-obsolete var))
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(if (byte-compile-warning-enabled-p 'free-vars)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(if (eq base-op 'byte-varbind)
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(push var byte-compile-bound-variables)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(or (boundp var)
|
|
|
|
|
(memq var byte-compile-bound-variables)
|
|
|
|
|
(if (eq base-op 'byte-varset)
|
|
|
|
|
(or (memq var byte-compile-free-assignments)
|
|
|
|
|
(progn
|
2004-06-13 22:01:36 +00:00
|
|
|
|
(byte-compile-warn "assignment to free variable `%s'" var)
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(push var byte-compile-free-assignments)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(or (memq var byte-compile-free-references)
|
|
|
|
|
(progn
|
2004-06-13 22:01:36 +00:00
|
|
|
|
(byte-compile-warn "reference to free variable `%s'" var)
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(push var byte-compile-free-references))))))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(let ((tmp (assq var byte-compile-variables)))
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(unless tmp
|
|
|
|
|
(setq tmp (list var))
|
|
|
|
|
(push tmp byte-compile-variables))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-out base-op tmp)))
|
|
|
|
|
|
|
|
|
|
(defmacro byte-compile-get-constant (const)
|
2000-02-23 12:29:05 +00:00
|
|
|
|
`(or (if (stringp ,const)
|
2006-11-28 02:22:17 +00:00
|
|
|
|
;; In a string constant, treat properties as significant.
|
|
|
|
|
(let (result)
|
|
|
|
|
(dolist (elt byte-compile-constants)
|
|
|
|
|
(if (equal-including-properties (car elt) ,const)
|
|
|
|
|
(setq result elt)))
|
|
|
|
|
result)
|
2000-02-23 12:29:05 +00:00
|
|
|
|
(assq ,const byte-compile-constants))
|
|
|
|
|
(car (setq byte-compile-constants
|
|
|
|
|
(cons (list ,const) byte-compile-constants)))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;; Use this when the value of a form is a constant. This obeys for-effect.
|
|
|
|
|
(defun byte-compile-constant (const)
|
|
|
|
|
(if for-effect
|
|
|
|
|
(setq for-effect nil)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(when (symbolp const)
|
|
|
|
|
(byte-compile-set-symbol-position const))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-out 'byte-constant (byte-compile-get-constant const))))
|
|
|
|
|
|
|
|
|
|
;; Use this for a constant that is not the value of its containing form.
|
|
|
|
|
;; This ignores for-effect.
|
|
|
|
|
(defun byte-compile-push-constant (const)
|
|
|
|
|
(let ((for-effect nil))
|
|
|
|
|
(inline (byte-compile-constant const))))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
;; Compile those primitive ordinary functions
|
|
|
|
|
;; which have special byte codes just for speed.
|
|
|
|
|
|
|
|
|
|
(defmacro byte-defop-compiler (function &optional compile-handler)
|
|
|
|
|
;; add a compiler-form for FUNCTION.
|
|
|
|
|
;; If function is a symbol, then the variable "byte-SYMBOL" must name
|
|
|
|
|
;; the opcode to be used. If function is a list, the first element
|
|
|
|
|
;; is the function and the second element is the bytecode-symbol.
|
2003-05-28 11:26:45 +00:00
|
|
|
|
;; The second element may be nil, meaning there is no opcode.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; COMPILE-HANDLER is the function to use to compile this byte-op, or
|
|
|
|
|
;; may be the abbreviations 0, 1, 2, 3, 0-1, or 1-2.
|
|
|
|
|
;; If it is nil, then the handler is "byte-compile-SYMBOL."
|
|
|
|
|
(let (opcode)
|
|
|
|
|
(if (symbolp function)
|
|
|
|
|
(setq opcode (intern (concat "byte-" (symbol-name function))))
|
|
|
|
|
(setq opcode (car (cdr function))
|
|
|
|
|
function (car function)))
|
|
|
|
|
(let ((fnform
|
|
|
|
|
(list 'put (list 'quote function) ''byte-compile
|
|
|
|
|
(list 'quote
|
|
|
|
|
(or (cdr (assq compile-handler
|
|
|
|
|
'((0 . byte-compile-no-args)
|
|
|
|
|
(1 . byte-compile-one-arg)
|
|
|
|
|
(2 . byte-compile-two-args)
|
|
|
|
|
(3 . byte-compile-three-args)
|
|
|
|
|
(0-1 . byte-compile-zero-or-one-arg)
|
|
|
|
|
(1-2 . byte-compile-one-or-two-args)
|
|
|
|
|
(2-3 . byte-compile-two-or-three-args)
|
|
|
|
|
)))
|
|
|
|
|
compile-handler
|
|
|
|
|
(intern (concat "byte-compile-"
|
|
|
|
|
(symbol-name function))))))))
|
|
|
|
|
(if opcode
|
|
|
|
|
(list 'progn fnform
|
|
|
|
|
(list 'put (list 'quote function)
|
|
|
|
|
''byte-opcode (list 'quote opcode))
|
|
|
|
|
(list 'put (list 'quote opcode)
|
|
|
|
|
''byte-opcode-invert (list 'quote function)))
|
|
|
|
|
fnform))))
|
|
|
|
|
|
|
|
|
|
(defmacro byte-defop-compiler19 (function &optional compile-handler)
|
|
|
|
|
;; Just like byte-defop-compiler, but defines an opcode that will only
|
1993-06-11 16:19:49 +00:00
|
|
|
|
;; be used when byte-compile-compatibility is false.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(if (and (byte-compile-single-version)
|
1993-06-11 16:19:49 +00:00
|
|
|
|
byte-compile-compatibility)
|
1992-08-12 12:57:12 +00:00
|
|
|
|
;; #### instead of doing nothing, this should do some remprops,
|
|
|
|
|
;; #### to protect against the case where a single-version compiler
|
|
|
|
|
;; #### is loaded into a world that has contained a multi-version one.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
nil
|
|
|
|
|
(list 'progn
|
|
|
|
|
(list 'put
|
|
|
|
|
(list 'quote
|
|
|
|
|
(or (car (cdr-safe function))
|
|
|
|
|
(intern (concat "byte-"
|
|
|
|
|
(symbol-name (or (car-safe function) function))))))
|
|
|
|
|
''emacs19-opcode t)
|
|
|
|
|
(list 'byte-defop-compiler function compile-handler))))
|
|
|
|
|
|
|
|
|
|
(defmacro byte-defop-compiler-1 (function &optional compile-handler)
|
|
|
|
|
(list 'byte-defop-compiler (list function nil) compile-handler))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(put 'byte-call 'byte-opcode-invert 'funcall)
|
|
|
|
|
(put 'byte-list1 'byte-opcode-invert 'list)
|
|
|
|
|
(put 'byte-list2 'byte-opcode-invert 'list)
|
|
|
|
|
(put 'byte-list3 'byte-opcode-invert 'list)
|
|
|
|
|
(put 'byte-list4 'byte-opcode-invert 'list)
|
|
|
|
|
(put 'byte-listN 'byte-opcode-invert 'list)
|
|
|
|
|
(put 'byte-concat2 'byte-opcode-invert 'concat)
|
|
|
|
|
(put 'byte-concat3 'byte-opcode-invert 'concat)
|
|
|
|
|
(put 'byte-concat4 'byte-opcode-invert 'concat)
|
|
|
|
|
(put 'byte-concatN 'byte-opcode-invert 'concat)
|
|
|
|
|
(put 'byte-insertN 'byte-opcode-invert 'insert)
|
|
|
|
|
|
|
|
|
|
(byte-defop-compiler point 0)
|
|
|
|
|
;;(byte-defop-compiler mark 0) ;; obsolete
|
|
|
|
|
(byte-defop-compiler point-max 0)
|
|
|
|
|
(byte-defop-compiler point-min 0)
|
|
|
|
|
(byte-defop-compiler following-char 0)
|
|
|
|
|
(byte-defop-compiler preceding-char 0)
|
|
|
|
|
(byte-defop-compiler current-column 0)
|
|
|
|
|
(byte-defop-compiler eolp 0)
|
|
|
|
|
(byte-defop-compiler eobp 0)
|
|
|
|
|
(byte-defop-compiler bolp 0)
|
|
|
|
|
(byte-defop-compiler bobp 0)
|
|
|
|
|
(byte-defop-compiler current-buffer 0)
|
|
|
|
|
;;(byte-defop-compiler read-char 0) ;; obsolete
|
|
|
|
|
(byte-defop-compiler interactive-p 0)
|
|
|
|
|
(byte-defop-compiler19 widen 0)
|
|
|
|
|
(byte-defop-compiler19 end-of-line 0-1)
|
|
|
|
|
(byte-defop-compiler19 forward-char 0-1)
|
|
|
|
|
(byte-defop-compiler19 forward-line 0-1)
|
|
|
|
|
(byte-defop-compiler symbolp 1)
|
|
|
|
|
(byte-defop-compiler consp 1)
|
|
|
|
|
(byte-defop-compiler stringp 1)
|
|
|
|
|
(byte-defop-compiler listp 1)
|
|
|
|
|
(byte-defop-compiler not 1)
|
|
|
|
|
(byte-defop-compiler (null byte-not) 1)
|
|
|
|
|
(byte-defop-compiler car 1)
|
|
|
|
|
(byte-defop-compiler cdr 1)
|
|
|
|
|
(byte-defop-compiler length 1)
|
|
|
|
|
(byte-defop-compiler symbol-value 1)
|
|
|
|
|
(byte-defop-compiler symbol-function 1)
|
|
|
|
|
(byte-defop-compiler (1+ byte-add1) 1)
|
|
|
|
|
(byte-defop-compiler (1- byte-sub1) 1)
|
|
|
|
|
(byte-defop-compiler goto-char 1)
|
1997-07-10 10:55:23 +00:00
|
|
|
|
(byte-defop-compiler char-after 0-1)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-defop-compiler set-buffer 1)
|
|
|
|
|
;;(byte-defop-compiler set-mark 1) ;; obsolete
|
2004-08-14 10:01:55 +00:00
|
|
|
|
(byte-defop-compiler19 forward-word 0-1)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-defop-compiler19 char-syntax 1)
|
|
|
|
|
(byte-defop-compiler19 nreverse 1)
|
|
|
|
|
(byte-defop-compiler19 car-safe 1)
|
|
|
|
|
(byte-defop-compiler19 cdr-safe 1)
|
|
|
|
|
(byte-defop-compiler19 numberp 1)
|
|
|
|
|
(byte-defop-compiler19 integerp 1)
|
|
|
|
|
(byte-defop-compiler19 skip-chars-forward 1-2)
|
|
|
|
|
(byte-defop-compiler19 skip-chars-backward 1-2)
|
|
|
|
|
(byte-defop-compiler eq 2)
|
|
|
|
|
(byte-defop-compiler memq 2)
|
|
|
|
|
(byte-defop-compiler cons 2)
|
|
|
|
|
(byte-defop-compiler aref 2)
|
|
|
|
|
(byte-defop-compiler set 2)
|
|
|
|
|
(byte-defop-compiler (= byte-eqlsign) 2)
|
|
|
|
|
(byte-defop-compiler (< byte-lss) 2)
|
|
|
|
|
(byte-defop-compiler (> byte-gtr) 2)
|
|
|
|
|
(byte-defop-compiler (<= byte-leq) 2)
|
|
|
|
|
(byte-defop-compiler (>= byte-geq) 2)
|
|
|
|
|
(byte-defop-compiler get 2)
|
|
|
|
|
(byte-defop-compiler nth 2)
|
|
|
|
|
(byte-defop-compiler substring 2-3)
|
1992-08-12 12:57:12 +00:00
|
|
|
|
(byte-defop-compiler19 (move-marker byte-set-marker) 2-3)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-defop-compiler19 set-marker 2-3)
|
|
|
|
|
(byte-defop-compiler19 match-beginning 1)
|
|
|
|
|
(byte-defop-compiler19 match-end 1)
|
|
|
|
|
(byte-defop-compiler19 upcase 1)
|
|
|
|
|
(byte-defop-compiler19 downcase 1)
|
|
|
|
|
(byte-defop-compiler19 string= 2)
|
|
|
|
|
(byte-defop-compiler19 string< 2)
|
1992-08-12 12:57:12 +00:00
|
|
|
|
(byte-defop-compiler19 (string-equal byte-string=) 2)
|
|
|
|
|
(byte-defop-compiler19 (string-lessp byte-string<) 2)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-defop-compiler19 equal 2)
|
|
|
|
|
(byte-defop-compiler19 nthcdr 2)
|
|
|
|
|
(byte-defop-compiler19 elt 2)
|
|
|
|
|
(byte-defop-compiler19 member 2)
|
|
|
|
|
(byte-defop-compiler19 assq 2)
|
1992-08-12 12:57:12 +00:00
|
|
|
|
(byte-defop-compiler19 (rplaca byte-setcar) 2)
|
|
|
|
|
(byte-defop-compiler19 (rplacd byte-setcdr) 2)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-defop-compiler19 setcar 2)
|
|
|
|
|
(byte-defop-compiler19 setcdr 2)
|
|
|
|
|
(byte-defop-compiler19 buffer-substring 2)
|
|
|
|
|
(byte-defop-compiler19 delete-region 2)
|
|
|
|
|
(byte-defop-compiler19 narrow-to-region 2)
|
|
|
|
|
(byte-defop-compiler19 (% byte-rem) 2)
|
|
|
|
|
(byte-defop-compiler aset 3)
|
|
|
|
|
|
|
|
|
|
(byte-defop-compiler max byte-compile-associative)
|
|
|
|
|
(byte-defop-compiler min byte-compile-associative)
|
|
|
|
|
(byte-defop-compiler (+ byte-plus) byte-compile-associative)
|
|
|
|
|
(byte-defop-compiler19 (* byte-mult) byte-compile-associative)
|
|
|
|
|
|
|
|
|
|
;;####(byte-defop-compiler19 move-to-column 1)
|
|
|
|
|
(byte-defop-compiler-1 interactive byte-compile-noop)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-subr-wrong-args (form n)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(byte-compile-set-symbol-position (car form))
|
2004-06-13 22:01:36 +00:00
|
|
|
|
(byte-compile-warn "`%s' called with %d arg%s, but requires %s"
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(car form) (length (cdr form))
|
|
|
|
|
(if (= 1 (length (cdr form))) "" "s") n)
|
|
|
|
|
;; get run-time wrong-number-of-args error.
|
|
|
|
|
(byte-compile-normal-call form))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-no-args (form)
|
|
|
|
|
(if (not (= (length form) 1))
|
|
|
|
|
(byte-compile-subr-wrong-args form "none")
|
|
|
|
|
(byte-compile-out (get (car form) 'byte-opcode) 0)))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-one-arg (form)
|
|
|
|
|
(if (not (= (length form) 2))
|
|
|
|
|
(byte-compile-subr-wrong-args form 1)
|
|
|
|
|
(byte-compile-form (car (cdr form))) ;; Push the argument
|
|
|
|
|
(byte-compile-out (get (car form) 'byte-opcode) 0)))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-two-args (form)
|
|
|
|
|
(if (not (= (length form) 3))
|
|
|
|
|
(byte-compile-subr-wrong-args form 2)
|
|
|
|
|
(byte-compile-form (car (cdr form))) ;; Push the arguments
|
|
|
|
|
(byte-compile-form (nth 2 form))
|
|
|
|
|
(byte-compile-out (get (car form) 'byte-opcode) 0)))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-three-args (form)
|
|
|
|
|
(if (not (= (length form) 4))
|
|
|
|
|
(byte-compile-subr-wrong-args form 3)
|
|
|
|
|
(byte-compile-form (car (cdr form))) ;; Push the arguments
|
|
|
|
|
(byte-compile-form (nth 2 form))
|
|
|
|
|
(byte-compile-form (nth 3 form))
|
|
|
|
|
(byte-compile-out (get (car form) 'byte-opcode) 0)))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-zero-or-one-arg (form)
|
|
|
|
|
(let ((len (length form)))
|
|
|
|
|
(cond ((= len 1) (byte-compile-one-arg (append form '(nil))))
|
|
|
|
|
((= len 2) (byte-compile-one-arg form))
|
|
|
|
|
(t (byte-compile-subr-wrong-args form "0-1")))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-one-or-two-args (form)
|
|
|
|
|
(let ((len (length form)))
|
|
|
|
|
(cond ((= len 2) (byte-compile-two-args (append form '(nil))))
|
|
|
|
|
((= len 3) (byte-compile-two-args form))
|
|
|
|
|
(t (byte-compile-subr-wrong-args form "1-2")))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-two-or-three-args (form)
|
|
|
|
|
(let ((len (length form)))
|
|
|
|
|
(cond ((= len 3) (byte-compile-three-args (append form '(nil))))
|
|
|
|
|
((= len 4) (byte-compile-three-args form))
|
|
|
|
|
(t (byte-compile-subr-wrong-args form "2-3")))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-noop (form)
|
|
|
|
|
(byte-compile-constant nil))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-discard ()
|
|
|
|
|
(byte-compile-out 'byte-discard 0))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
;; Compile a function that accepts one or more args and is right-associative.
|
1995-11-10 17:16:57 +00:00
|
|
|
|
;; We do it by left-associativity so that the operations
|
|
|
|
|
;; are done in the same order as in interpreted code.
|
1996-08-29 06:20:21 +00:00
|
|
|
|
;; We treat the one-arg case, as in (+ x), like (+ x 0).
|
|
|
|
|
;; in order to convert markers to numbers, and trigger expected errors.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defun byte-compile-associative (form)
|
|
|
|
|
(if (cdr form)
|
1995-11-10 17:16:57 +00:00
|
|
|
|
(let ((opcode (get (car form) 'byte-opcode))
|
2008-11-14 18:08:10 +00:00
|
|
|
|
args)
|
|
|
|
|
(if (and (< 3 (length form))
|
|
|
|
|
(memq opcode (list (get '+ 'byte-opcode)
|
|
|
|
|
(get '* 'byte-opcode))))
|
|
|
|
|
;; Don't use binary operations for > 2 operands, as that
|
|
|
|
|
;; may cause overflow/truncation in float operations.
|
|
|
|
|
(byte-compile-normal-call form)
|
|
|
|
|
(setq args (copy-sequence (cdr form)))
|
|
|
|
|
(byte-compile-form (car args))
|
|
|
|
|
(setq args (cdr args))
|
|
|
|
|
(or args (setq args '(0)
|
|
|
|
|
opcode (get '+ 'byte-opcode)))
|
|
|
|
|
(dolist (arg args)
|
|
|
|
|
(byte-compile-form arg)
|
|
|
|
|
(byte-compile-out opcode 0))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-constant (eval form))))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
;; more complicated compiler macros
|
|
|
|
|
|
2007-04-10 03:54:36 +00:00
|
|
|
|
(byte-defop-compiler char-before)
|
2007-04-11 03:59:20 +00:00
|
|
|
|
(byte-defop-compiler backward-char)
|
|
|
|
|
(byte-defop-compiler backward-word)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-defop-compiler list)
|
|
|
|
|
(byte-defop-compiler concat)
|
|
|
|
|
(byte-defop-compiler fset)
|
|
|
|
|
(byte-defop-compiler (indent-to-column byte-indent-to) byte-compile-indent-to)
|
|
|
|
|
(byte-defop-compiler indent-to)
|
|
|
|
|
(byte-defop-compiler insert)
|
|
|
|
|
(byte-defop-compiler-1 function byte-compile-function-form)
|
|
|
|
|
(byte-defop-compiler-1 - byte-compile-minus)
|
|
|
|
|
(byte-defop-compiler19 (/ byte-quo) byte-compile-quo)
|
|
|
|
|
(byte-defop-compiler19 nconc)
|
|
|
|
|
|
2007-04-10 03:54:36 +00:00
|
|
|
|
(defun byte-compile-char-before (form)
|
|
|
|
|
(cond ((= 2 (length form))
|
2007-04-11 03:59:20 +00:00
|
|
|
|
(byte-compile-form (list 'char-after (if (numberp (nth 1 form))
|
|
|
|
|
(1- (nth 1 form))
|
|
|
|
|
`(1- ,(nth 1 form))))))
|
|
|
|
|
((= 1 (length form))
|
|
|
|
|
(byte-compile-form '(char-after (1- (point)))))
|
|
|
|
|
(t (byte-compile-subr-wrong-args form "0-1"))))
|
|
|
|
|
|
|
|
|
|
;; backward-... ==> forward-... with negated argument.
|
|
|
|
|
(defun byte-compile-backward-char (form)
|
|
|
|
|
(cond ((= 2 (length form))
|
|
|
|
|
(byte-compile-form (list 'forward-char (if (numberp (nth 1 form))
|
|
|
|
|
(- (nth 1 form))
|
|
|
|
|
`(- ,(nth 1 form))))))
|
|
|
|
|
((= 1 (length form))
|
|
|
|
|
(byte-compile-form '(forward-char -1)))
|
|
|
|
|
(t (byte-compile-subr-wrong-args form "0-1"))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-backward-word (form)
|
|
|
|
|
(cond ((= 2 (length form))
|
|
|
|
|
(byte-compile-form (list 'forward-word (if (numberp (nth 1 form))
|
|
|
|
|
(- (nth 1 form))
|
|
|
|
|
`(- ,(nth 1 form))))))
|
|
|
|
|
((= 1 (length form))
|
|
|
|
|
(byte-compile-form '(forward-word -1)))
|
|
|
|
|
(t (byte-compile-subr-wrong-args form "0-1"))))
|
2007-04-10 03:54:36 +00:00
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defun byte-compile-list (form)
|
|
|
|
|
(let ((count (length (cdr form))))
|
|
|
|
|
(cond ((= count 0)
|
|
|
|
|
(byte-compile-constant nil))
|
|
|
|
|
((< count 5)
|
2000-05-26 10:35:38 +00:00
|
|
|
|
(mapc 'byte-compile-form (cdr form))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-out
|
|
|
|
|
(aref [byte-list1 byte-list2 byte-list3 byte-list4] (1- count)) 0))
|
1993-06-11 16:19:49 +00:00
|
|
|
|
((and (< count 256) (not (byte-compile-version-cond
|
|
|
|
|
byte-compile-compatibility)))
|
2000-05-26 10:35:38 +00:00
|
|
|
|
(mapc 'byte-compile-form (cdr form))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-out 'byte-listN count))
|
|
|
|
|
(t (byte-compile-normal-call form)))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-concat (form)
|
|
|
|
|
(let ((count (length (cdr form))))
|
|
|
|
|
(cond ((and (< 1 count) (< count 5))
|
2000-05-26 10:35:38 +00:00
|
|
|
|
(mapc 'byte-compile-form (cdr form))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-out
|
|
|
|
|
(aref [byte-concat2 byte-concat3 byte-concat4] (- count 2))
|
|
|
|
|
0))
|
|
|
|
|
;; Concat of one arg is not a no-op if arg is not a string.
|
|
|
|
|
((= count 0)
|
|
|
|
|
(byte-compile-form ""))
|
1993-06-11 16:19:49 +00:00
|
|
|
|
((and (< count 256) (not (byte-compile-version-cond
|
|
|
|
|
byte-compile-compatibility)))
|
2000-05-26 10:35:38 +00:00
|
|
|
|
(mapc 'byte-compile-form (cdr form))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-out 'byte-concatN count))
|
|
|
|
|
((byte-compile-normal-call form)))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-minus (form)
|
2008-11-14 18:08:10 +00:00
|
|
|
|
(let ((len (length form)))
|
|
|
|
|
(cond
|
|
|
|
|
((= 1 len) (byte-compile-constant 0))
|
|
|
|
|
((= 2 len)
|
|
|
|
|
(byte-compile-form (cadr form))
|
|
|
|
|
(byte-compile-out 'byte-negate 0))
|
2008-11-20 12:13:49 +00:00
|
|
|
|
((= 3 len)
|
2008-11-14 18:08:10 +00:00
|
|
|
|
(byte-compile-form (nth 1 form))
|
|
|
|
|
(byte-compile-form (nth 2 form))
|
|
|
|
|
(byte-compile-out 'byte-diff 0))
|
|
|
|
|
;; Don't use binary operations for > 2 operands, as that may
|
|
|
|
|
;; cause overflow/truncation in float operations.
|
|
|
|
|
(t (byte-compile-normal-call form)))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
(defun byte-compile-quo (form)
|
|
|
|
|
(let ((len (length form)))
|
|
|
|
|
(cond ((<= len 2)
|
|
|
|
|
(byte-compile-subr-wrong-args form "2 or more"))
|
2008-11-14 18:08:10 +00:00
|
|
|
|
((= len 3)
|
|
|
|
|
(byte-compile-two-args form))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(t
|
2008-11-14 18:08:10 +00:00
|
|
|
|
;; Don't use binary operations for > 2 operands, as that
|
|
|
|
|
;; may cause overflow/truncation in float operations.
|
|
|
|
|
(byte-compile-normal-call form)))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
(defun byte-compile-nconc (form)
|
|
|
|
|
(let ((len (length form)))
|
|
|
|
|
(cond ((= len 1)
|
|
|
|
|
(byte-compile-constant nil))
|
|
|
|
|
((= len 2)
|
|
|
|
|
;; nconc of one arg is a noop, even if that arg isn't a list.
|
|
|
|
|
(byte-compile-form (nth 1 form)))
|
|
|
|
|
(t
|
|
|
|
|
(byte-compile-form (car (setq form (cdr form))))
|
|
|
|
|
(while (setq form (cdr form))
|
|
|
|
|
(byte-compile-form (car form))
|
|
|
|
|
(byte-compile-out 'byte-nconc 0))))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-fset (form)
|
|
|
|
|
;; warn about forms like (fset 'foo '(lambda () ...))
|
|
|
|
|
;; (where the lambda expression is non-trivial...)
|
|
|
|
|
(let ((fn (nth 2 form))
|
|
|
|
|
body)
|
|
|
|
|
(if (and (eq (car-safe fn) 'quote)
|
|
|
|
|
(eq (car-safe (setq fn (nth 1 fn))) 'lambda))
|
|
|
|
|
(progn
|
|
|
|
|
(setq body (cdr (cdr fn)))
|
|
|
|
|
(if (stringp (car body)) (setq body (cdr body)))
|
|
|
|
|
(if (eq 'interactive (car-safe (car body))) (setq body (cdr body)))
|
|
|
|
|
(if (and (consp (car body))
|
|
|
|
|
(not (eq 'byte-code (car (car body)))))
|
|
|
|
|
(byte-compile-warn
|
2004-06-13 22:01:36 +00:00
|
|
|
|
"A quoted lambda form is the second argument of `fset'. This is probably
|
1992-07-10 22:06:47 +00:00
|
|
|
|
not what you want, as that lambda cannot be compiled. Consider using
|
|
|
|
|
the syntax (function (lambda (...) ...)) instead.")))))
|
|
|
|
|
(byte-compile-two-args form))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-funarg (form)
|
|
|
|
|
;; (mapcar '(lambda (x) ..) ..) ==> (mapcar (function (lambda (x) ..)) ..)
|
1993-06-09 11:59:12 +00:00
|
|
|
|
;; for cases where it's guaranteed that first arg will be used as a lambda.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-normal-call
|
|
|
|
|
(let ((fn (nth 1 form)))
|
|
|
|
|
(if (and (eq (car-safe fn) 'quote)
|
|
|
|
|
(eq (car-safe (nth 1 fn)) 'lambda))
|
|
|
|
|
(cons (car form)
|
|
|
|
|
(cons (cons 'function (cdr fn))
|
|
|
|
|
(cdr (cdr form))))
|
|
|
|
|
form))))
|
|
|
|
|
|
1996-08-28 21:33:50 +00:00
|
|
|
|
(defun byte-compile-funarg-2 (form)
|
|
|
|
|
;; (sort ... '(lambda (x) ..)) ==> (sort ... (function (lambda (x) ..)))
|
|
|
|
|
;; for cases where it's guaranteed that second arg will be used as a lambda.
|
|
|
|
|
(byte-compile-normal-call
|
|
|
|
|
(let ((fn (nth 2 form)))
|
|
|
|
|
(if (and (eq (car-safe fn) 'quote)
|
|
|
|
|
(eq (car-safe (nth 1 fn)) 'lambda))
|
|
|
|
|
(cons (car form)
|
|
|
|
|
(cons (nth 1 form)
|
|
|
|
|
(cons (cons 'function (cdr fn))
|
|
|
|
|
(cdr (cdr (cdr form))))))
|
|
|
|
|
form))))
|
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; (function foo) must compile like 'foo, not like (symbol-function 'foo).
|
|
|
|
|
;; Otherwise it will be incompatible with the interpreter,
|
|
|
|
|
;; and (funcall (function foo)) will lose with autoloads.
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-function-form (form)
|
|
|
|
|
(byte-compile-constant
|
|
|
|
|
(cond ((symbolp (nth 1 form))
|
|
|
|
|
(nth 1 form))
|
|
|
|
|
;; If we're not allowed to use #[] syntax, then output a form like
|
|
|
|
|
;; '(lambda (..) (byte-code ..)) instead of a call to make-byte-code.
|
|
|
|
|
;; In this situation, calling make-byte-code at run-time will usually
|
|
|
|
|
;; be less efficient than processing a call to byte-code.
|
1992-07-15 20:26:37 +00:00
|
|
|
|
((byte-compile-version-cond byte-compile-compatibility)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-byte-code-unmake (byte-compile-lambda (nth 1 form))))
|
|
|
|
|
((byte-compile-lambda (nth 1 form))))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-indent-to (form)
|
|
|
|
|
(let ((len (length form)))
|
|
|
|
|
(cond ((= len 2)
|
|
|
|
|
(byte-compile-form (car (cdr form)))
|
|
|
|
|
(byte-compile-out 'byte-indent-to 0))
|
|
|
|
|
((= len 3)
|
|
|
|
|
;; no opcode for 2-arg case.
|
|
|
|
|
(byte-compile-normal-call form))
|
|
|
|
|
(t
|
|
|
|
|
(byte-compile-subr-wrong-args form "1-2")))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-insert (form)
|
|
|
|
|
(cond ((null (cdr form))
|
|
|
|
|
(byte-compile-constant nil))
|
1993-06-11 16:19:49 +00:00
|
|
|
|
((and (not (byte-compile-version-cond
|
|
|
|
|
byte-compile-compatibility))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(<= (length form) 256))
|
2000-05-26 10:35:38 +00:00
|
|
|
|
(mapc 'byte-compile-form (cdr form))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(if (cdr (cdr form))
|
|
|
|
|
(byte-compile-out 'byte-insertN (length (cdr form)))
|
|
|
|
|
(byte-compile-out 'byte-insert 0)))
|
|
|
|
|
((memq t (mapcar 'consp (cdr (cdr form))))
|
|
|
|
|
(byte-compile-normal-call form))
|
|
|
|
|
;; We can split it; there is no function call after inserting 1st arg.
|
|
|
|
|
(t
|
|
|
|
|
(while (setq form (cdr form))
|
|
|
|
|
(byte-compile-form (car form))
|
|
|
|
|
(byte-compile-out 'byte-insert 0)
|
|
|
|
|
(if (cdr form)
|
|
|
|
|
(byte-compile-discard))))))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(byte-defop-compiler-1 setq)
|
|
|
|
|
(byte-defop-compiler-1 setq-default)
|
|
|
|
|
(byte-defop-compiler-1 quote)
|
|
|
|
|
(byte-defop-compiler-1 quote-form)
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-setq (form)
|
|
|
|
|
(let ((args (cdr form)))
|
|
|
|
|
(if args
|
|
|
|
|
(while args
|
|
|
|
|
(byte-compile-form (car (cdr args)))
|
|
|
|
|
(or for-effect (cdr (cdr args))
|
|
|
|
|
(byte-compile-out 'byte-dup 0))
|
|
|
|
|
(byte-compile-variable-ref 'byte-varset (car args))
|
|
|
|
|
(setq args (cdr (cdr args))))
|
|
|
|
|
;; (setq), with no arguments.
|
|
|
|
|
(byte-compile-form nil for-effect))
|
|
|
|
|
(setq for-effect nil)))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-setq-default (form)
|
1993-07-09 06:33:05 +00:00
|
|
|
|
(let ((args (cdr form))
|
|
|
|
|
setters)
|
|
|
|
|
(while args
|
2009-08-29 14:44:45 +00:00
|
|
|
|
(let ((var (car args)))
|
|
|
|
|
(if (or (not (symbolp var))
|
|
|
|
|
(byte-compile-const-symbol-p var t))
|
|
|
|
|
(byte-compile-warn
|
|
|
|
|
"variable assignment to %s `%s'"
|
|
|
|
|
(if (symbolp var) "constant" "nonvariable")
|
|
|
|
|
(prin1-to-string var)))
|
|
|
|
|
(push (list 'set-default (list 'quote var) (car (cdr args)))
|
|
|
|
|
setters))
|
1993-07-09 06:33:05 +00:00
|
|
|
|
(setq args (cdr (cdr args))))
|
|
|
|
|
(byte-compile-form (cons 'progn (nreverse setters)))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
(defun byte-compile-quote (form)
|
|
|
|
|
(byte-compile-constant (car (cdr form))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-quote-form (form)
|
|
|
|
|
(byte-compile-constant (byte-compile-top-level (nth 1 form))))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
;;; control structures
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-body (body &optional for-effect)
|
|
|
|
|
(while (cdr body)
|
|
|
|
|
(byte-compile-form (car body) t)
|
|
|
|
|
(setq body (cdr body)))
|
|
|
|
|
(byte-compile-form (car body) for-effect))
|
|
|
|
|
|
1992-07-15 20:26:37 +00:00
|
|
|
|
(defsubst byte-compile-body-do-effect (body)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-body body for-effect)
|
|
|
|
|
(setq for-effect nil))
|
|
|
|
|
|
1992-07-15 20:26:37 +00:00
|
|
|
|
(defsubst byte-compile-form-do-effect (form)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-form form for-effect)
|
|
|
|
|
(setq for-effect nil))
|
|
|
|
|
|
|
|
|
|
(byte-defop-compiler-1 inline byte-compile-progn)
|
|
|
|
|
(byte-defop-compiler-1 progn)
|
|
|
|
|
(byte-defop-compiler-1 prog1)
|
|
|
|
|
(byte-defop-compiler-1 prog2)
|
|
|
|
|
(byte-defop-compiler-1 if)
|
|
|
|
|
(byte-defop-compiler-1 cond)
|
|
|
|
|
(byte-defop-compiler-1 and)
|
|
|
|
|
(byte-defop-compiler-1 or)
|
|
|
|
|
(byte-defop-compiler-1 while)
|
|
|
|
|
(byte-defop-compiler-1 funcall)
|
|
|
|
|
(byte-defop-compiler-1 apply byte-compile-funarg)
|
|
|
|
|
(byte-defop-compiler-1 mapcar byte-compile-funarg)
|
|
|
|
|
(byte-defop-compiler-1 mapatoms byte-compile-funarg)
|
|
|
|
|
(byte-defop-compiler-1 mapconcat byte-compile-funarg)
|
2000-08-27 21:55:00 +00:00
|
|
|
|
(byte-defop-compiler-1 mapc byte-compile-funarg)
|
2002-11-19 18:02:07 +00:00
|
|
|
|
(byte-defop-compiler-1 maphash byte-compile-funarg)
|
|
|
|
|
(byte-defop-compiler-1 map-char-table byte-compile-funarg)
|
2002-06-24 18:25:16 +00:00
|
|
|
|
(byte-defop-compiler-1 map-char-table byte-compile-funarg-2)
|
|
|
|
|
;; map-charset-chars should be funarg but has optional third arg
|
1996-08-28 21:33:50 +00:00
|
|
|
|
(byte-defop-compiler-1 sort byte-compile-funarg-2)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-defop-compiler-1 let)
|
|
|
|
|
(byte-defop-compiler-1 let*)
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-progn (form)
|
|
|
|
|
(byte-compile-body-do-effect (cdr form)))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-prog1 (form)
|
|
|
|
|
(byte-compile-form-do-effect (car (cdr form)))
|
|
|
|
|
(byte-compile-body (cdr (cdr form)) t))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-prog2 (form)
|
|
|
|
|
(byte-compile-form (nth 1 form) t)
|
|
|
|
|
(byte-compile-form-do-effect (nth 2 form))
|
|
|
|
|
(byte-compile-body (cdr (cdr (cdr form))) t))
|
|
|
|
|
|
|
|
|
|
(defmacro byte-compile-goto-if (cond discard tag)
|
2000-02-23 12:29:05 +00:00
|
|
|
|
`(byte-compile-goto
|
|
|
|
|
(if ,cond
|
|
|
|
|
(if ,discard 'byte-goto-if-not-nil 'byte-goto-if-not-nil-else-pop)
|
|
|
|
|
(if ,discard 'byte-goto-if-nil 'byte-goto-if-nil-else-pop))
|
|
|
|
|
,tag))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
2007-11-10 08:05:15 +00:00
|
|
|
|
;; Return the list of items in CONDITION-PARAM that match PRED-LIST.
|
|
|
|
|
;; Only return items that are not in ONLY-IF-NOT-PRESENT.
|
2007-11-26 15:38:18 +00:00
|
|
|
|
(defun byte-compile-find-bound-condition (condition-param
|
|
|
|
|
pred-list
|
2007-11-10 08:05:15 +00:00
|
|
|
|
&optional only-if-not-present)
|
|
|
|
|
(let ((result nil)
|
|
|
|
|
(nth-one nil)
|
2007-11-26 15:38:18 +00:00
|
|
|
|
(cond-list
|
2007-11-10 08:05:15 +00:00
|
|
|
|
(if (memq (car-safe condition-param) pred-list)
|
|
|
|
|
;; The condition appears by itself.
|
|
|
|
|
(list condition-param)
|
|
|
|
|
;; If the condition is an `and', look for matches among the
|
|
|
|
|
;; `and' arguments.
|
|
|
|
|
(when (eq 'and (car-safe condition-param))
|
|
|
|
|
(cdr condition-param)))))
|
2007-11-26 15:38:18 +00:00
|
|
|
|
|
2007-11-10 08:05:15 +00:00
|
|
|
|
(dolist (crt cond-list)
|
|
|
|
|
(when (and (memq (car-safe crt) pred-list)
|
|
|
|
|
(eq 'quote (car-safe (setq nth-one (nth 1 crt))))
|
|
|
|
|
;; Ignore if the symbol is already on the unresolved
|
|
|
|
|
;; list.
|
|
|
|
|
(not (assq (nth 1 nth-one) ; the relevant symbol
|
|
|
|
|
only-if-not-present)))
|
|
|
|
|
(push (nth 1 (nth 1 crt)) result)))
|
|
|
|
|
result))
|
|
|
|
|
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(defmacro byte-compile-maybe-guarded (condition &rest body)
|
|
|
|
|
"Execute forms in BODY, potentially guarded by CONDITION.
|
2005-07-08 22:49:47 +00:00
|
|
|
|
CONDITION is a variable whose value is a test in an `if' or `cond'.
|
2008-06-13 04:16:23 +00:00
|
|
|
|
BODY is the code to compile in the first arm of the if or the body of
|
|
|
|
|
the cond clause. If CONDITION's value is of the form (fboundp 'foo)
|
2005-07-16 19:04:57 +00:00
|
|
|
|
or (boundp 'foo), the relevant warnings from BODY about foo's
|
2005-07-08 22:49:47 +00:00
|
|
|
|
being undefined will be suppressed.
|
|
|
|
|
|
2005-07-16 21:17:10 +00:00
|
|
|
|
If CONDITION's value is (not (featurep 'emacs)) or (featurep 'xemacs),
|
2005-07-16 19:04:57 +00:00
|
|
|
|
that suppresses all warnings during execution of BODY."
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(declare (indent 1) (debug t))
|
2007-11-26 15:38:18 +00:00
|
|
|
|
`(let* ((fbound-list (byte-compile-find-bound-condition
|
|
|
|
|
,condition (list 'fboundp)
|
2007-11-10 08:05:15 +00:00
|
|
|
|
byte-compile-unresolved-functions))
|
2007-11-26 15:38:18 +00:00
|
|
|
|
(bound-list (byte-compile-find-bound-condition
|
2007-11-10 08:05:15 +00:00
|
|
|
|
,condition (list 'boundp 'default-boundp)))
|
2004-04-16 12:51:06 +00:00
|
|
|
|
;; Maybe add to the bound list.
|
|
|
|
|
(byte-compile-bound-variables
|
2007-11-10 08:05:15 +00:00
|
|
|
|
(if bound-list
|
|
|
|
|
(append bound-list byte-compile-bound-variables)
|
2008-03-03 03:40:04 +00:00
|
|
|
|
byte-compile-bound-variables)))
|
2005-07-08 22:49:47 +00:00
|
|
|
|
(unwind-protect
|
|
|
|
|
(progn ,@body)
|
|
|
|
|
;; Maybe remove the function symbol from the unresolved list.
|
2007-11-10 08:05:15 +00:00
|
|
|
|
(dolist (fbound fbound-list)
|
|
|
|
|
(when fbound
|
2005-07-08 22:49:47 +00:00
|
|
|
|
(setq byte-compile-unresolved-functions
|
|
|
|
|
(delq (assq fbound byte-compile-unresolved-functions)
|
2007-11-10 08:05:15 +00:00
|
|
|
|
byte-compile-unresolved-functions)))))))
|
2004-04-16 12:51:06 +00:00
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defun byte-compile-if (form)
|
|
|
|
|
(byte-compile-form (car (cdr form)))
|
2002-12-12 20:27:43 +00:00
|
|
|
|
;; Check whether we have `(if (fboundp ...' or `(if (boundp ...'
|
|
|
|
|
;; and avoid warnings about the relevent symbols in the consequent.
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(let ((clause (nth 1 form))
|
|
|
|
|
(donetag (byte-compile-make-tag)))
|
2002-12-12 20:27:43 +00:00
|
|
|
|
(if (null (nthcdr 3 form))
|
|
|
|
|
;; No else-forms
|
|
|
|
|
(progn
|
|
|
|
|
(byte-compile-goto-if nil for-effect donetag)
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(byte-compile-maybe-guarded clause
|
2002-12-12 20:27:43 +00:00
|
|
|
|
(byte-compile-form (nth 2 form) for-effect))
|
|
|
|
|
(byte-compile-out-tag donetag))
|
|
|
|
|
(let ((elsetag (byte-compile-make-tag)))
|
|
|
|
|
(byte-compile-goto 'byte-goto-if-nil elsetag)
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(byte-compile-maybe-guarded clause
|
|
|
|
|
(byte-compile-form (nth 2 form) for-effect))
|
2002-12-12 20:27:43 +00:00
|
|
|
|
(byte-compile-goto 'byte-goto donetag)
|
|
|
|
|
(byte-compile-out-tag elsetag)
|
2005-07-16 18:39:14 +00:00
|
|
|
|
(byte-compile-maybe-guarded (list 'not clause)
|
|
|
|
|
(byte-compile-body (cdr (cdr (cdr form))) for-effect))
|
2002-12-12 20:27:43 +00:00
|
|
|
|
(byte-compile-out-tag donetag))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(setq for-effect nil))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-cond (clauses)
|
|
|
|
|
(let ((donetag (byte-compile-make-tag))
|
|
|
|
|
nexttag clause)
|
|
|
|
|
(while (setq clauses (cdr clauses))
|
|
|
|
|
(setq clause (car clauses))
|
|
|
|
|
(cond ((or (eq (car clause) t)
|
|
|
|
|
(and (eq (car-safe (car clause)) 'quote)
|
|
|
|
|
(car-safe (cdr-safe (car clause)))))
|
|
|
|
|
;; Unconditional clause
|
|
|
|
|
(setq clause (cons t clause)
|
|
|
|
|
clauses nil))
|
|
|
|
|
((cdr clauses)
|
|
|
|
|
(byte-compile-form (car clause))
|
|
|
|
|
(if (null (cdr clause))
|
|
|
|
|
;; First clause is a singleton.
|
|
|
|
|
(byte-compile-goto-if t for-effect donetag)
|
2005-07-08 22:49:47 +00:00
|
|
|
|
(setq nexttag (byte-compile-make-tag))
|
|
|
|
|
(byte-compile-goto 'byte-goto-if-nil nexttag)
|
|
|
|
|
(byte-compile-maybe-guarded (car clause)
|
|
|
|
|
(byte-compile-body (cdr clause) for-effect))
|
|
|
|
|
(byte-compile-goto 'byte-goto donetag)
|
|
|
|
|
(byte-compile-out-tag nexttag)))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; Last clause
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(let ((guard (car clause)))
|
|
|
|
|
(and (cdr clause) (not (eq guard t))
|
|
|
|
|
(progn (byte-compile-form guard)
|
|
|
|
|
(byte-compile-goto-if nil for-effect donetag)
|
|
|
|
|
(setq clause (cdr clause))))
|
|
|
|
|
(byte-compile-maybe-guarded guard
|
|
|
|
|
(byte-compile-body-do-effect clause)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-out-tag donetag)))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-and (form)
|
|
|
|
|
(let ((failtag (byte-compile-make-tag))
|
|
|
|
|
(args (cdr form)))
|
|
|
|
|
(if (null args)
|
|
|
|
|
(byte-compile-form-do-effect t)
|
2005-07-16 18:02:07 +00:00
|
|
|
|
(byte-compile-and-recursion args failtag))))
|
|
|
|
|
|
2005-07-16 18:27:25 +00:00
|
|
|
|
;; Handle compilation of a nontrivial `and' call.
|
2005-07-16 18:02:07 +00:00
|
|
|
|
;; We use tail recursion so we can use byte-compile-maybe-guarded.
|
|
|
|
|
(defun byte-compile-and-recursion (rest failtag)
|
|
|
|
|
(if (cdr rest)
|
|
|
|
|
(progn
|
|
|
|
|
(byte-compile-form (car rest))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-goto-if nil for-effect failtag)
|
2005-07-16 18:02:07 +00:00
|
|
|
|
(byte-compile-maybe-guarded (car rest)
|
|
|
|
|
(byte-compile-and-recursion (cdr rest) failtag)))
|
|
|
|
|
(byte-compile-form-do-effect (car rest))
|
|
|
|
|
(byte-compile-out-tag failtag)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
(defun byte-compile-or (form)
|
|
|
|
|
(let ((wintag (byte-compile-make-tag))
|
|
|
|
|
(args (cdr form)))
|
|
|
|
|
(if (null args)
|
|
|
|
|
(byte-compile-form-do-effect nil)
|
2005-07-16 18:27:25 +00:00
|
|
|
|
(byte-compile-or-recursion args wintag))))
|
|
|
|
|
|
|
|
|
|
;; Handle compilation of a nontrivial `or' call.
|
|
|
|
|
;; We use tail recursion so we can use byte-compile-maybe-guarded.
|
|
|
|
|
(defun byte-compile-or-recursion (rest wintag)
|
|
|
|
|
(if (cdr rest)
|
|
|
|
|
(progn
|
|
|
|
|
(byte-compile-form (car rest))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-goto-if t for-effect wintag)
|
2005-07-16 18:27:25 +00:00
|
|
|
|
(byte-compile-maybe-guarded (list 'not (car rest))
|
|
|
|
|
(byte-compile-or-recursion (cdr rest) wintag)))
|
|
|
|
|
(byte-compile-form-do-effect (car rest))
|
|
|
|
|
(byte-compile-out-tag wintag)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
(defun byte-compile-while (form)
|
|
|
|
|
(let ((endtag (byte-compile-make-tag))
|
|
|
|
|
(looptag (byte-compile-make-tag)))
|
|
|
|
|
(byte-compile-out-tag looptag)
|
|
|
|
|
(byte-compile-form (car (cdr form)))
|
|
|
|
|
(byte-compile-goto-if nil for-effect endtag)
|
|
|
|
|
(byte-compile-body (cdr (cdr form)) t)
|
|
|
|
|
(byte-compile-goto 'byte-goto looptag)
|
|
|
|
|
(byte-compile-out-tag endtag)
|
|
|
|
|
(setq for-effect nil)))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-funcall (form)
|
2000-05-26 10:35:38 +00:00
|
|
|
|
(mapc 'byte-compile-form (cdr form))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-out 'byte-call (length (cdr (cdr form)))))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-let (form)
|
|
|
|
|
;; First compute the binding values in the old scope.
|
|
|
|
|
(let ((varlist (car (cdr form))))
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(dolist (var varlist)
|
|
|
|
|
(if (consp var)
|
|
|
|
|
(byte-compile-form (car (cdr var)))
|
|
|
|
|
(byte-compile-push-constant nil))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(let ((byte-compile-bound-variables byte-compile-bound-variables) ;new scope
|
|
|
|
|
(varlist (reverse (car (cdr form)))))
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(dolist (var varlist)
|
|
|
|
|
(byte-compile-variable-ref 'byte-varbind (if (consp var) (car var) var)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-body-do-effect (cdr (cdr form)))
|
|
|
|
|
(byte-compile-out 'byte-unbind (length (car (cdr form))))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-let* (form)
|
|
|
|
|
(let ((byte-compile-bound-variables byte-compile-bound-variables) ;new scope
|
|
|
|
|
(varlist (copy-sequence (car (cdr form)))))
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(dolist (var varlist)
|
|
|
|
|
(if (atom var)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-push-constant nil)
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(byte-compile-form (car (cdr var)))
|
|
|
|
|
(setq var (car var)))
|
|
|
|
|
(byte-compile-variable-ref 'byte-varbind var))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-body-do-effect (cdr (cdr form)))
|
|
|
|
|
(byte-compile-out 'byte-unbind (length (car (cdr form))))))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(byte-defop-compiler-1 /= byte-compile-negated)
|
|
|
|
|
(byte-defop-compiler-1 atom byte-compile-negated)
|
|
|
|
|
(byte-defop-compiler-1 nlistp byte-compile-negated)
|
|
|
|
|
|
|
|
|
|
(put '/= 'byte-compile-negated-op '=)
|
|
|
|
|
(put 'atom 'byte-compile-negated-op 'consp)
|
|
|
|
|
(put 'nlistp 'byte-compile-negated-op 'listp)
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-negated (form)
|
|
|
|
|
(byte-compile-form-do-effect (byte-compile-negation-optimizer form)))
|
|
|
|
|
|
|
|
|
|
;; Even when optimization is off, /= is optimized to (not (= ...)).
|
|
|
|
|
(defun byte-compile-negation-optimizer (form)
|
|
|
|
|
;; an optimizer for forms where <form1> is less efficient than (not <form2>)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(byte-compile-set-symbol-position (car form))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(list 'not
|
|
|
|
|
(cons (or (get (car form) 'byte-compile-negated-op)
|
|
|
|
|
(error
|
1992-07-15 20:26:37 +00:00
|
|
|
|
"Compiler error: `%s' has no `byte-compile-negated-op' property"
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(car form)))
|
|
|
|
|
(cdr form))))
|
|
|
|
|
|
|
|
|
|
;;; other tricky macro-like special-forms
|
|
|
|
|
|
|
|
|
|
(byte-defop-compiler-1 catch)
|
|
|
|
|
(byte-defop-compiler-1 unwind-protect)
|
|
|
|
|
(byte-defop-compiler-1 condition-case)
|
|
|
|
|
(byte-defop-compiler-1 save-excursion)
|
1996-09-22 04:37:55 +00:00
|
|
|
|
(byte-defop-compiler-1 save-current-buffer)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-defop-compiler-1 save-restriction)
|
|
|
|
|
(byte-defop-compiler-1 save-window-excursion)
|
|
|
|
|
(byte-defop-compiler-1 with-output-to-temp-buffer)
|
1993-05-15 19:47:15 +00:00
|
|
|
|
(byte-defop-compiler-1 track-mouse)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
(defun byte-compile-catch (form)
|
|
|
|
|
(byte-compile-form (car (cdr form)))
|
|
|
|
|
(byte-compile-push-constant
|
|
|
|
|
(byte-compile-top-level (cons 'progn (cdr (cdr form))) for-effect))
|
|
|
|
|
(byte-compile-out 'byte-catch 0))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-unwind-protect (form)
|
|
|
|
|
(byte-compile-push-constant
|
|
|
|
|
(byte-compile-top-level-body (cdr (cdr form)) t))
|
|
|
|
|
(byte-compile-out 'byte-unwind-protect 0)
|
|
|
|
|
(byte-compile-form-do-effect (car (cdr form)))
|
|
|
|
|
(byte-compile-out 'byte-unbind 1))
|
|
|
|
|
|
1993-05-15 19:47:15 +00:00
|
|
|
|
(defun byte-compile-track-mouse (form)
|
1994-03-10 17:22:59 +00:00
|
|
|
|
(byte-compile-form
|
2003-04-12 20:28:10 +00:00
|
|
|
|
`(funcall '(lambda nil
|
|
|
|
|
(track-mouse ,@(byte-compile-top-level-body (cdr form)))))))
|
1993-05-15 19:47:15 +00:00
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defun byte-compile-condition-case (form)
|
|
|
|
|
(let* ((var (nth 1 form))
|
|
|
|
|
(byte-compile-bound-variables
|
|
|
|
|
(if var (cons var byte-compile-bound-variables)
|
|
|
|
|
byte-compile-bound-variables)))
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(byte-compile-set-symbol-position 'condition-case)
|
|
|
|
|
(unless (symbolp var)
|
|
|
|
|
(byte-compile-warn
|
2004-06-13 22:01:36 +00:00
|
|
|
|
"`%s' is not a variable-name or nil (in condition-case)" var))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-push-constant var)
|
|
|
|
|
(byte-compile-push-constant (byte-compile-top-level
|
|
|
|
|
(nth 2 form) for-effect))
|
|
|
|
|
(let ((clauses (cdr (cdr (cdr form))))
|
|
|
|
|
compiled-clauses)
|
|
|
|
|
(while clauses
|
1993-06-11 16:19:49 +00:00
|
|
|
|
(let* ((clause (car clauses))
|
|
|
|
|
(condition (car clause)))
|
1994-01-11 07:21:47 +00:00
|
|
|
|
(cond ((not (or (symbolp condition)
|
|
|
|
|
(and (listp condition)
|
|
|
|
|
(let ((syms condition) (ok t))
|
|
|
|
|
(while syms
|
|
|
|
|
(if (not (symbolp (car syms)))
|
|
|
|
|
(setq ok nil))
|
|
|
|
|
(setq syms (cdr syms)))
|
|
|
|
|
ok))))
|
1993-06-11 16:19:49 +00:00
|
|
|
|
(byte-compile-warn
|
2004-06-13 22:01:36 +00:00
|
|
|
|
"`%s' is not a condition name or list of such (in condition-case)"
|
1993-06-11 16:19:49 +00:00
|
|
|
|
(prin1-to-string condition)))
|
1994-01-11 07:21:47 +00:00
|
|
|
|
;; ((not (or (eq condition 't)
|
|
|
|
|
;; (and (stringp (get condition 'error-message))
|
|
|
|
|
;; (consp (get condition 'error-conditions)))))
|
|
|
|
|
;; (byte-compile-warn
|
2004-06-13 22:01:36 +00:00
|
|
|
|
;; "`%s' is not a known condition name (in condition-case)"
|
1994-01-11 07:21:47 +00:00
|
|
|
|
;; condition))
|
|
|
|
|
)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(setq compiled-clauses
|
1993-06-11 16:19:49 +00:00
|
|
|
|
(cons (cons condition
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-top-level-body
|
|
|
|
|
(cdr clause) for-effect))
|
|
|
|
|
compiled-clauses)))
|
|
|
|
|
(setq clauses (cdr clauses)))
|
|
|
|
|
(byte-compile-push-constant (nreverse compiled-clauses)))
|
|
|
|
|
(byte-compile-out 'byte-condition-case 0)))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-save-excursion (form)
|
|
|
|
|
(byte-compile-out 'byte-save-excursion 0)
|
|
|
|
|
(byte-compile-body-do-effect (cdr form))
|
|
|
|
|
(byte-compile-out 'byte-unbind 1))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-save-restriction (form)
|
|
|
|
|
(byte-compile-out 'byte-save-restriction 0)
|
|
|
|
|
(byte-compile-body-do-effect (cdr form))
|
|
|
|
|
(byte-compile-out 'byte-unbind 1))
|
|
|
|
|
|
1996-09-22 04:37:55 +00:00
|
|
|
|
(defun byte-compile-save-current-buffer (form)
|
|
|
|
|
(byte-compile-out 'byte-save-current-buffer 0)
|
|
|
|
|
(byte-compile-body-do-effect (cdr form))
|
|
|
|
|
(byte-compile-out 'byte-unbind 1))
|
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(defun byte-compile-save-window-excursion (form)
|
|
|
|
|
(byte-compile-push-constant
|
|
|
|
|
(byte-compile-top-level-body (cdr form) for-effect))
|
|
|
|
|
(byte-compile-out 'byte-save-window-excursion 0))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-with-output-to-temp-buffer (form)
|
|
|
|
|
(byte-compile-form (car (cdr form)))
|
|
|
|
|
(byte-compile-out 'byte-temp-output-buffer-setup 0)
|
|
|
|
|
(byte-compile-body (cdr (cdr form)))
|
|
|
|
|
(byte-compile-out 'byte-temp-output-buffer-show 0))
|
|
|
|
|
|
|
|
|
|
;;; top-level forms elsewhere
|
|
|
|
|
|
|
|
|
|
(byte-defop-compiler-1 defun)
|
|
|
|
|
(byte-defop-compiler-1 defmacro)
|
|
|
|
|
(byte-defop-compiler-1 defvar)
|
|
|
|
|
(byte-defop-compiler-1 defconst byte-compile-defvar)
|
|
|
|
|
(byte-defop-compiler-1 autoload)
|
|
|
|
|
(byte-defop-compiler-1 lambda byte-compile-lambda-form)
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-defun (form)
|
|
|
|
|
;; This is not used for file-level defuns with doc strings.
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(if (symbolp (car form))
|
|
|
|
|
(byte-compile-set-symbol-position (car form))
|
|
|
|
|
(byte-compile-set-symbol-position 'defun)
|
2001-10-12 14:20:14 +00:00
|
|
|
|
(error "defun name must be a symbol, not %s" (car form)))
|
2003-04-24 01:51:54 +00:00
|
|
|
|
(if (byte-compile-version-cond byte-compile-compatibility)
|
|
|
|
|
(progn
|
|
|
|
|
(byte-compile-two-args ; Use this to avoid byte-compile-fset's warning.
|
|
|
|
|
(list 'fset
|
|
|
|
|
(list 'quote (nth 1 form))
|
|
|
|
|
(byte-compile-byte-code-maker
|
2005-10-23 07:33:45 +00:00
|
|
|
|
(byte-compile-lambda (cdr (cdr form)) t))))
|
2003-04-24 01:51:54 +00:00
|
|
|
|
(byte-compile-discard))
|
2003-04-24 01:52:37 +00:00
|
|
|
|
;; We prefer to generate a defalias form so it will record the function
|
|
|
|
|
;; definition just like interpreting a defun.
|
2003-04-24 01:51:54 +00:00
|
|
|
|
(byte-compile-form
|
|
|
|
|
(list 'defalias
|
|
|
|
|
(list 'quote (nth 1 form))
|
|
|
|
|
(byte-compile-byte-code-maker
|
2005-10-23 07:33:45 +00:00
|
|
|
|
(byte-compile-lambda (cdr (cdr form)) t)))
|
2003-04-24 01:51:54 +00:00
|
|
|
|
t))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-constant (nth 1 form)))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-defmacro (form)
|
|
|
|
|
;; This is not used for file-level defmacros with doc strings.
|
|
|
|
|
(byte-compile-body-do-effect
|
|
|
|
|
(list (list 'fset (list 'quote (nth 1 form))
|
|
|
|
|
(let ((code (byte-compile-byte-code-maker
|
2005-10-23 07:33:45 +00:00
|
|
|
|
(byte-compile-lambda (cdr (cdr form)) t))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(if (eq (car-safe code) 'make-byte-code)
|
|
|
|
|
(list 'cons ''macro code)
|
|
|
|
|
(list 'quote (cons 'macro (eval code))))))
|
|
|
|
|
(list 'quote (nth 1 form)))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-defvar (form)
|
|
|
|
|
;; This is not used for file-level defvar/consts with doc strings.
|
2000-09-25 15:41:30 +00:00
|
|
|
|
(let ((fun (nth 0 form))
|
|
|
|
|
(var (nth 1 form))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(value (nth 2 form))
|
|
|
|
|
(string (nth 3 form)))
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(byte-compile-set-symbol-position fun)
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(when (or (> (length form) 4)
|
|
|
|
|
(and (eq fun 'defconst) (null (cddr form))))
|
2003-04-21 15:48:28 +00:00
|
|
|
|
(let ((ncall (length (cdr form))))
|
|
|
|
|
(byte-compile-warn
|
2004-06-13 22:01:36 +00:00
|
|
|
|
"`%s' called with %d argument%s, but %s %s"
|
2003-04-21 15:48:28 +00:00
|
|
|
|
fun ncall
|
|
|
|
|
(if (= 1 ncall) "" "s")
|
|
|
|
|
(if (< ncall 2) "requires" "accepts only")
|
|
|
|
|
"2-3")))
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(when (byte-compile-warning-enabled-p 'free-vars)
|
2003-04-12 21:39:50 +00:00
|
|
|
|
(push var byte-compile-bound-variables)
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(if (eq fun 'defconst)
|
|
|
|
|
(push var byte-compile-const-variables)))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(byte-compile-body-do-effect
|
2000-09-25 15:41:30 +00:00
|
|
|
|
(list
|
|
|
|
|
;; Put the defined variable in this library's load-history entry
|
|
|
|
|
;; just as a real defvar would, but only in top-level forms.
|
2001-10-05 09:29:51 +00:00
|
|
|
|
(when (and (cddr form) (null byte-compile-current-form))
|
2000-09-25 15:41:30 +00:00
|
|
|
|
`(push ',var current-load-list))
|
|
|
|
|
(when (> (length form) 3)
|
|
|
|
|
(when (and string (not (stringp string)))
|
2004-06-13 22:01:36 +00:00
|
|
|
|
(byte-compile-warn "third arg to `%s %s' is not a string: %s"
|
2000-09-25 15:41:30 +00:00
|
|
|
|
fun var string))
|
|
|
|
|
`(put ',var 'variable-documentation ,string))
|
2001-11-17 00:54:36 +00:00
|
|
|
|
(if (cddr form) ; `value' provided
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(let ((byte-compile-not-obsolete-var var))
|
|
|
|
|
(if (eq fun 'defconst)
|
|
|
|
|
;; `defconst' sets `var' unconditionally.
|
|
|
|
|
(let ((tmp (make-symbol "defconst-tmp-var")))
|
|
|
|
|
`(funcall '(lambda (,tmp) (defconst ,var ,tmp))
|
|
|
|
|
,value))
|
|
|
|
|
;; `defvar' sets `var' only when unbound.
|
|
|
|
|
`(if (not (default-boundp ',var)) (setq-default ,var ,value))))
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(when (eq fun 'defconst)
|
|
|
|
|
;; This will signal an appropriate error at runtime.
|
|
|
|
|
`(eval ',form)))
|
2000-09-25 15:41:30 +00:00
|
|
|
|
`',var))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
(defun byte-compile-autoload (form)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(byte-compile-set-symbol-position 'autoload)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(and (byte-compile-constp (nth 1 form))
|
|
|
|
|
(byte-compile-constp (nth 5 form))
|
|
|
|
|
(eval (nth 5 form)) ; macro-p
|
|
|
|
|
(not (fboundp (eval (nth 1 form))))
|
|
|
|
|
(byte-compile-warn
|
2000-03-29 21:32:57 +00:00
|
|
|
|
"The compiler ignores `autoload' except at top level. You should
|
1992-07-10 22:06:47 +00:00
|
|
|
|
probably put the autoload of the macro `%s' at top-level."
|
|
|
|
|
(eval (nth 1 form))))
|
|
|
|
|
(byte-compile-normal-call form))
|
|
|
|
|
|
2000-03-29 21:32:57 +00:00
|
|
|
|
;; Lambdas in valid places are handled as special cases by various code.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; The ones that remain are errors.
|
|
|
|
|
(defun byte-compile-lambda-form (form)
|
2002-05-28 17:40:47 +00:00
|
|
|
|
(byte-compile-set-symbol-position 'lambda)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(error "`lambda' used as function name is invalid"))
|
|
|
|
|
|
1994-06-29 18:06:09 +00:00
|
|
|
|
;; Compile normally, but deal with warnings for the function being defined.
|
2004-11-11 22:44:46 +00:00
|
|
|
|
(put 'defalias 'byte-hunk-handler 'byte-compile-file-form-defalias)
|
|
|
|
|
(defun byte-compile-file-form-defalias (form)
|
1994-06-29 18:06:09 +00:00
|
|
|
|
(if (and (consp (cdr form)) (consp (nth 1 form))
|
|
|
|
|
(eq (car (nth 1 form)) 'quote)
|
|
|
|
|
(consp (cdr (nth 1 form)))
|
2004-11-09 10:33:23 +00:00
|
|
|
|
(symbolp (nth 1 (nth 1 form))))
|
|
|
|
|
(let ((constant
|
|
|
|
|
(and (consp (nthcdr 2 form))
|
|
|
|
|
(consp (nth 2 form))
|
|
|
|
|
(eq (car (nth 2 form)) 'quote)
|
|
|
|
|
(consp (cdr (nth 2 form)))
|
|
|
|
|
(symbolp (nth 1 (nth 2 form))))))
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(byte-compile-defalias-warn (nth 1 (nth 1 form)))
|
2004-11-11 22:44:46 +00:00
|
|
|
|
(push (cons (nth 1 (nth 1 form))
|
|
|
|
|
(if constant (nth 1 (nth 2 form)) t))
|
|
|
|
|
byte-compile-function-environment)))
|
2009-07-23 02:53:29 +00:00
|
|
|
|
;; We used to just do: (byte-compile-normal-call form)
|
2006-01-03 18:35:58 +00:00
|
|
|
|
;; But it turns out that this fails to optimize the code.
|
|
|
|
|
;; So instead we now do the same as what other byte-hunk-handlers do,
|
|
|
|
|
;; which is to call back byte-compile-file-form and then return nil.
|
|
|
|
|
;; Except that we can't just call byte-compile-file-form since it would
|
|
|
|
|
;; call us right back.
|
|
|
|
|
(byte-compile-keep-pending form)
|
|
|
|
|
;; Return nil so the form is not output twice.
|
|
|
|
|
nil)
|
1994-06-29 18:06:09 +00:00
|
|
|
|
|
|
|
|
|
;; Turn off warnings about prior calls to the function being defalias'd.
|
|
|
|
|
;; This could be smarter and compare those calls with
|
|
|
|
|
;; the function it is being aliased to.
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(defun byte-compile-defalias-warn (new)
|
1994-06-29 18:06:09 +00:00
|
|
|
|
(let ((calls (assq new byte-compile-unresolved-functions)))
|
|
|
|
|
(if calls
|
|
|
|
|
(setq byte-compile-unresolved-functions
|
|
|
|
|
(delq calls byte-compile-unresolved-functions)))))
|
2003-05-28 11:26:45 +00:00
|
|
|
|
|
|
|
|
|
(byte-defop-compiler-1 with-no-warnings byte-compile-no-warnings)
|
|
|
|
|
(defun byte-compile-no-warnings (form)
|
|
|
|
|
(let (byte-compile-warnings)
|
2004-04-21 19:13:00 +00:00
|
|
|
|
(byte-compile-form (cons 'progn (cdr form)))))
|
2005-07-29 19:54:18 +00:00
|
|
|
|
|
|
|
|
|
;; Warn about misuses of make-variable-buffer-local.
|
|
|
|
|
(byte-defop-compiler-1 make-variable-buffer-local byte-compile-make-variable-buffer-local)
|
|
|
|
|
(defun byte-compile-make-variable-buffer-local (form)
|
2007-06-07 07:00:00 +00:00
|
|
|
|
(if (and (eq (car-safe (car-safe (cdr-safe form))) 'quote)
|
2007-10-28 23:53:06 +00:00
|
|
|
|
(byte-compile-warning-enabled-p 'make-local))
|
2005-07-29 19:54:18 +00:00
|
|
|
|
(byte-compile-warn
|
|
|
|
|
"`make-variable-buffer-local' should be called at toplevel"))
|
|
|
|
|
(byte-compile-normal-call form))
|
|
|
|
|
(put 'make-variable-buffer-local
|
|
|
|
|
'byte-hunk-handler 'byte-compile-form-make-variable-buffer-local)
|
|
|
|
|
(defun byte-compile-form-make-variable-buffer-local (form)
|
|
|
|
|
(byte-compile-keep-pending form 'byte-compile-normal-call))
|
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;;; tags
|
|
|
|
|
|
|
|
|
|
;; Note: Most operations will strip off the 'TAG, but it speeds up
|
|
|
|
|
;; optimization to have the 'TAG as a part of the tag.
|
|
|
|
|
;; Tags will be (TAG . (tag-number . stack-depth)).
|
|
|
|
|
(defun byte-compile-make-tag ()
|
|
|
|
|
(list 'TAG (setq byte-compile-tag-number (1+ byte-compile-tag-number))))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-out-tag (tag)
|
|
|
|
|
(setq byte-compile-output (cons tag byte-compile-output))
|
|
|
|
|
(if (cdr (cdr tag))
|
|
|
|
|
(progn
|
|
|
|
|
;; ## remove this someday
|
|
|
|
|
(and byte-compile-depth
|
|
|
|
|
(not (= (cdr (cdr tag)) byte-compile-depth))
|
1992-07-15 20:26:37 +00:00
|
|
|
|
(error "Compiler bug: depth conflict at tag %d" (car (cdr tag))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(setq byte-compile-depth (cdr (cdr tag))))
|
|
|
|
|
(setcdr (cdr tag) byte-compile-depth)))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-goto (opcode tag)
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(push (cons opcode tag) byte-compile-output)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(setcdr (cdr tag) (if (memq opcode byte-goto-always-pop-ops)
|
|
|
|
|
(1- byte-compile-depth)
|
|
|
|
|
byte-compile-depth))
|
|
|
|
|
(setq byte-compile-depth (and (not (eq opcode 'byte-goto))
|
|
|
|
|
(1- byte-compile-depth))))
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-out (opcode offset)
|
2003-04-12 20:28:10 +00:00
|
|
|
|
(push (cons opcode offset) byte-compile-output)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(cond ((eq opcode 'byte-call)
|
|
|
|
|
(setq byte-compile-depth (- byte-compile-depth offset)))
|
|
|
|
|
((eq opcode 'byte-return)
|
|
|
|
|
;; This is actually an unnecessary case, because there should be
|
|
|
|
|
;; no more opcodes behind byte-return.
|
|
|
|
|
(setq byte-compile-depth nil))
|
|
|
|
|
(t
|
|
|
|
|
(setq byte-compile-depth (+ byte-compile-depth
|
|
|
|
|
(or (aref byte-stack+-info
|
|
|
|
|
(symbol-value opcode))
|
|
|
|
|
(- (1- offset))))
|
|
|
|
|
byte-compile-maxdepth (max byte-compile-depth
|
|
|
|
|
byte-compile-maxdepth))))
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;;(if (< byte-compile-depth 0) (error "Compiler error: stack underflow"))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
;;; call tree stuff
|
|
|
|
|
|
|
|
|
|
(defun byte-compile-annotate-call-tree (form)
|
|
|
|
|
(let (entry)
|
|
|
|
|
;; annotate the current call
|
|
|
|
|
(if (setq entry (assq (car form) byte-compile-call-tree))
|
|
|
|
|
(or (memq byte-compile-current-form (nth 1 entry)) ;callers
|
|
|
|
|
(setcar (cdr entry)
|
|
|
|
|
(cons byte-compile-current-form (nth 1 entry))))
|
|
|
|
|
(setq byte-compile-call-tree
|
|
|
|
|
(cons (list (car form) (list byte-compile-current-form) nil)
|
|
|
|
|
byte-compile-call-tree)))
|
|
|
|
|
;; annotate the current function
|
|
|
|
|
(if (setq entry (assq byte-compile-current-form byte-compile-call-tree))
|
|
|
|
|
(or (memq (car form) (nth 2 entry)) ;called
|
|
|
|
|
(setcar (cdr (cdr entry))
|
|
|
|
|
(cons (car form) (nth 2 entry))))
|
|
|
|
|
(setq byte-compile-call-tree
|
|
|
|
|
(cons (list byte-compile-current-form nil (list (car form)))
|
|
|
|
|
byte-compile-call-tree)))
|
|
|
|
|
))
|
|
|
|
|
|
1992-07-15 20:26:37 +00:00
|
|
|
|
;; Renamed from byte-compile-report-call-tree
|
|
|
|
|
;; to avoid interfering with completion of byte-compile-file.
|
1992-07-19 01:07:07 +00:00
|
|
|
|
;;;###autoload
|
1992-07-15 20:26:37 +00:00
|
|
|
|
(defun display-call-tree (&optional filename)
|
|
|
|
|
"Display a call graph of a specified file.
|
|
|
|
|
This lists which functions have been called, what functions called
|
|
|
|
|
them, and what functions they call. The list includes all functions
|
|
|
|
|
whose definitions have been compiled in this Emacs session, as well as
|
|
|
|
|
all functions called by those functions.
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
1992-07-15 20:26:37 +00:00
|
|
|
|
The call graph does not include macros, inline functions, or
|
|
|
|
|
primitives that the byte-code interpreter knows about directly \(eq,
|
|
|
|
|
cons, etc.\).
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
The call tree also lists those functions which are not known to be called
|
1992-07-15 20:26:37 +00:00
|
|
|
|
\(that is, to which no calls have been compiled\), and which cannot be
|
|
|
|
|
invoked interactively."
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(interactive)
|
|
|
|
|
(message "Generating call tree...")
|
|
|
|
|
(with-output-to-temp-buffer "*Call-Tree*"
|
|
|
|
|
(set-buffer "*Call-Tree*")
|
|
|
|
|
(erase-buffer)
|
1995-02-08 00:43:45 +00:00
|
|
|
|
(message "Generating call tree... (sorting on %s)"
|
1992-07-10 22:06:47 +00:00
|
|
|
|
byte-compile-call-tree-sort)
|
|
|
|
|
(insert "Call tree for "
|
|
|
|
|
(cond ((null byte-compile-current-file) (or filename "???"))
|
|
|
|
|
((stringp byte-compile-current-file)
|
|
|
|
|
byte-compile-current-file)
|
|
|
|
|
(t (buffer-name byte-compile-current-file)))
|
|
|
|
|
" sorted on "
|
|
|
|
|
(prin1-to-string byte-compile-call-tree-sort)
|
|
|
|
|
":\n\n")
|
|
|
|
|
(if byte-compile-call-tree-sort
|
|
|
|
|
(setq byte-compile-call-tree
|
|
|
|
|
(sort byte-compile-call-tree
|
|
|
|
|
(cond ((eq byte-compile-call-tree-sort 'callers)
|
|
|
|
|
(function (lambda (x y) (< (length (nth 1 x))
|
|
|
|
|
(length (nth 1 y))))))
|
|
|
|
|
((eq byte-compile-call-tree-sort 'calls)
|
|
|
|
|
(function (lambda (x y) (< (length (nth 2 x))
|
|
|
|
|
(length (nth 2 y))))))
|
|
|
|
|
((eq byte-compile-call-tree-sort 'calls+callers)
|
|
|
|
|
(function (lambda (x y) (< (+ (length (nth 1 x))
|
|
|
|
|
(length (nth 2 x)))
|
|
|
|
|
(+ (length (nth 1 y))
|
|
|
|
|
(length (nth 2 y)))))))
|
|
|
|
|
((eq byte-compile-call-tree-sort 'name)
|
|
|
|
|
(function (lambda (x y) (string< (car x)
|
|
|
|
|
(car y)))))
|
1992-07-15 20:26:37 +00:00
|
|
|
|
(t (error "`byte-compile-call-tree-sort': `%s' - unknown sort mode"
|
1992-07-10 22:06:47 +00:00
|
|
|
|
byte-compile-call-tree-sort))))))
|
|
|
|
|
(message "Generating call tree...")
|
|
|
|
|
(let ((rest byte-compile-call-tree)
|
|
|
|
|
(b (current-buffer))
|
|
|
|
|
f p
|
|
|
|
|
callers calls)
|
|
|
|
|
(while rest
|
|
|
|
|
(prin1 (car (car rest)) b)
|
|
|
|
|
(setq callers (nth 1 (car rest))
|
|
|
|
|
calls (nth 2 (car rest)))
|
|
|
|
|
(insert "\t"
|
|
|
|
|
(cond ((not (fboundp (setq f (car (car rest)))))
|
|
|
|
|
(if (null f)
|
|
|
|
|
" <top level>";; shouldn't insert nil then, actually -sk
|
|
|
|
|
" <not defined>"))
|
|
|
|
|
((subrp (setq f (symbol-function f)))
|
|
|
|
|
" <subr>")
|
|
|
|
|
((symbolp f)
|
|
|
|
|
(format " ==> %s" f))
|
* disass.el (disassemble): Add autoload cookie for this.
* bytecomp.el (byte-decompile-bytecode): Add an autoload for this.
compiled-function-p has been renamed to byte-code-function-p.
* subr.el: Define compiled-function-p as an alias for it.
* bytecomp.el: Register compiled-function-p as obsolete.
* bytecomp.el, byte-opt.el, disass.el, help.el, map-ynp.el: Change
uses.
unread-command-event has been replaced by unread-command-events.
* simple.el (prefix-arg-internal): Use this to push back all
key sequences for processing by the main command loop, instead of
trying to simulate its behavior ourselves.
* bytecomp.el: Document unread-command-event as an obsolete
variable, although nothing but the GNU Emacs 19 sources use it.
Adjust obsolescence message for unread-command-char.
* comint.el (comint-dynamic-list-completions): Change uses of
unread-command-event to work with unread-command-events.
* ebuff-menu.el (electric-buffer-list, Electric-buffer-menu-exit):
Same.
* edebug.el (edebug-outside-excursion): Same.
* ehelp.el (electric-help-command-loop): Same.
* electric.el (Electric-command-loop): Same.
* emerge.el (emerge-show-file-name): Same.
* fortran.el (fortran-abbrev-start,
fortran-window-create-momentarily): Same.
* gnus.el (gnus-Subject-next-article): Same.
* info.el (Info-summary): Same.
* isearch-mode.el (isearch-update, isearch-unread): Same.
* map-ynp.el (map-y-or-n-p): Same.
* mlsupport.el (push-back-character): Same.
* replace.el (perform-replace): Same.
* simula.el (simula-electric-label): Same.
* subr.el (read-quoted-char, momentary-string-display): Same.
* sun-mouse.el (mouse-second-hit): Same.
* terminal.el (te-escape-extended-command-unread): Same.
* vip.el (vip-escape-to-emacs, vip-prefix-arg-value,
vip-prefix-arg-com): Same.
1993-01-26 01:36:02 +00:00
|
|
|
|
((byte-code-function-p f)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
"<compiled function>")
|
|
|
|
|
((not (consp f))
|
|
|
|
|
"<malformed function>")
|
|
|
|
|
((eq 'macro (car f))
|
* disass.el (disassemble): Add autoload cookie for this.
* bytecomp.el (byte-decompile-bytecode): Add an autoload for this.
compiled-function-p has been renamed to byte-code-function-p.
* subr.el: Define compiled-function-p as an alias for it.
* bytecomp.el: Register compiled-function-p as obsolete.
* bytecomp.el, byte-opt.el, disass.el, help.el, map-ynp.el: Change
uses.
unread-command-event has been replaced by unread-command-events.
* simple.el (prefix-arg-internal): Use this to push back all
key sequences for processing by the main command loop, instead of
trying to simulate its behavior ourselves.
* bytecomp.el: Document unread-command-event as an obsolete
variable, although nothing but the GNU Emacs 19 sources use it.
Adjust obsolescence message for unread-command-char.
* comint.el (comint-dynamic-list-completions): Change uses of
unread-command-event to work with unread-command-events.
* ebuff-menu.el (electric-buffer-list, Electric-buffer-menu-exit):
Same.
* edebug.el (edebug-outside-excursion): Same.
* ehelp.el (electric-help-command-loop): Same.
* electric.el (Electric-command-loop): Same.
* emerge.el (emerge-show-file-name): Same.
* fortran.el (fortran-abbrev-start,
fortran-window-create-momentarily): Same.
* gnus.el (gnus-Subject-next-article): Same.
* info.el (Info-summary): Same.
* isearch-mode.el (isearch-update, isearch-unread): Same.
* map-ynp.el (map-y-or-n-p): Same.
* mlsupport.el (push-back-character): Same.
* replace.el (perform-replace): Same.
* simula.el (simula-electric-label): Same.
* subr.el (read-quoted-char, momentary-string-display): Same.
* sun-mouse.el (mouse-second-hit): Same.
* terminal.el (te-escape-extended-command-unread): Same.
* vip.el (vip-escape-to-emacs, vip-prefix-arg-value,
vip-prefix-arg-com): Same.
1993-01-26 01:36:02 +00:00
|
|
|
|
(if (or (byte-code-function-p (cdr f))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(assq 'byte-code (cdr (cdr (cdr f)))))
|
|
|
|
|
" <compiled macro>"
|
|
|
|
|
" <macro>"))
|
|
|
|
|
((assq 'byte-code (cdr (cdr f)))
|
|
|
|
|
"<compiled lambda>")
|
|
|
|
|
((eq 'lambda (car f))
|
|
|
|
|
"<function>")
|
|
|
|
|
(t "???"))
|
|
|
|
|
(format " (%d callers + %d calls = %d)"
|
|
|
|
|
;; Does the optimizer eliminate common subexpressions?-sk
|
|
|
|
|
(length callers)
|
|
|
|
|
(length calls)
|
|
|
|
|
(+ (length callers) (length calls)))
|
|
|
|
|
"\n")
|
|
|
|
|
(if callers
|
|
|
|
|
(progn
|
|
|
|
|
(insert " called by:\n")
|
|
|
|
|
(setq p (point))
|
|
|
|
|
(insert " " (if (car callers)
|
|
|
|
|
(mapconcat 'symbol-name callers ", ")
|
|
|
|
|
"<top level>"))
|
|
|
|
|
(let ((fill-prefix " "))
|
2004-09-08 12:04:22 +00:00
|
|
|
|
(fill-region-as-paragraph p (point)))
|
|
|
|
|
(unless (= 0 (current-column))
|
|
|
|
|
(insert "\n"))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(if calls
|
|
|
|
|
(progn
|
|
|
|
|
(insert " calls:\n")
|
|
|
|
|
(setq p (point))
|
|
|
|
|
(insert " " (mapconcat 'symbol-name calls ", "))
|
|
|
|
|
(let ((fill-prefix " "))
|
2004-09-08 12:04:22 +00:00
|
|
|
|
(fill-region-as-paragraph p (point)))
|
|
|
|
|
(unless (= 0 (current-column))
|
|
|
|
|
(insert "\n"))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(setq rest (cdr rest)))
|
|
|
|
|
|
|
|
|
|
(message "Generating call tree...(finding uncalled functions...)")
|
|
|
|
|
(setq rest byte-compile-call-tree)
|
|
|
|
|
(let ((uncalled nil))
|
|
|
|
|
(while rest
|
|
|
|
|
(or (nth 1 (car rest))
|
|
|
|
|
(null (setq f (car (car rest))))
|
2004-11-09 10:33:23 +00:00
|
|
|
|
(functionp (byte-compile-fdefinition f t))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(commandp (byte-compile-fdefinition f nil))
|
|
|
|
|
(setq uncalled (cons f uncalled)))
|
|
|
|
|
(setq rest (cdr rest)))
|
|
|
|
|
(if uncalled
|
|
|
|
|
(let ((fill-prefix " "))
|
|
|
|
|
(insert "Noninteractive functions not known to be called:\n ")
|
|
|
|
|
(setq p (point))
|
|
|
|
|
(insert (mapconcat 'symbol-name (nreverse uncalled) ", "))
|
|
|
|
|
(fill-region-as-paragraph p (point)))))
|
|
|
|
|
)
|
|
|
|
|
(message "Generating call tree...done.")
|
|
|
|
|
))
|
|
|
|
|
|
|
|
|
|
|
2002-03-22 23:05:26 +00:00
|
|
|
|
;;;###autoload
|
2002-02-01 04:14:14 +00:00
|
|
|
|
(defun batch-byte-compile-if-not-done ()
|
|
|
|
|
"Like `byte-compile-file' but doesn't recompile if already up to date.
|
|
|
|
|
Use this from the command line, with `-batch';
|
|
|
|
|
it won't work in an interactive Emacs."
|
|
|
|
|
(batch-byte-compile t))
|
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;;; by crl@newton.purdue.edu
|
|
|
|
|
;;; Only works noninteractively.
|
1992-07-19 01:07:07 +00:00
|
|
|
|
;;;###autoload
|
2002-02-01 04:14:14 +00:00
|
|
|
|
(defun batch-byte-compile (&optional noforce)
|
1992-07-15 20:26:37 +00:00
|
|
|
|
"Run `byte-compile-file' on the files remaining on the command line.
|
|
|
|
|
Use this from the command line, with `-batch';
|
|
|
|
|
it won't work in an interactive Emacs.
|
|
|
|
|
Each file is processed even if an error occurred previously.
|
2002-02-01 04:14:14 +00:00
|
|
|
|
For example, invoke \"emacs -batch -f batch-byte-compile $emacs/ ~/*.el\".
|
|
|
|
|
If NOFORCE is non-nil, don't recompile a file that seems to be
|
|
|
|
|
already up-to-date."
|
1992-07-10 22:06:47 +00:00
|
|
|
|
;; command-line-args-left is what is left of the command line (from startup.el)
|
|
|
|
|
(defvar command-line-args-left) ;Avoid 'free variable' warning
|
|
|
|
|
(if (not noninteractive)
|
1992-07-15 20:26:37 +00:00
|
|
|
|
(error "`batch-byte-compile' is to be used only with -batch"))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(let ((error nil))
|
|
|
|
|
(while command-line-args-left
|
|
|
|
|
(if (file-directory-p (expand-file-name (car command-line-args-left)))
|
2002-02-01 04:14:14 +00:00
|
|
|
|
;; Directory as argument.
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(let ((bytecomp-files (directory-files (car command-line-args-left)))
|
|
|
|
|
bytecomp-source bytecomp-dest)
|
|
|
|
|
(dolist (bytecomp-file bytecomp-files)
|
|
|
|
|
(if (and (string-match emacs-lisp-file-regexp bytecomp-file)
|
|
|
|
|
(not (auto-save-file-name-p bytecomp-file))
|
|
|
|
|
(setq bytecomp-source
|
|
|
|
|
(expand-file-name bytecomp-file
|
|
|
|
|
(car command-line-args-left)))
|
|
|
|
|
(setq bytecomp-dest (byte-compile-dest-file
|
|
|
|
|
bytecomp-source))
|
|
|
|
|
(file-exists-p bytecomp-dest)
|
|
|
|
|
(file-newer-than-file-p bytecomp-source bytecomp-dest))
|
|
|
|
|
(if (null (batch-byte-compile-file bytecomp-source))
|
2001-10-29 17:26:26 +00:00
|
|
|
|
(setq error t)))))
|
2002-02-01 04:14:14 +00:00
|
|
|
|
;; Specific file argument
|
|
|
|
|
(if (or (not noforce)
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(let* ((bytecomp-source (car command-line-args-left))
|
|
|
|
|
(bytecomp-dest (byte-compile-dest-file bytecomp-source)))
|
|
|
|
|
(or (not (file-exists-p bytecomp-dest))
|
|
|
|
|
(file-newer-than-file-p bytecomp-source bytecomp-dest))))
|
2002-02-01 04:14:14 +00:00
|
|
|
|
(if (null (batch-byte-compile-file (car command-line-args-left)))
|
|
|
|
|
(setq error t))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(setq command-line-args-left (cdr command-line-args-left)))
|
|
|
|
|
(kill-emacs (if error 1 0))))
|
|
|
|
|
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(defun batch-byte-compile-file (bytecomp-file)
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(if debug-on-error
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(byte-compile-file bytecomp-file)
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(condition-case err
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(byte-compile-file bytecomp-file)
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(file-error
|
|
|
|
|
(message (if (cdr err)
|
|
|
|
|
">>Error occurred processing %s: %s (%s)"
|
2002-05-29 16:38:46 +00:00
|
|
|
|
">>Error occurred processing %s: %s")
|
2008-03-01 21:11:37 +00:00
|
|
|
|
bytecomp-file
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(get (car err) 'error-message)
|
|
|
|
|
(prin1-to-string (cdr err)))
|
2008-03-01 21:11:37 +00:00
|
|
|
|
(let ((bytecomp-destfile (byte-compile-dest-file bytecomp-file)))
|
|
|
|
|
(if (file-exists-p bytecomp-destfile)
|
|
|
|
|
(delete-file bytecomp-destfile)))
|
2004-04-16 12:51:06 +00:00
|
|
|
|
nil)
|
|
|
|
|
(error
|
|
|
|
|
(message (if (cdr err)
|
|
|
|
|
">>Error occurred processing %s: %s (%s)"
|
1992-07-10 22:06:47 +00:00
|
|
|
|
">>Error occurred processing %s: %s")
|
2008-03-01 21:11:37 +00:00
|
|
|
|
bytecomp-file
|
2004-04-16 12:51:06 +00:00
|
|
|
|
(get (car err) 'error-message)
|
|
|
|
|
(prin1-to-string (cdr err)))
|
|
|
|
|
nil))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
1993-12-23 03:37:27 +00:00
|
|
|
|
;;;###autoload
|
2004-04-21 22:34:27 +00:00
|
|
|
|
(defun batch-byte-recompile-directory (&optional arg)
|
2002-09-09 21:41:34 +00:00
|
|
|
|
"Run `byte-recompile-directory' on the dirs remaining on the command line.
|
1993-06-13 22:32:17 +00:00
|
|
|
|
Must be used only with `-batch', and kills Emacs on completion.
|
2006-01-13 09:56:23 +00:00
|
|
|
|
For example, invoke `emacs -batch -f batch-byte-recompile-directory .'.
|
|
|
|
|
|
|
|
|
|
Optional argument ARG is passed as second argument ARG to
|
2007-11-26 15:38:18 +00:00
|
|
|
|
`byte-recompile-directory'; see there for its possible values
|
2006-01-13 09:56:23 +00:00
|
|
|
|
and corresponding effects."
|
1993-06-11 16:19:49 +00:00
|
|
|
|
;; command-line-args-left is what is left of the command line (startup.el)
|
|
|
|
|
(defvar command-line-args-left) ;Avoid 'free variable' warning
|
|
|
|
|
(if (not noninteractive)
|
|
|
|
|
(error "batch-byte-recompile-directory is to be used only with -batch"))
|
|
|
|
|
(or command-line-args-left
|
|
|
|
|
(setq command-line-args-left '(".")))
|
|
|
|
|
(while command-line-args-left
|
2004-04-21 22:34:27 +00:00
|
|
|
|
(byte-recompile-directory (car command-line-args-left) arg)
|
1993-06-11 16:19:49 +00:00
|
|
|
|
(setq command-line-args-left (cdr command-line-args-left)))
|
|
|
|
|
(kill-emacs 0))
|
|
|
|
|
|
1992-07-10 22:06:47 +00:00
|
|
|
|
(provide 'byte-compile)
|
1993-12-25 00:32:37 +00:00
|
|
|
|
(provide 'bytecomp)
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
;;; report metering (see the hacks in bytecode.c)
|
|
|
|
|
|
2003-07-04 23:47:48 +00:00
|
|
|
|
(defvar byte-code-meter)
|
1992-07-15 20:26:37 +00:00
|
|
|
|
(defun byte-compile-report-ops ()
|
|
|
|
|
(with-output-to-temp-buffer "*Meter*"
|
|
|
|
|
(set-buffer "*Meter*")
|
|
|
|
|
(let ((i 0) n op off)
|
|
|
|
|
(while (< i 256)
|
|
|
|
|
(setq n (aref (aref byte-code-meter 0) i)
|
|
|
|
|
off nil)
|
|
|
|
|
(if t ;(not (zerop n))
|
|
|
|
|
(progn
|
|
|
|
|
(setq op i)
|
|
|
|
|
(setq off nil)
|
|
|
|
|
(cond ((< op byte-nth)
|
|
|
|
|
(setq off (logand op 7))
|
|
|
|
|
(setq op (logand op 248)))
|
|
|
|
|
((>= op byte-constant)
|
|
|
|
|
(setq off (- op byte-constant)
|
|
|
|
|
op byte-constant)))
|
|
|
|
|
(setq op (aref byte-code-vector op))
|
|
|
|
|
(insert (format "%-4d" i))
|
|
|
|
|
(insert (symbol-name op))
|
|
|
|
|
(if off (insert " [" (int-to-string off) "]"))
|
|
|
|
|
(indent-to 40)
|
|
|
|
|
(insert (int-to-string n) "\n")))
|
|
|
|
|
(setq i (1+ i))))))
|
1992-07-10 22:06:47 +00:00
|
|
|
|
|
|
|
|
|
;; To avoid "lisp nesting exceeds max-lisp-eval-depth" when bytecomp compiles
|
|
|
|
|
;; itself, compile some of its most used recursive functions (at load time).
|
|
|
|
|
;;
|
|
|
|
|
(eval-when-compile
|
1995-07-09 13:01:31 +00:00
|
|
|
|
(or (byte-code-function-p (symbol-function 'byte-compile-form))
|
|
|
|
|
(assq 'byte-code (symbol-function 'byte-compile-form))
|
|
|
|
|
(let ((byte-optimize nil) ; do it fast
|
|
|
|
|
(byte-compile-warnings nil))
|
2007-09-21 07:13:28 +00:00
|
|
|
|
(mapc (lambda (x)
|
|
|
|
|
(or noninteractive (message "compiling %s..." x))
|
|
|
|
|
(byte-compile x)
|
|
|
|
|
(or noninteractive (message "compiling %s...done" x)))
|
|
|
|
|
'(byte-compile-normal-call
|
|
|
|
|
byte-compile-form
|
|
|
|
|
byte-compile-body
|
|
|
|
|
;; Inserted some more than necessary, to speed it up.
|
|
|
|
|
byte-compile-top-level
|
|
|
|
|
byte-compile-out-toplevel
|
|
|
|
|
byte-compile-constant
|
|
|
|
|
byte-compile-variable-ref))))
|
1995-07-09 13:01:31 +00:00
|
|
|
|
nil)
|
1992-07-19 01:07:07 +00:00
|
|
|
|
|
2000-02-02 15:10:35 +00:00
|
|
|
|
(run-hooks 'bytecomp-load-hook)
|
|
|
|
|
|
2004-11-11 22:44:46 +00:00
|
|
|
|
;; arch-tag: 9c97b0f0-8745-4571-bfc3-8dceb677292a
|
1992-07-19 01:07:07 +00:00
|
|
|
|
;;; bytecomp.el ends here
|