Commit | Line | Data |
---|---|---|
55535639 | 1 | ;;; bytecomp.el --- compilation of Lisp code into byte code |
fd5285f3 | 2 | |
977b50fb | 3 | ;; Copyright (C) 1985, 1986, 1987, 1992, 1994, 1998, 2000, 2001, 2002, |
3731a850 | 4 | ;; 2003, 2004, 2005 Free Software Foundation, Inc. |
3a801d0c | 5 | |
fd5285f3 RS |
6 | ;; Author: Jamie Zawinski <jwz@lucid.com> |
7 | ;; Hallvard Furuseth <hbf@ulrik.uio.no> | |
74dfd056 | 8 | ;; Maintainer: FSF |
713ea1de | 9 | ;; Keywords: lisp |
1c393159 | 10 | |
1c393159 JB |
11 | ;; This file is part of GNU Emacs. |
12 | ||
13 | ;; GNU Emacs is free software; you can redistribute it and/or modify | |
14 | ;; it under the terms of the GNU General Public License as published by | |
fd5285f3 | 15 | ;; the Free Software Foundation; either version 2, or (at your option) |
1c393159 JB |
16 | ;; any later version. |
17 | ||
18 | ;; GNU Emacs is distributed in the hope that it will be useful, | |
19 | ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
20 | ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
21 | ;; GNU General Public License for more details. | |
22 | ||
23 | ;; You should have received a copy of the GNU General Public License | |
b578f267 | 24 | ;; along with GNU Emacs; see the file COPYING. If not, write to the |
3a35cf56 LK |
25 | ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
26 | ;; Boston, MA 02110-1301, USA. | |
1c393159 | 27 | |
e41b2db1 ER |
28 | ;;; Commentary: |
29 | ||
30 | ;; The Emacs Lisp byte compiler. This crunches lisp source into a sort | |
a586093f SM |
31 | ;; of p-code (`lapcode') which takes up less space and can be interpreted |
32 | ;; faster. [`LAP' == `Lisp Assembly Program'.] | |
e41b2db1 ER |
33 | ;; The user entry points are byte-compile-file and byte-recompile-directory. |
34 | ||
fd5285f3 RS |
35 | ;;; Code: |
36 | ||
b578f267 EN |
37 | ;; ======================================================================== |
38 | ;; Entry points: | |
39 | ;; byte-recompile-directory, byte-compile-file, | |
40 | ;; batch-byte-compile, batch-byte-recompile-directory, | |
41 | ;; byte-compile, compile-defun, | |
42 | ;; display-call-tree | |
43 | ;; (byte-compile-buffer and byte-compile-and-load-file were turned off | |
44 | ;; because they are not terribly useful and get in the way of completion.) | |
45 | ||
46 | ;; This version of the byte compiler has the following improvements: | |
47 | ;; + optimization of compiled code: | |
48 | ;; - removal of unreachable code; | |
49 | ;; - removal of calls to side-effectless functions whose return-value | |
50 | ;; is unused; | |
51 | ;; - compile-time evaluation of safe constant forms, such as (consp nil) | |
52 | ;; and (ash 1 6); | |
53 | ;; - open-coding of literal lambdas; | |
54 | ;; - peephole optimization of emitted code; | |
55 | ;; - trivial functions are left uncompiled for speed. | |
56 | ;; + support for inline functions; | |
57 | ;; + compile-time evaluation of arbitrary expressions; | |
58 | ;; + compile-time warning messages for: | |
59 | ;; - functions being redefined with incompatible arglists; | |
60 | ;; - functions being redefined as macros, or vice-versa; | |
61 | ;; - functions or macros defined multiple times in the same file; | |
62 | ;; - functions being called with the incorrect number of arguments; | |
c5091f25 | 63 | ;; - functions being called which are not defined globally, in the |
b578f267 EN |
64 | ;; file, or as autoloads; |
65 | ;; - assignment and reference of undeclared free variables; | |
66 | ;; - various syntax errors; | |
67 | ;; + correct compilation of nested defuns, defmacros, defvars and defsubsts; | |
68 | ;; + correct compilation of top-level uses of macros; | |
69 | ;; + the ability to generate a histogram of functions called. | |
70 | ||
71 | ;; User customization variables: | |
72 | ;; | |
73 | ;; byte-compile-verbose Whether to report the function currently being | |
7618fe8e | 74 | ;; compiled in the echo area; |
c5091f25 | 75 | ;; byte-optimize Whether to do optimizations; this may be |
b578f267 | 76 | ;; t, nil, 'source, or 'byte; |
c5091f25 | 77 | ;; byte-optimize-log Whether to report (in excruciating detail) |
b578f267 EN |
78 | ;; exactly which optimizations have been made. |
79 | ;; This may be t, nil, 'source, or 'byte; | |
80 | ;; byte-compile-error-on-warn Whether to stop compilation when a warning is | |
81 | ;; produced; | |
82 | ;; byte-compile-delete-errors Whether the optimizer may delete calls or | |
83 | ;; variable references that are side-effect-free | |
84 | ;; except that they may return an error. | |
85 | ;; byte-compile-generate-call-tree Whether to generate a histogram of | |
c5091f25 | 86 | ;; function calls. This can be useful for |
b578f267 EN |
87 | ;; finding unused functions, as well as simple |
88 | ;; performance metering. | |
89 | ;; byte-compile-warnings List of warnings to issue, or t. May contain | |
f1b1a9f2 RS |
90 | ;; `free-vars' (references to variables not in the |
91 | ;; current lexical scope) | |
92 | ;; `unresolved' (calls to unknown functions) | |
93 | ;; `callargs' (lambda calls with args that don't | |
94 | ;; match the lambda's definition) | |
95 | ;; `redefine' (function cell redefined from | |
96 | ;; a macro to a lambda or vice versa, | |
97 | ;; or redefined to take other args) | |
98 | ;; `obsolete' (obsolete variables and functions) | |
99 | ;; `noruntime' (calls to functions only defined | |
100 | ;; within `eval-when-compile') | |
086af77c RS |
101 | ;; `cl-warnings' (calls to CL functions) |
102 | ;; `interactive-only' (calls to commands that are | |
103 | ;; not good to call from Lisp) | |
b578f267 EN |
104 | ;; byte-compile-compatibility Whether the compiler should |
105 | ;; generate .elc files which can be loaded into | |
106 | ;; generic emacs 18. | |
107 | ;; emacs-lisp-file-regexp Regexp for the extension of source-files; | |
108 | ;; see also the function byte-compile-dest-file. | |
109 | ||
110 | ;; New Features: | |
111 | ;; | |
112 | ;; o The form `defsubst' is just like `defun', except that the function | |
113 | ;; generated will be open-coded in compiled code which uses it. This | |
114 | ;; means that no function call will be generated, it will simply be | |
115 | ;; spliced in. Lisp functions calls are very slow, so this can be a | |
116 | ;; big win. | |
117 | ;; | |
118 | ;; You can generally accomplish the same thing with `defmacro', but in | |
119 | ;; that case, the defined procedure can't be used as an argument to | |
120 | ;; mapcar, etc. | |
121 | ;; | |
122 | ;; o You can also open-code one particular call to a function without | |
123 | ;; open-coding all calls. Use the 'inline' form to do this, like so: | |
124 | ;; | |
125 | ;; (inline (foo 1 2 3)) ;; `foo' will be open-coded | |
126 | ;; or... | |
c5091f25 | 127 | ;; (inline ;; `foo' and `baz' will be |
b578f267 EN |
128 | ;; (foo 1 2 3 (bar 5)) ;; open-coded, but `bar' will not. |
129 | ;; (baz 0)) | |
130 | ;; | |
131 | ;; o It is possible to open-code a function in the same file it is defined | |
9a7268cf | 132 | ;; in without having to load that file before compiling it. The |
b578f267 EN |
133 | ;; byte-compiler has been modified to remember function definitions in |
134 | ;; the compilation environment in the same way that it remembers macro | |
135 | ;; definitions. | |
136 | ;; | |
137 | ;; o Forms like ((lambda ...) ...) are open-coded. | |
138 | ;; | |
139 | ;; o The form `eval-when-compile' is like progn, except that the body | |
140 | ;; is evaluated at compile-time. When it appears at top-level, this | |
141 | ;; is analogous to the Common Lisp idiom (eval-when (compile) ...). | |
142 | ;; When it does not appear at top-level, it is similar to the | |
143 | ;; Common Lisp #. reader macro (but not in interpreted code). | |
144 | ;; | |
145 | ;; o The form `eval-and-compile' is similar to eval-when-compile, but | |
146 | ;; the whole form is evalled both at compile-time and at run-time. | |
147 | ;; | |
148 | ;; o The command compile-defun is analogous to eval-defun. | |
149 | ;; | |
c5091f25 | 150 | ;; o If you run byte-compile-file on a filename which is visited in a |
b578f267 EN |
151 | ;; buffer, and that buffer is modified, you are asked whether you want |
152 | ;; to save the buffer before compiling. | |
153 | ;; | |
154 | ;; o byte-compiled files now start with the string `;ELC'. | |
155 | ;; Some versions of `file' can be customized to recognize that. | |
1c393159 | 156 | |
79d52eea JB |
157 | (require 'backquote) |
158 | ||
1c393159 JB |
159 | (or (fboundp 'defsubst) |
160 | ;; This really ought to be loaded already! | |
6c2161c4 | 161 | (load "byte-run")) |
1c393159 | 162 | |
3614fc84 GM |
163 | ;; The feature of compiling in a specific target Emacs version |
164 | ;; has been turned off because compile time options are a bad idea. | |
52799cb8 RS |
165 | (defmacro byte-compile-single-version () nil) |
166 | (defmacro byte-compile-version-cond (cond) cond) | |
1c393159 | 167 | |
3614fc84 GM |
168 | ;; The crud you see scattered through this file of the form |
169 | ;; (or (and (boundp 'epoch::version) epoch::version) | |
170 | ;; (string-lessp emacs-version "19")) | |
171 | ;; is because the Epoch folks couldn't be bothered to follow the | |
172 | ;; normal emacs version numbering convention. | |
1c393159 | 173 | |
52799cb8 RS |
174 | ;; (if (byte-compile-version-cond |
175 | ;; (or (and (boundp 'epoch::version) epoch::version) | |
176 | ;; (string-lessp emacs-version "19"))) | |
177 | ;; (progn | |
178 | ;; ;; emacs-18 compatibility. | |
179 | ;; (defvar baud-rate (baud-rate)) ;Define baud-rate if it's undefined | |
1f006824 | 180 | ;; |
52799cb8 | 181 | ;; (if (byte-compile-single-version) |
ed015bdd JB |
182 | ;; (defmacro byte-code-function-p (x) "Emacs 18 doesn't have these." nil) |
183 | ;; (defun byte-code-function-p (x) "Emacs 18 doesn't have these." nil)) | |
1f006824 | 184 | ;; |
52799cb8 RS |
185 | ;; (or (and (fboundp 'member) |
186 | ;; ;; avoid using someone else's possibly bogus definition of this. | |
187 | ;; (subrp (symbol-function 'member))) | |
188 | ;; (defun member (elt list) | |
189 | ;; "like memq, but uses equal instead of eq. In v19, this is a subr." | |
190 | ;; (while (and list (not (equal elt (car list)))) | |
191 | ;; (setq list (cdr list))) | |
192 | ;; list)))) | |
193 | ||
194 | ||
713ea1de | 195 | (defgroup bytecomp nil |
25d1fc94 | 196 | "Emacs Lisp byte-compiler." |
713ea1de RS |
197 | :group 'lisp) |
198 | ||
199 | (defcustom emacs-lisp-file-regexp (if (eq system-type 'vax-vms) | |
200 | "\\.EL\\(;[0-9]+\\)?$" | |
201 | "\\.el$") | |
52799cb8 | 202 | "*Regexp which matches Emacs Lisp source files. |
713ea1de RS |
203 | You may want to redefine the function `byte-compile-dest-file' |
204 | if you change this variable." | |
205 | :group 'bytecomp | |
206 | :type 'regexp) | |
1c393159 | 207 | |
2140206e RS |
208 | ;; This enables file name handlers such as jka-compr |
209 | ;; to remove parts of the file name that should not be copied | |
210 | ;; through to the output file name. | |
211 | (defun byte-compiler-base-file-name (filename) | |
212 | (let ((handler (find-file-name-handler filename | |
213 | 'byte-compiler-base-file-name))) | |
214 | (if handler | |
215 | (funcall handler 'byte-compiler-base-file-name filename) | |
216 | filename))) | |
217 | ||
1c393159 | 218 | (or (fboundp 'byte-compile-dest-file) |
e27c3564 | 219 | ;; The user may want to redefine this along with emacs-lisp-file-regexp, |
1c393159 JB |
220 | ;; so only define it if it is undefined. |
221 | (defun byte-compile-dest-file (filename) | |
52799cb8 | 222 | "Convert an Emacs Lisp source file name to a compiled file name." |
2140206e | 223 | (setq filename (byte-compiler-base-file-name filename)) |
1c393159 JB |
224 | (setq filename (file-name-sans-versions filename)) |
225 | (cond ((eq system-type 'vax-vms) | |
01c925e9 RS |
226 | (concat (substring filename 0 (string-match ";" filename)) "c")) |
227 | ((string-match emacs-lisp-file-regexp filename) | |
228 | (concat (substring filename 0 (match-beginning 0)) ".elc")) | |
229 | (t (concat filename ".elc"))))) | |
1c393159 JB |
230 | |
231 | ;; This can be the 'byte-compile property of any symbol. | |
52799cb8 | 232 | (autoload 'byte-compile-inline-expand "byte-opt") |
1c393159 JB |
233 | |
234 | ;; This is the entrypoint to the lapcode optimizer pass1. | |
52799cb8 | 235 | (autoload 'byte-optimize-form "byte-opt") |
1c393159 | 236 | ;; This is the entrypoint to the lapcode optimizer pass2. |
52799cb8 RS |
237 | (autoload 'byte-optimize-lapcode "byte-opt") |
238 | (autoload 'byte-compile-unfold-lambda "byte-opt") | |
1c393159 | 239 | |
ed015bdd JB |
240 | ;; This is the entry point to the decompiler, which is used by the |
241 | ;; disassembler. The disassembler just requires 'byte-compile, but | |
242 | ;; that doesn't define this function, so this seems to be a reasonable | |
243 | ;; thing to do. | |
244 | (autoload 'byte-decompile-bytecode "byte-opt") | |
245 | ||
713ea1de | 246 | (defcustom byte-compile-verbose |
1c393159 | 247 | (and (not noninteractive) (> baud-rate search-slow-speed)) |
713ea1de RS |
248 | "*Non-nil means print messages describing progress of byte-compiler." |
249 | :group 'bytecomp | |
250 | :type 'boolean) | |
1c393159 | 251 | |
713ea1de | 252 | (defcustom byte-compile-compatibility nil |
ab43c850 RS |
253 | "*Non-nil means generate output that can run in Emacs 18. |
254 | This only means that it can run in principle, if it doesn't require | |
255 | facilities that have been added more recently." | |
713ea1de RS |
256 | :group 'bytecomp |
257 | :type 'boolean) | |
52799cb8 RS |
258 | |
259 | ;; (defvar byte-compile-generate-emacs19-bytecodes | |
260 | ;; (not (or (and (boundp 'epoch::version) epoch::version) | |
261 | ;; (string-lessp emacs-version "19"))) | |
c5091f25 | 262 | ;; "*If this is true, then the byte-compiler will generate bytecode which |
52799cb8 RS |
263 | ;; makes use of byte-ops which are present only in Emacs 19. Code generated |
264 | ;; this way can never be run in Emacs 18, and may even cause it to crash.") | |
1c393159 | 265 | |
713ea1de | 266 | (defcustom byte-optimize t |
ab94e6e7 RS |
267 | "*Enables optimization in the byte compiler. |
268 | nil means don't do any optimization. | |
269 | t means do all optimizations. | |
270 | `source' means do source-level optimizations only. | |
713ea1de RS |
271 | `byte' means do code-level optimizations only." |
272 | :group 'bytecomp | |
273 | :type '(choice (const :tag "none" nil) | |
274 | (const :tag "all" t) | |
275 | (const :tag "source-level" source) | |
276 | (const :tag "byte-level" byte))) | |
277 | ||
cd91e34c | 278 | (defcustom byte-compile-delete-errors nil |
ab94e6e7 | 279 | "*If non-nil, the optimizer may delete forms that may signal an error. |
713ea1de RS |
280 | This includes variable references and calls to functions such as `car'." |
281 | :group 'bytecomp | |
282 | :type 'boolean) | |
1c393159 | 283 | |
d82e848c | 284 | (defvar byte-compile-dynamic nil |
713ea1de | 285 | "If non-nil, compile function bodies so they load lazily. |
458f70dc RS |
286 | They are hidden in comments in the compiled file, |
287 | and each one is brought into core when the | |
d82e848c RS |
288 | function is called. |
289 | ||
290 | To enable this option, make it a file-local variable | |
291 | in the source file you want it to apply to. | |
292 | For example, add -*-byte-compile-dynamic: t;-*- on the first line. | |
293 | ||
294 | When this option is true, if you load the compiled file and then move it, | |
295 | the functions you loaded will not be able to run.") | |
296 | ||
713ea1de | 297 | (defcustom byte-compile-dynamic-docstrings t |
d82e848c RS |
298 | "*If non-nil, compile doc strings for lazy access. |
299 | We bury the doc strings of functions and variables | |
300 | inside comments in the file, and bring them into core only when they | |
301 | are actually needed. | |
302 | ||
303 | When this option is true, if you load the compiled file and then move it, | |
304 | you won't be able to find the documentation of anything in that file. | |
305 | ||
1c660f5a KH |
306 | To disable this option for a certain file, make it a file-local variable |
307 | in the source file. For example, add this to the first line: | |
308 | -*-byte-compile-dynamic-docstrings:nil;-*- | |
309 | You can also set the variable globally. | |
310 | ||
713ea1de RS |
311 | This option is enabled by default because it reduces Emacs memory usage." |
312 | :group 'bytecomp | |
313 | :type 'boolean) | |
d82e848c | 314 | |
713ea1de | 315 | (defcustom byte-optimize-log nil |
1c393159 JB |
316 | "*If true, the byte-compiler will log its optimizations into *Compile-Log*. |
317 | If this is 'source, then only source-level optimizations will be logged. | |
713ea1de RS |
318 | If it is 'byte, then only byte-level optimizations will be logged." |
319 | :group 'bytecomp | |
320 | :type '(choice (const :tag "none" nil) | |
321 | (const :tag "all" t) | |
322 | (const :tag "source-level" source) | |
323 | (const :tag "byte-level" byte))) | |
324 | ||
325 | (defcustom byte-compile-error-on-warn nil | |
326 | "*If true, the byte-compiler reports warnings with `error'." | |
327 | :group 'bytecomp | |
328 | :type 'boolean) | |
1c393159 | 329 | |
9290191f | 330 | (defconst byte-compile-warning-types |
086af77c RS |
331 | '(redefine callargs free-vars unresolved |
332 | obsolete noruntime cl-functions interactive-only) | |
4795d1c7 | 333 | "The list of warning types used when `byte-compile-warnings' is t.") |
713ea1de | 334 | (defcustom byte-compile-warnings t |
1c393159 | 335 | "*List of warnings that the byte-compiler should issue (t for all). |
4795d1c7 | 336 | |
9e2b097b JB |
337 | Elements of the list may be be: |
338 | ||
339 | free-vars references to variables not in the current lexical scope. | |
340 | unresolved calls to unknown functions. | |
11efeb9b RS |
341 | callargs function calls with args that don't match the definition. |
342 | redefine function name redefined from a macro to ordinary function or vice | |
9e2b097b | 343 | versa, or redefined to take a different number of arguments. |
4795d1c7 RS |
344 | obsolete obsolete variables and functions. |
345 | noruntime functions that may not be defined at runtime (typically | |
346 | defined only under `eval-when-compile'). | |
6b8c2efc | 347 | cl-functions calls to runtime functions from the CL package (as |
086af77c RS |
348 | distinguished from macros and aliases). |
349 | interactive-only | |
350 | commands that normally shouldn't be called from Lisp code." | |
713ea1de | 351 | :group 'bytecomp |
4795d1c7 | 352 | :type `(choice (const :tag "All" t) |
aa635691 AS |
353 | (set :menu-tag "Some" |
354 | (const free-vars) (const unresolved) | |
4795d1c7 | 355 | (const callargs) (const redefine) |
086af77c RS |
356 | (const obsolete) (const noruntime) |
357 | (const cl-functions) (const interactive-only)))) | |
358 | ||
359 | (defvar byte-compile-interactive-only-functions | |
360 | '(beginning-of-buffer end-of-buffer replace-string replace-regexp | |
b2e948ee | 361 | insert-file insert-buffer insert-file-literally) |
086af77c | 362 | "List of commands that are not meant to be called from Lisp.") |
1c393159 | 363 | |
9e31e67b RS |
364 | (defvar byte-compile-not-obsolete-var nil |
365 | "If non-nil, this is a variable that shouldn't be reported as obsolete.") | |
366 | ||
713ea1de | 367 | (defcustom byte-compile-generate-call-tree nil |
52799cb8 | 368 | "*Non-nil means collect call-graph information when compiling. |
78bba1c8 | 369 | This records which functions were called and from where. |
52799cb8 RS |
370 | If the value is t, compilation displays the call graph when it finishes. |
371 | If the value is neither t nor nil, compilation asks you whether to display | |
372 | the graph. | |
1c393159 JB |
373 | |
374 | The call tree only lists functions called, not macros used. Those functions | |
375 | which the byte-code interpreter knows about directly (eq, cons, etc.) are | |
376 | not reported. | |
377 | ||
378 | The call tree also lists those functions which are not known to be called | |
5023d9a0 | 379 | \(that is, to which no calls have been compiled). Functions which can be |
713ea1de RS |
380 | invoked interactively are excluded from this list." |
381 | :group 'bytecomp | |
382 | :type '(choice (const :tag "Yes" t) (const :tag "No" nil) | |
778c7576 | 383 | (other :tag "Ask" lambda))) |
1c393159 | 384 | |
fef3407e | 385 | (defvar byte-compile-call-tree nil "Alist of functions and their call tree. |
1c393159 JB |
386 | Each element looks like |
387 | ||
388 | \(FUNCTION CALLERS CALLS\) | |
389 | ||
390 | where CALLERS is a list of functions that call FUNCTION, and CALLS | |
391 | is a list of functions for which calls were generated while compiling | |
392 | FUNCTION.") | |
393 | ||
713ea1de | 394 | (defcustom byte-compile-call-tree-sort 'name |
52799cb8 RS |
395 | "*If non-nil, sort the call tree. |
396 | The values `name', `callers', `calls', `calls+callers' | |
713ea1de RS |
397 | specify different fields to sort on." |
398 | :group 'bytecomp | |
399 | :type '(choice (const name) (const callers) (const calls) | |
400 | (const calls+callers) (const nil))) | |
52799cb8 | 401 | |
ccb3c8de CW |
402 | (defvar byte-compile-debug nil) |
403 | ||
52799cb8 RS |
404 | ;; (defvar byte-compile-overwrite-file t |
405 | ;; "If nil, old .elc files are deleted before the new is saved, and .elc | |
406 | ;; files will have the same modes as the corresponding .el file. Otherwise, | |
407 | ;; existing .elc files will simply be overwritten, and the existing modes | |
c5091f25 | 408 | ;; will not be changed. If this variable is nil, then an .elc file which |
52799cb8 RS |
409 | ;; is a symbolic link will be turned into a normal file, instead of the file |
410 | ;; which the link points to being overwritten.") | |
1c393159 JB |
411 | |
412 | (defvar byte-compile-constants nil | |
a586093f | 413 | "List of all constants encountered during compilation of this form.") |
1c393159 | 414 | (defvar byte-compile-variables nil |
a586093f | 415 | "List of all variables encountered during compilation of this form.") |
1c393159 | 416 | (defvar byte-compile-bound-variables nil |
b92dd692 DL |
417 | "List of variables bound in the context of the current form. |
418 | This list lives partly on the stack.") | |
6c2161c4 SM |
419 | (defvar byte-compile-const-variables nil |
420 | "List of variables declared as constants during compilation of this file.") | |
1c393159 JB |
421 | (defvar byte-compile-free-references) |
422 | (defvar byte-compile-free-assignments) | |
423 | ||
ab94e6e7 RS |
424 | (defvar byte-compiler-error-flag) |
425 | ||
1c393159 | 426 | (defconst byte-compile-initial-macro-environment |
52799cb8 RS |
427 | '( |
428 | ;; (byte-compiler-options . (lambda (&rest forms) | |
429 | ;; (apply 'byte-compiler-options-handler forms))) | |
1c393159 | 430 | (eval-when-compile . (lambda (&rest body) |
a586093f SM |
431 | (list 'quote |
432 | (byte-compile-eval (byte-compile-top-level | |
433 | (cons 'progn body)))))) | |
1c393159 | 434 | (eval-and-compile . (lambda (&rest body) |
4795d1c7 | 435 | (byte-compile-eval-before-compile (cons 'progn body)) |
1c393159 JB |
436 | (cons 'progn body)))) |
437 | "The default macro-environment passed to macroexpand by the compiler. | |
438 | Placing a macro here will cause a macro to have different semantics when | |
439 | expanded by the compiler as when expanded by the interpreter.") | |
440 | ||
441 | (defvar byte-compile-macro-environment byte-compile-initial-macro-environment | |
52799cb8 RS |
442 | "Alist of macros defined in the file being compiled. |
443 | Each element looks like (MACRONAME . DEFINITION). It is | |
e27c3564 | 444 | \(MACRONAME . nil) when a macro is redefined as a function.") |
1c393159 JB |
445 | |
446 | (defvar byte-compile-function-environment nil | |
52799cb8 RS |
447 | "Alist of functions defined in the file being compiled. |
448 | This is so we can inline them when necessary. | |
449 | Each element looks like (FUNCTIONNAME . DEFINITION). It is | |
a7a7ddf1 RS |
450 | \(FUNCTIONNAME . nil) when a function is redefined as a macro. |
451 | It is \(FUNCTIONNAME . t) when all we know is that it was defined, | |
452 | and we don't know the definition.") | |
1c393159 JB |
453 | |
454 | (defvar byte-compile-unresolved-functions nil | |
a586093f SM |
455 | "Alist of undefined functions to which calls have been compiled. |
456 | Used for warnings when the function is not known to be defined or is later | |
457 | defined with incorrect args.") | |
1c393159 | 458 | |
ab43c850 RS |
459 | (defvar byte-compile-noruntime-functions nil |
460 | "Alist of functions called that may not be defined when the compiled code is run. | |
461 | Used for warnings about calling a function that is defined during compilation | |
462 | but won't necessarily be defined when the compiled file is loaded.") | |
463 | ||
1c393159 JB |
464 | (defvar byte-compile-tag-number 0) |
465 | (defvar byte-compile-output nil | |
466 | "Alist describing contents to put in byte code string. | |
467 | Each element is (INDEX . VALUE)") | |
468 | (defvar byte-compile-depth 0 "Current depth of execution stack.") | |
469 | (defvar byte-compile-maxdepth 0 "Maximum depth of execution stack.") | |
470 | ||
471 | \f | |
472 | ;;; The byte codes; this information is duplicated in bytecomp.c | |
473 | ||
fef3407e | 474 | (defvar byte-code-vector nil |
1c393159 JB |
475 | "An array containing byte-code names indexed by byte-code values.") |
476 | ||
fef3407e | 477 | (defvar byte-stack+-info nil |
1c393159 JB |
478 | "An array with the stack adjustment for each byte-code.") |
479 | ||
480 | (defmacro byte-defop (opcode stack-adjust opname &optional docstring) | |
481 | ;; This is a speed-hack for building the byte-code-vector at compile-time. | |
482 | ;; We fill in the vector at macroexpand-time, and then after the last call | |
483 | ;; to byte-defop, we write the vector out as a constant instead of writing | |
484 | ;; out a bunch of calls to aset. | |
485 | ;; Actually, we don't fill in the vector itself, because that could make | |
486 | ;; it problematic to compile big changes to this compiler; we store the | |
487 | ;; values on its plist, and remove them later in -extrude. | |
488 | (let ((v1 (or (get 'byte-code-vector 'tmp-compile-time-value) | |
489 | (put 'byte-code-vector 'tmp-compile-time-value | |
490 | (make-vector 256 nil)))) | |
491 | (v2 (or (get 'byte-stack+-info 'tmp-compile-time-value) | |
492 | (put 'byte-stack+-info 'tmp-compile-time-value | |
493 | (make-vector 256 nil))))) | |
494 | (aset v1 opcode opname) | |
495 | (aset v2 opcode stack-adjust)) | |
496 | (if docstring | |
497 | (list 'defconst opname opcode (concat "Byte code opcode " docstring ".")) | |
498 | (list 'defconst opname opcode))) | |
499 | ||
500 | (defmacro byte-extrude-byte-code-vectors () | |
501 | (prog1 (list 'setq 'byte-code-vector | |
502 | (get 'byte-code-vector 'tmp-compile-time-value) | |
503 | 'byte-stack+-info | |
504 | (get 'byte-stack+-info 'tmp-compile-time-value)) | |
fd9b0a6b DL |
505 | (put 'byte-code-vector 'tmp-compile-time-value nil) |
506 | (put 'byte-stack+-info 'tmp-compile-time-value nil))) | |
1c393159 JB |
507 | |
508 | ||
509 | ;; unused: 0-7 | |
510 | ||
511 | ;; These opcodes are special in that they pack their argument into the | |
512 | ;; opcode word. | |
513 | ;; | |
514 | (byte-defop 8 1 byte-varref "for variable reference") | |
515 | (byte-defop 16 -1 byte-varset "for setting a variable") | |
516 | (byte-defop 24 -1 byte-varbind "for binding a variable") | |
517 | (byte-defop 32 0 byte-call "for calling a function") | |
518 | (byte-defop 40 0 byte-unbind "for unbinding special bindings") | |
eb8c3be9 | 519 | ;; codes 8-47 are consumed by the preceding opcodes |
1c393159 JB |
520 | |
521 | ;; unused: 48-55 | |
522 | ||
523 | (byte-defop 56 -1 byte-nth) | |
524 | (byte-defop 57 0 byte-symbolp) | |
525 | (byte-defop 58 0 byte-consp) | |
526 | (byte-defop 59 0 byte-stringp) | |
527 | (byte-defop 60 0 byte-listp) | |
528 | (byte-defop 61 -1 byte-eq) | |
529 | (byte-defop 62 -1 byte-memq) | |
530 | (byte-defop 63 0 byte-not) | |
531 | (byte-defop 64 0 byte-car) | |
532 | (byte-defop 65 0 byte-cdr) | |
533 | (byte-defop 66 -1 byte-cons) | |
534 | (byte-defop 67 0 byte-list1) | |
535 | (byte-defop 68 -1 byte-list2) | |
536 | (byte-defop 69 -2 byte-list3) | |
537 | (byte-defop 70 -3 byte-list4) | |
538 | (byte-defop 71 0 byte-length) | |
539 | (byte-defop 72 -1 byte-aref) | |
540 | (byte-defop 73 -2 byte-aset) | |
541 | (byte-defop 74 0 byte-symbol-value) | |
542 | (byte-defop 75 0 byte-symbol-function) ; this was commented out | |
543 | (byte-defop 76 -1 byte-set) | |
544 | (byte-defop 77 -1 byte-fset) ; this was commented out | |
545 | (byte-defop 78 -1 byte-get) | |
546 | (byte-defop 79 -2 byte-substring) | |
547 | (byte-defop 80 -1 byte-concat2) | |
548 | (byte-defop 81 -2 byte-concat3) | |
549 | (byte-defop 82 -3 byte-concat4) | |
550 | (byte-defop 83 0 byte-sub1) | |
551 | (byte-defop 84 0 byte-add1) | |
552 | (byte-defop 85 -1 byte-eqlsign) | |
553 | (byte-defop 86 -1 byte-gtr) | |
554 | (byte-defop 87 -1 byte-lss) | |
555 | (byte-defop 88 -1 byte-leq) | |
556 | (byte-defop 89 -1 byte-geq) | |
557 | (byte-defop 90 -1 byte-diff) | |
558 | (byte-defop 91 0 byte-negate) | |
559 | (byte-defop 92 -1 byte-plus) | |
560 | (byte-defop 93 -1 byte-max) | |
561 | (byte-defop 94 -1 byte-min) | |
562 | (byte-defop 95 -1 byte-mult) ; v19 only | |
563 | (byte-defop 96 1 byte-point) | |
1c393159 JB |
564 | (byte-defop 98 0 byte-goto-char) |
565 | (byte-defop 99 0 byte-insert) | |
566 | (byte-defop 100 1 byte-point-max) | |
567 | (byte-defop 101 1 byte-point-min) | |
568 | (byte-defop 102 0 byte-char-after) | |
569 | (byte-defop 103 1 byte-following-char) | |
570 | (byte-defop 104 1 byte-preceding-char) | |
571 | (byte-defop 105 1 byte-current-column) | |
572 | (byte-defop 106 0 byte-indent-to) | |
573 | (byte-defop 107 0 byte-scan-buffer-OBSOLETE) ; no longer generated as of v18 | |
574 | (byte-defop 108 1 byte-eolp) | |
575 | (byte-defop 109 1 byte-eobp) | |
576 | (byte-defop 110 1 byte-bolp) | |
577 | (byte-defop 111 1 byte-bobp) | |
578 | (byte-defop 112 1 byte-current-buffer) | |
579 | (byte-defop 113 0 byte-set-buffer) | |
78943c8a RS |
580 | (byte-defop 114 0 byte-save-current-buffer |
581 | "To make a binding to record the current buffer") | |
1c393159 JB |
582 | (byte-defop 115 0 byte-set-mark-OBSOLETE) |
583 | (byte-defop 116 1 byte-interactive-p) | |
584 | ||
585 | ;; These ops are new to v19 | |
586 | (byte-defop 117 0 byte-forward-char) | |
587 | (byte-defop 118 0 byte-forward-word) | |
588 | (byte-defop 119 -1 byte-skip-chars-forward) | |
589 | (byte-defop 120 -1 byte-skip-chars-backward) | |
590 | (byte-defop 121 0 byte-forward-line) | |
591 | (byte-defop 122 0 byte-char-syntax) | |
592 | (byte-defop 123 -1 byte-buffer-substring) | |
593 | (byte-defop 124 -1 byte-delete-region) | |
594 | (byte-defop 125 -1 byte-narrow-to-region) | |
595 | (byte-defop 126 1 byte-widen) | |
596 | (byte-defop 127 0 byte-end-of-line) | |
597 | ||
598 | ;; unused: 128 | |
599 | ||
600 | ;; These store their argument in the next two bytes | |
601 | (byte-defop 129 1 byte-constant2 | |
602 | "for reference to a constant with vector index >= byte-constant-limit") | |
603 | (byte-defop 130 0 byte-goto "for unconditional jump") | |
604 | (byte-defop 131 -1 byte-goto-if-nil "to pop value and jump if it's nil") | |
605 | (byte-defop 132 -1 byte-goto-if-not-nil "to pop value and jump if it's not nil") | |
606 | (byte-defop 133 -1 byte-goto-if-nil-else-pop | |
c5091f25 | 607 | "to examine top-of-stack, jump and don't pop it if it's nil, |
1c393159 JB |
608 | otherwise pop it") |
609 | (byte-defop 134 -1 byte-goto-if-not-nil-else-pop | |
c5091f25 | 610 | "to examine top-of-stack, jump and don't pop it if it's non nil, |
1c393159 JB |
611 | otherwise pop it") |
612 | ||
613 | (byte-defop 135 -1 byte-return "to pop a value and return it from `byte-code'") | |
614 | (byte-defop 136 -1 byte-discard "to discard one value from stack") | |
615 | (byte-defop 137 1 byte-dup "to duplicate the top of the stack") | |
616 | ||
617 | (byte-defop 138 0 byte-save-excursion | |
618 | "to make a binding to record the buffer, point and mark") | |
619 | (byte-defop 139 0 byte-save-window-excursion | |
620 | "to make a binding to record entire window configuration") | |
621 | (byte-defop 140 0 byte-save-restriction | |
622 | "to make a binding to record the current buffer clipping restrictions") | |
623 | (byte-defop 141 -1 byte-catch | |
624 | "for catch. Takes, on stack, the tag and an expression for the body") | |
625 | (byte-defop 142 -1 byte-unwind-protect | |
626 | "for unwind-protect. Takes, on stack, an expression for the unwind-action") | |
627 | ||
c5091f25 | 628 | ;; For condition-case. Takes, on stack, the variable to bind, |
52799cb8 RS |
629 | ;; an expression for the body, and a list of clauses. |
630 | (byte-defop 143 -2 byte-condition-case) | |
1c393159 | 631 | |
52799cb8 RS |
632 | ;; For entry to with-output-to-temp-buffer. |
633 | ;; Takes, on stack, the buffer name. | |
634 | ;; Binds standard-output and does some other things. | |
635 | ;; Returns with temp buffer on the stack in place of buffer name. | |
636 | (byte-defop 144 0 byte-temp-output-buffer-setup) | |
1c393159 | 637 | |
52799cb8 RS |
638 | ;; For exit from with-output-to-temp-buffer. |
639 | ;; Expects the temp buffer on the stack underneath value to return. | |
640 | ;; Pops them both, then pushes the value back on. | |
641 | ;; Unbinds standard-output and makes the temp buffer visible. | |
642 | (byte-defop 145 -1 byte-temp-output-buffer-show) | |
1c393159 JB |
643 | |
644 | ;; these ops are new to v19 | |
52799cb8 RS |
645 | |
646 | ;; To unbind back to the beginning of this frame. | |
69dc83fd | 647 | ;; Not used yet, but will be needed for tail-recursion elimination. |
52799cb8 | 648 | (byte-defop 146 0 byte-unbind-all) |
1c393159 JB |
649 | |
650 | ;; these ops are new to v19 | |
651 | (byte-defop 147 -2 byte-set-marker) | |
652 | (byte-defop 148 0 byte-match-beginning) | |
653 | (byte-defop 149 0 byte-match-end) | |
654 | (byte-defop 150 0 byte-upcase) | |
655 | (byte-defop 151 0 byte-downcase) | |
656 | (byte-defop 152 -1 byte-string=) | |
657 | (byte-defop 153 -1 byte-string<) | |
658 | (byte-defop 154 -1 byte-equal) | |
659 | (byte-defop 155 -1 byte-nthcdr) | |
660 | (byte-defop 156 -1 byte-elt) | |
661 | (byte-defop 157 -1 byte-member) | |
662 | (byte-defop 158 -1 byte-assq) | |
663 | (byte-defop 159 0 byte-nreverse) | |
664 | (byte-defop 160 -1 byte-setcar) | |
665 | (byte-defop 161 -1 byte-setcdr) | |
666 | (byte-defop 162 0 byte-car-safe) | |
667 | (byte-defop 163 0 byte-cdr-safe) | |
668 | (byte-defop 164 -1 byte-nconc) | |
669 | (byte-defop 165 -1 byte-quo) | |
670 | (byte-defop 166 -1 byte-rem) | |
671 | (byte-defop 167 0 byte-numberp) | |
672 | (byte-defop 168 0 byte-integerp) | |
673 | ||
3eac9910 | 674 | ;; unused: 169-174 |
1c393159 JB |
675 | (byte-defop 175 nil byte-listN) |
676 | (byte-defop 176 nil byte-concatN) | |
677 | (byte-defop 177 nil byte-insertN) | |
678 | ||
679 | ;; unused: 178-191 | |
680 | ||
681 | (byte-defop 192 1 byte-constant "for reference to a constant") | |
682 | ;; codes 193-255 are consumed by byte-constant. | |
683 | (defconst byte-constant-limit 64 | |
684 | "Exclusive maximum index usable in the `byte-constant' opcode.") | |
685 | ||
686 | (defconst byte-goto-ops '(byte-goto byte-goto-if-nil byte-goto-if-not-nil | |
687 | byte-goto-if-nil-else-pop | |
688 | byte-goto-if-not-nil-else-pop) | |
52799cb8 | 689 | "List of byte-codes whose offset is a pc.") |
1c393159 JB |
690 | |
691 | (defconst byte-goto-always-pop-ops '(byte-goto-if-nil byte-goto-if-not-nil)) | |
692 | ||
1c393159 JB |
693 | (byte-extrude-byte-code-vectors) |
694 | \f | |
695 | ;;; lapcode generator | |
3614fc84 GM |
696 | ;; |
697 | ;; the byte-compiler now does source -> lapcode -> bytecode instead of | |
698 | ;; source -> bytecode, because it's a lot easier to make optimizations | |
699 | ;; on lapcode than on bytecode. | |
700 | ;; | |
701 | ;; Elements of the lapcode list are of the form (<instruction> . <parameter>) | |
702 | ;; where instruction is a symbol naming a byte-code instruction, | |
703 | ;; and parameter is an argument to that instruction, if any. | |
704 | ;; | |
705 | ;; The instruction can be the pseudo-op TAG, which means that this position | |
706 | ;; in the instruction stream is a target of a goto. (car PARAMETER) will be | |
707 | ;; the PC for this location, and the whole instruction "(TAG pc)" will be the | |
708 | ;; parameter for some goto op. | |
709 | ;; | |
710 | ;; If the operation is varbind, varref, varset or push-constant, then the | |
711 | ;; parameter is (variable/constant . index_in_constant_vector). | |
712 | ;; | |
713 | ;; First, the source code is macroexpanded and optimized in various ways. | |
714 | ;; Then the resultant code is compiled into lapcode. Another set of | |
715 | ;; optimizations are then run over the lapcode. Then the variables and | |
716 | ;; constants referenced by the lapcode are collected and placed in the | |
717 | ;; constants-vector. (This happens now so that variables referenced by dead | |
718 | ;; code don't consume space.) And finally, the lapcode is transformed into | |
719 | ;; compacted byte-code. | |
720 | ;; | |
721 | ;; A distinction is made between variables and constants because the variable- | |
722 | ;; referencing instructions are more sensitive to the variables being near the | |
723 | ;; front of the constants-vector than the constant-referencing instructions. | |
724 | ;; Also, this lets us notice references to free variables. | |
1c393159 JB |
725 | |
726 | (defun byte-compile-lapcode (lap) | |
727 | "Turns lapcode into bytecode. The lapcode is destroyed." | |
728 | ;; Lapcode modifications: changes the ID of a tag to be the tag's PC. | |
729 | (let ((pc 0) ; Program counter | |
730 | op off ; Operation & offset | |
731 | (bytes '()) ; Put the output bytes here | |
6c2161c4 | 732 | (patchlist nil)) ; List of tags and goto's to patch |
1c393159 JB |
733 | (while lap |
734 | (setq op (car (car lap)) | |
735 | off (cdr (car lap))) | |
736 | (cond ((not (symbolp op)) | |
52799cb8 | 737 | (error "Non-symbolic opcode `%s'" op)) |
1c393159 JB |
738 | ((eq op 'TAG) |
739 | (setcar off pc) | |
740 | (setq patchlist (cons off patchlist))) | |
741 | ((memq op byte-goto-ops) | |
742 | (setq pc (+ pc 3)) | |
743 | (setq bytes (cons (cons pc (cdr off)) | |
744 | (cons nil | |
745 | (cons (symbol-value op) bytes)))) | |
746 | (setq patchlist (cons bytes patchlist))) | |
747 | (t | |
748 | (setq bytes | |
749 | (cond ((cond ((consp off) | |
750 | ;; Variable or constant reference | |
751 | (setq off (cdr off)) | |
752 | (eq op 'byte-constant))) | |
753 | (cond ((< off byte-constant-limit) | |
754 | (setq pc (1+ pc)) | |
755 | (cons (+ byte-constant off) bytes)) | |
756 | (t | |
757 | (setq pc (+ 3 pc)) | |
758 | (cons (lsh off -8) | |
759 | (cons (logand off 255) | |
760 | (cons byte-constant2 bytes)))))) | |
761 | ((<= byte-listN (symbol-value op)) | |
762 | (setq pc (+ 2 pc)) | |
763 | (cons off (cons (symbol-value op) bytes))) | |
764 | ((< off 6) | |
765 | (setq pc (1+ pc)) | |
766 | (cons (+ (symbol-value op) off) bytes)) | |
767 | ((< off 256) | |
768 | (setq pc (+ 2 pc)) | |
769 | (cons off (cons (+ (symbol-value op) 6) bytes))) | |
770 | (t | |
771 | (setq pc (+ 3 pc)) | |
772 | (cons (lsh off -8) | |
773 | (cons (logand off 255) | |
774 | (cons (+ (symbol-value op) 7) | |
775 | bytes)))))))) | |
776 | (setq lap (cdr lap))) | |
777 | ;;(if (not (= pc (length bytes))) | |
52799cb8 | 778 | ;; (error "Compiler error: pc mismatch - %s %s" pc (length bytes))) |
1c393159 JB |
779 | ;; Patch PC into jumps |
780 | (let (bytes) | |
781 | (while patchlist | |
782 | (setq bytes (car patchlist)) | |
783 | (cond ((atom (car bytes))) ; Tag | |
1c393159 JB |
784 | (t ; Absolute jump |
785 | (setq pc (car (cdr (car bytes)))) ; Pick PC from tag | |
786 | (setcar (cdr bytes) (logand pc 255)) | |
787 | (setcar bytes (lsh pc -8)))) | |
788 | (setq patchlist (cdr patchlist)))) | |
789 | (concat (nreverse bytes)))) | |
790 | ||
791 | \f | |
a586093f SM |
792 | ;;; compile-time evaluation |
793 | ||
ea4b0ca3 SM |
794 | (defun byte-compile-eval (form) |
795 | "Eval FORM and mark the functions defined therein. | |
ab43c850 | 796 | Each function's symbol gets added to `byte-compile-noruntime-functions'." |
a586093f SM |
797 | (let ((hist-orig load-history) |
798 | (hist-nil-orig current-load-list)) | |
ea4b0ca3 SM |
799 | (prog1 (eval form) |
800 | (when (memq 'noruntime byte-compile-warnings) | |
a586093f SM |
801 | (let ((hist-new load-history) |
802 | (hist-nil-new current-load-list)) | |
ea4b0ca3 SM |
803 | ;; Go through load-history, look for newly loaded files |
804 | ;; and mark all the functions defined therein. | |
805 | (while (and hist-new (not (eq hist-new hist-orig))) | |
d1a57439 RS |
806 | (let ((xs (pop hist-new)) |
807 | old-autoloads) | |
ea4b0ca3 | 808 | ;; Make sure the file was not already loaded before. |
997011eb RS |
809 | (unless (or (assoc (car xs) hist-orig) |
810 | (equal (car xs) "cl")) | |
ea4b0ca3 SM |
811 | (dolist (s xs) |
812 | (cond | |
d1a57439 RS |
813 | ((symbolp s) |
814 | (unless (memq s old-autoloads) | |
ab43c850 | 815 | (push s byte-compile-noruntime-functions))) |
d1a57439 | 816 | ((and (consp s) (eq t (car s))) |
6c2161c4 | 817 | (push (cdr s) old-autoloads)) |
ea4b0ca3 | 818 | ((and (consp s) (eq 'autoload (car s))) |
ab43c850 | 819 | (push (cdr s) byte-compile-noruntime-functions))))))) |
ea4b0ca3 | 820 | ;; Go through current-load-list for the locally defined funs. |
d1a57439 RS |
821 | (let (old-autoloads) |
822 | (while (and hist-nil-new (not (eq hist-nil-new hist-nil-orig))) | |
823 | (let ((s (pop hist-nil-new))) | |
824 | (when (and (symbolp s) (not (memq s old-autoloads))) | |
ab43c850 | 825 | (push s byte-compile-noruntime-functions)) |
d1a57439 | 826 | (when (and (consp s) (eq t (car s))) |
997011eb RS |
827 | (push (cdr s) old-autoloads))))))) |
828 | (when (memq 'cl-functions byte-compile-warnings) | |
829 | (let ((hist-new load-history) | |
830 | (hist-nil-new current-load-list)) | |
831 | ;; Go through load-history, look for newly loaded files | |
832 | ;; and mark all the functions defined therein. | |
833 | (while (and hist-new (not (eq hist-new hist-orig))) | |
834 | (let ((xs (pop hist-new)) | |
835 | old-autoloads) | |
836 | ;; Make sure the file was not already loaded before. | |
837 | (when (and (equal (car xs) "cl") (not (assoc (car xs) hist-orig))) | |
838 | (byte-compile-find-cl-functions))))))))) | |
a586093f | 839 | |
4795d1c7 RS |
840 | (defun byte-compile-eval-before-compile (form) |
841 | "Evaluate FORM for `eval-and-compile'." | |
842 | (let ((hist-nil-orig current-load-list)) | |
843 | (prog1 (eval form) | |
844 | ;; (eval-and-compile (require 'cl) turns off warnings for cl functions. | |
845 | (let ((tem current-load-list)) | |
846 | (while (not (eq tem hist-nil-orig)) | |
847 | (when (equal (car tem) '(require . cl)) | |
848 | (setq byte-compile-warnings | |
849 | (remq 'cl-functions byte-compile-warnings))) | |
850 | (setq tem (cdr tem))))))) | |
a586093f | 851 | \f |
1c393159 JB |
852 | ;;; byte compiler messages |
853 | ||
d82e848c | 854 | (defvar byte-compile-current-form nil) |
d82e848c | 855 | (defvar byte-compile-dest-file nil) |
9985d391 | 856 | (defvar byte-compile-current-file nil) |
ccb3c8de | 857 | (defvar byte-compile-current-buffer nil) |
6a619620 | 858 | |
22788fb8 | 859 | ;; Log something that isn't a warning. |
1c393159 | 860 | (defmacro byte-compile-log (format-string &rest args) |
b88a41d0 SM |
861 | `(and |
862 | byte-optimize | |
863 | (memq byte-optimize-log '(t source)) | |
864 | (let ((print-escape-newlines t) | |
865 | (print-level 4) | |
866 | (print-length 4)) | |
867 | (byte-compile-log-1 | |
868 | (format | |
869 | ,format-string | |
870 | ,@(mapcar | |
871 | (lambda (x) (if (symbolp x) (list 'prin1-to-string x) x)) | |
872 | args)))))) | |
1c393159 | 873 | |
22788fb8 RS |
874 | ;; Log something that isn't a warning. |
875 | (defun byte-compile-log-1 (string) | |
b88a41d0 | 876 | (with-current-buffer "*Compile-Log*" |
997011eb RS |
877 | (let ((inhibit-read-only t)) |
878 | (goto-char (point-max)) | |
879 | (byte-compile-warning-prefix nil nil) | |
880 | (cond (noninteractive | |
881 | (message " %s" string)) | |
882 | (t | |
883 | (insert (format "%s\n" string))))))) | |
1c393159 | 884 | |
ccb3c8de CW |
885 | (defvar byte-compile-read-position nil |
886 | "Character position we began the last `read' from.") | |
887 | (defvar byte-compile-last-position nil | |
888 | "Last known character position in the input.") | |
889 | ||
890 | ;; copied from gnus-util.el | |
1fd592a0 | 891 | (defsubst byte-compile-delete-first (elt list) |
ccb3c8de CW |
892 | (if (eq (car list) elt) |
893 | (cdr list) | |
894 | (let ((total list)) | |
895 | (while (and (cdr list) | |
896 | (not (eq (cadr list) elt))) | |
897 | (setq list (cdr list))) | |
898 | (when (cdr list) | |
899 | (setcdr list (cddr list))) | |
900 | total))) | |
901 | ||
902 | ;; The purpose of this function is to iterate through the | |
903 | ;; `read-symbol-positions-list'. Each time we process, say, a | |
904 | ;; function definition (`defun') we remove `defun' from | |
905 | ;; `read-symbol-positions-list', and set `byte-compile-last-position' | |
906 | ;; to that symbol's character position. Similarly, if we encounter a | |
907 | ;; variable reference, like in (1+ foo), we remove `foo' from the | |
908 | ;; list. If our current position is after the symbol's position, we | |
909 | ;; assume we've already passed that point, and look for the next | |
6b8c2efc JB |
910 | ;; occurrence of the symbol. |
911 | ;; So your're probably asking yourself: Isn't this function a | |
ccb3c8de CW |
912 | ;; gross hack? And the answer, of course, would be yes. |
913 | (defun byte-compile-set-symbol-position (sym &optional allow-previous) | |
914 | (when byte-compile-read-position | |
1fd592a0 | 915 | (let (last entry) |
ccb3c8de | 916 | (while (progn |
0b46acbf RS |
917 | (setq last byte-compile-last-position |
918 | entry (assq sym read-symbol-positions-list)) | |
919 | (when entry | |
920 | (setq byte-compile-last-position | |
921 | (+ byte-compile-read-position (cdr entry)) | |
922 | read-symbol-positions-list | |
923 | (byte-compile-delete-first | |
924 | entry read-symbol-positions-list))) | |
ccb3c8de CW |
925 | (or (and allow-previous (not (= last byte-compile-last-position))) |
926 | (> last byte-compile-last-position))))))) | |
b8175fe6 | 927 | |
22788fb8 RS |
928 | (defvar byte-compile-last-warned-form nil) |
929 | (defvar byte-compile-last-logged-file nil) | |
930 | ||
22788fb8 | 931 | ;; This is used as warning-prefix for the compiler. |
4390021b | 932 | ;; It is always called with the warnings buffer current. |
22788fb8 | 933 | (defun byte-compile-warning-prefix (level entry) |
997011eb RS |
934 | (let* ((inhibit-read-only t) |
935 | (dir default-directory) | |
4390021b RS |
936 | (file (cond ((stringp byte-compile-current-file) |
937 | (format "%s:" (file-relative-name byte-compile-current-file dir))) | |
b8175fe6 | 938 | ((bufferp byte-compile-current-file) |
1f006824 | 939 | (format "Buffer %s:" |
b8175fe6 GM |
940 | (buffer-name byte-compile-current-file))) |
941 | (t ""))) | |
1f006824 | 942 | (pos (if (and byte-compile-current-file |
ccb3c8de CW |
943 | (integerp byte-compile-read-position)) |
944 | (with-current-buffer byte-compile-current-buffer | |
945 | (format "%d:%d:" (count-lines (point-min) | |
946 | byte-compile-last-position) | |
947 | (save-excursion | |
948 | (goto-char byte-compile-last-position) | |
949 | (1+ (current-column))))) | |
b8175fe6 | 950 | "")) |
4390021b RS |
951 | (form (if (eq byte-compile-current-form :end) "end of data" |
952 | (or byte-compile-current-form "toplevel form")))) | |
953 | (when (or (and byte-compile-current-file | |
954 | (not (equal byte-compile-current-file | |
955 | byte-compile-last-logged-file))) | |
2c0696b1 | 956 | (and byte-compile-current-form |
4390021b RS |
957 | (not (eq byte-compile-current-form |
958 | byte-compile-last-warned-form)))) | |
22788fb8 | 959 | (insert (format "\nIn %s:\n" form))) |
4390021b RS |
960 | (when level |
961 | (insert (format "%s%s" file pos)))) | |
cb3069bb | 962 | (setq byte-compile-last-logged-file byte-compile-current-file |
22788fb8 RS |
963 | byte-compile-last-warned-form byte-compile-current-form) |
964 | entry) | |
1c393159 | 965 | |
4390021b RS |
966 | ;; This no-op function is used as the value of warning-series |
967 | ;; to tell inner calls to displaying-byte-compile-warnings | |
968 | ;; not to bind warning-series. | |
969 | (defun byte-compile-warning-series (&rest ignore) | |
970 | nil) | |
971 | ||
144b2637 | 972 | ;; Log the start of a file in *Compile-Log*, and mark it as done. |
22788fb8 | 973 | ;; Return the position of the start of the page in the log buffer. |
144b2637 RS |
974 | ;; But do nothing in batch mode. |
975 | (defun byte-compile-log-file () | |
4390021b | 976 | (and (not (equal byte-compile-current-file byte-compile-last-logged-file)) |
cb3069bb | 977 | (not noninteractive) |
144b2637 | 978 | (save-excursion |
977f31f8 | 979 | (set-buffer (get-buffer-create "*Compile-Log*")) |
ca96ae0b | 980 | (goto-char (point-max)) |
997011eb RS |
981 | (let* ((inhibit-read-only t) |
982 | (dir (and byte-compile-current-file | |
4390021b RS |
983 | (file-name-directory byte-compile-current-file))) |
984 | (was-same (equal default-directory dir)) | |
985 | pt) | |
986 | (when dir | |
987 | (unless was-same | |
988 | (insert (format "Leaving directory `%s'\n" default-directory)))) | |
989 | (unless (bolp) | |
990 | (insert "\n")) | |
991 | (setq pt (point-marker)) | |
992 | (if byte-compile-current-file | |
993 | (insert "\f\nCompiling " | |
994 | (if (stringp byte-compile-current-file) | |
995 | (concat "file " byte-compile-current-file) | |
996 | (concat "buffer " (buffer-name byte-compile-current-file))) | |
997 | " at " (current-time-string) "\n") | |
998 | (insert "\f\nCompiling no file at " (current-time-string) "\n")) | |
999 | (when dir | |
1000 | (setq default-directory dir) | |
1001 | (unless was-same | |
1002 | (insert (format "Entering directory `%s'\n" default-directory)))) | |
9dbd7d66 RS |
1003 | (setq byte-compile-last-logged-file byte-compile-current-file |
1004 | byte-compile-last-warned-form nil) | |
977f31f8 RS |
1005 | ;; Do this after setting default-directory. |
1006 | (unless (eq major-mode 'compilation-mode) | |
1007 | (compilation-mode)) | |
b88a41d0 | 1008 | (compilation-forget-errors) |
22788fb8 RS |
1009 | pt)))) |
1010 | ||
1011 | ;; Log a message STRING in *Compile-Log*. | |
1012 | ;; Also log the current function and file if not already done. | |
1013 | (defun byte-compile-log-warning (string &optional fill level) | |
1014 | (let ((warning-prefix-function 'byte-compile-warning-prefix) | |
9e31e67b | 1015 | (warning-type-format "") |
997011eb RS |
1016 | (warning-fill-prefix (if fill " ")) |
1017 | (inhibit-read-only t)) | |
22788fb8 | 1018 | (display-warning 'bytecomp string level "*Compile-Log*"))) |
144b2637 | 1019 | |
1c393159 | 1020 | (defun byte-compile-warn (format &rest args) |
22788fb8 | 1021 | "Issue a byte compiler warning; use (format FORMAT ARGS...) for message." |
1c393159 JB |
1022 | (setq format (apply 'format format args)) |
1023 | (if byte-compile-error-on-warn | |
1024 | (error "%s" format) ; byte-compile-file catches and logs it | |
22788fb8 RS |
1025 | (byte-compile-log-warning format t :warning))) |
1026 | ||
0b030df7 | 1027 | (defun byte-compile-report-error (error-info) |
22788fb8 | 1028 | "Report Lisp error in compilation. ERROR-INFO is the error data." |
ab94e6e7 | 1029 | (setq byte-compiler-error-flag t) |
22788fb8 RS |
1030 | (byte-compile-log-warning |
1031 | (error-message-string error-info) | |
1032 | nil :error)) | |
0b030df7 | 1033 | |
1c393159 JB |
1034 | ;;; Used by make-obsolete. |
1035 | (defun byte-compile-obsolete (form) | |
20482b70 SM |
1036 | (let* ((new (get (car form) 'byte-obsolete-info)) |
1037 | (handler (nth 1 new)) | |
1038 | (when (nth 2 new))) | |
ccb3c8de | 1039 | (byte-compile-set-symbol-position (car form)) |
e0b93488 | 1040 | (if (memq 'obsolete byte-compile-warnings) |
1d5c17c0 | 1041 | (byte-compile-warn "`%s' is an obsolete function%s; %s" (car form) |
f1953880 | 1042 | (if when (concat " (as of Emacs " when ")") "") |
9290191f RS |
1043 | (if (stringp (car new)) |
1044 | (car new) | |
1d5c17c0 | 1045 | (format "use `%s' instead." (car new))))) |
20482b70 | 1046 | (funcall (or handler 'byte-compile-normal-call) form))) |
1c393159 JB |
1047 | \f |
1048 | ;; Compiler options | |
1049 | ||
52799cb8 RS |
1050 | ;; (defvar byte-compiler-valid-options |
1051 | ;; '((optimize byte-optimize (t nil source byte) val) | |
1052 | ;; (file-format byte-compile-compatibility (emacs18 emacs19) | |
1053 | ;; (eq val 'emacs18)) | |
1054 | ;; ;; (new-bytecodes byte-compile-generate-emacs19-bytecodes (t nil) val) | |
1055 | ;; (delete-errors byte-compile-delete-errors (t nil) val) | |
1056 | ;; (verbose byte-compile-verbose (t nil) val) | |
1057 | ;; (warnings byte-compile-warnings ((callargs redefine free-vars unresolved)) | |
1058 | ;; val))) | |
1c393159 JB |
1059 | |
1060 | ;; Inhibit v18/v19 selectors if the version is hardcoded. | |
c5091f25 | 1061 | ;; #### This should print a warning if the user tries to change something |
1c393159 | 1062 | ;; than can't be changed because the running compiler doesn't support it. |
52799cb8 RS |
1063 | ;; (cond |
1064 | ;; ((byte-compile-single-version) | |
1065 | ;; (setcar (cdr (cdr (assq 'new-bytecodes byte-compiler-valid-options))) | |
1066 | ;; (list (byte-compile-version-cond | |
1067 | ;; byte-compile-generate-emacs19-bytecodes))) | |
1068 | ;; (setcar (cdr (cdr (assq 'file-format byte-compiler-valid-options))) | |
1069 | ;; (if (byte-compile-version-cond byte-compile-compatibility) | |
1070 | ;; '(emacs18) '(emacs19))))) | |
1071 | ||
1072 | ;; (defun byte-compiler-options-handler (&rest args) | |
1073 | ;; (let (key val desc choices) | |
1074 | ;; (while args | |
1075 | ;; (if (or (atom (car args)) (nthcdr 2 (car args)) (null (cdr (car args)))) | |
1076 | ;; (error "Malformed byte-compiler option `%s'" (car args))) | |
1077 | ;; (setq key (car (car args)) | |
1078 | ;; val (car (cdr (car args))) | |
1079 | ;; desc (assq key byte-compiler-valid-options)) | |
1080 | ;; (or desc | |
1081 | ;; (error "Unknown byte-compiler option `%s'" key)) | |
1082 | ;; (setq choices (nth 2 desc)) | |
1083 | ;; (if (consp (car choices)) | |
1084 | ;; (let (this | |
1085 | ;; (handler 'cons) | |
1086 | ;; (ret (and (memq (car val) '(+ -)) | |
1087 | ;; (copy-sequence (if (eq t (symbol-value (nth 1 desc))) | |
1088 | ;; choices | |
1089 | ;; (symbol-value (nth 1 desc))))))) | |
1090 | ;; (setq choices (car choices)) | |
1091 | ;; (while val | |
1092 | ;; (setq this (car val)) | |
1093 | ;; (cond ((memq this choices) | |
1094 | ;; (setq ret (funcall handler this ret))) | |
1095 | ;; ((eq this '+) (setq handler 'cons)) | |
1096 | ;; ((eq this '-) (setq handler 'delq)) | |
1097 | ;; ((error "`%s' only accepts %s" key choices))) | |
1098 | ;; (setq val (cdr val))) | |
1099 | ;; (set (nth 1 desc) ret)) | |
1100 | ;; (or (memq val choices) | |
1101 | ;; (error "`%s' must be one of `%s'" key choices)) | |
1102 | ;; (set (nth 1 desc) (eval (nth 3 desc)))) | |
1103 | ;; (setq args (cdr args))) | |
1104 | ;; nil)) | |
1c393159 JB |
1105 | \f |
1106 | ;;; sanity-checking arglists | |
1107 | ||
a7a7ddf1 RS |
1108 | ;; If a function has an entry saying (FUNCTION . t). |
1109 | ;; that means we know it is defined but we don't know how. | |
1110 | ;; If a function has an entry saying (FUNCTION . nil), | |
1111 | ;; that means treat it as not defined. | |
1c393159 JB |
1112 | (defun byte-compile-fdefinition (name macro-p) |
1113 | (let* ((list (if macro-p | |
1114 | byte-compile-macro-environment | |
5286a842 | 1115 | byte-compile-function-environment)) |
1c393159 JB |
1116 | (env (cdr (assq name list)))) |
1117 | (or env | |
1118 | (let ((fn name)) | |
1119 | (while (and (symbolp fn) | |
1120 | (fboundp fn) | |
1121 | (or (symbolp (symbol-function fn)) | |
1122 | (consp (symbol-function fn)) | |
1123 | (and (not macro-p) | |
ed015bdd | 1124 | (byte-code-function-p (symbol-function fn))))) |
1c393159 | 1125 | (setq fn (symbol-function fn))) |
ed015bdd | 1126 | (if (and (not macro-p) (byte-code-function-p fn)) |
1c393159 JB |
1127 | fn |
1128 | (and (consp fn) | |
1129 | (if (eq 'macro (car fn)) | |
1130 | (cdr fn) | |
1131 | (if macro-p | |
1132 | nil | |
1133 | (if (eq 'autoload (car fn)) | |
1134 | nil | |
1135 | fn))))))))) | |
1136 | ||
1137 | (defun byte-compile-arglist-signature (arglist) | |
1138 | (let ((args 0) | |
1139 | opts | |
1140 | restp) | |
1141 | (while arglist | |
1142 | (cond ((eq (car arglist) '&optional) | |
1143 | (or opts (setq opts 0))) | |
1144 | ((eq (car arglist) '&rest) | |
1145 | (if (cdr arglist) | |
1146 | (setq restp t | |
1147 | arglist nil))) | |
1148 | (t | |
1149 | (if opts | |
1150 | (setq opts (1+ opts)) | |
1151 | (setq args (1+ args))))) | |
1152 | (setq arglist (cdr arglist))) | |
1153 | (cons args (if restp nil (if opts (+ args opts) args))))) | |
1154 | ||
1155 | ||
1156 | (defun byte-compile-arglist-signatures-congruent-p (old new) | |
1157 | (not (or | |
1158 | (> (car new) (car old)) ; requires more args now | |
a7acbbe4 | 1159 | (and (null (cdr old)) ; took rest-args, doesn't any more |
1c393159 JB |
1160 | (cdr new)) |
1161 | (and (cdr new) (cdr old) ; can't take as many args now | |
1162 | (< (cdr new) (cdr old))) | |
1163 | ))) | |
1164 | ||
1165 | (defun byte-compile-arglist-signature-string (signature) | |
1166 | (cond ((null (cdr signature)) | |
1167 | (format "%d+" (car signature))) | |
1168 | ((= (car signature) (cdr signature)) | |
1169 | (format "%d" (car signature))) | |
1170 | (t (format "%d-%d" (car signature) (cdr signature))))) | |
1171 | ||
1172 | ||
52799cb8 | 1173 | ;; Warn if the form is calling a function with the wrong number of arguments. |
1c393159 | 1174 | (defun byte-compile-callargs-warn (form) |
1c393159 JB |
1175 | (let* ((def (or (byte-compile-fdefinition (car form) nil) |
1176 | (byte-compile-fdefinition (car form) t))) | |
a7a7ddf1 | 1177 | (sig (if (and def (not (eq def t))) |
ed62683d DL |
1178 | (byte-compile-arglist-signature |
1179 | (if (eq 'lambda (car-safe def)) | |
1180 | (nth 1 def) | |
1181 | (if (byte-code-function-p def) | |
1182 | (aref def 0) | |
1183 | '(&rest def)))) | |
1184 | (if (and (fboundp (car form)) | |
1185 | (subrp (symbol-function (car form)))) | |
1186 | (subr-arity (symbol-function (car form)))))) | |
1c393159 | 1187 | (ncall (length (cdr form)))) |
ed62683d DL |
1188 | ;; Check many or unevalled from subr-arity. |
1189 | (if (and (cdr-safe sig) | |
1190 | (not (numberp (cdr sig)))) | |
1191 | (setcdr sig nil)) | |
1c393159 | 1192 | (if sig |
ccb3c8de | 1193 | (when (or (< ncall (car sig)) |
1c393159 | 1194 | (and (cdr sig) (> ncall (cdr sig)))) |
ccb3c8de CW |
1195 | (byte-compile-set-symbol-position (car form)) |
1196 | (byte-compile-warn | |
1197 | "%s called with %d argument%s, but %s %s" | |
1198 | (car form) ncall | |
1199 | (if (= 1 ncall) "" "s") | |
1200 | (if (< ncall (car sig)) | |
1201 | "requires" | |
1202 | "accepts only") | |
ba76e7fa | 1203 | (byte-compile-arglist-signature-string sig)))) |
ab43c850 | 1204 | (byte-compile-format-warn form) |
ba76e7fa SM |
1205 | ;; Check to see if the function will be available at runtime |
1206 | ;; and/or remember its arity if it's unknown. | |
a7a7ddf1 | 1207 | (or (and (or def (fboundp (car form))) ; might be a subr or autoload. |
ab43c850 | 1208 | (not (memq (car form) byte-compile-noruntime-functions))) |
ba76e7fa SM |
1209 | (eq (car form) byte-compile-current-form) ; ## this doesn't work |
1210 | ; with recursion. | |
1211 | ;; It's a currently-undefined function. | |
1212 | ;; Remember number of args in call. | |
1213 | (let ((cons (assq (car form) byte-compile-unresolved-functions)) | |
1214 | (n (length (cdr form)))) | |
1215 | (if cons | |
1216 | (or (memq n (cdr cons)) | |
1217 | (setcdr cons (cons n (cdr cons)))) | |
977b50fb SM |
1218 | (push (list (car form) n) |
1219 | byte-compile-unresolved-functions)))))) | |
1c393159 | 1220 | |
ab43c850 RS |
1221 | (defun byte-compile-format-warn (form) |
1222 | "Warn if FORM is `format'-like with inconsistent args. | |
1223 | Applies if head of FORM is a symbol with non-nil property | |
1224 | `byte-compile-format-like' and first arg is a constant string. | |
1225 | Then check the number of format fields matches the number of | |
1226 | extra args." | |
1227 | (when (and (symbolp (car form)) | |
1228 | (stringp (nth 1 form)) | |
1229 | (get (car form) 'byte-compile-format-like)) | |
1230 | (let ((nfields (with-temp-buffer | |
1231 | (insert (nth 1 form)) | |
1232 | (goto-char 1) | |
1233 | (let ((n 0)) | |
1234 | (while (re-search-forward "%." nil t) | |
1235 | (unless (eq ?% (char-after (1+ (match-beginning 0)))) | |
1236 | (setq n (1+ n)))) | |
1237 | n))) | |
1238 | (nargs (- (length form) 2))) | |
1239 | (unless (= nargs nfields) | |
1240 | (byte-compile-warn | |
1241 | "`%s' called with %d args to fill %d format field(s)" (car form) | |
1242 | nargs nfields))))) | |
1243 | ||
1244 | (dolist (elt '(format message error)) | |
1245 | (put elt 'byte-compile-format-like t)) | |
1246 | ||
11efeb9b RS |
1247 | ;; Warn if a custom definition fails to specify :group. |
1248 | (defun byte-compile-nogroup-warn (form) | |
1249 | (let ((keyword-args (cdr (cdr (cdr (cdr form))))) | |
1250 | (name (cadr form))) | |
019472f4 RS |
1251 | (or (not (eq (car-safe name) 'quote)) |
1252 | (and (eq (car form) 'custom-declare-group) | |
1253 | (equal name ''emacs)) | |
1254 | (plist-get keyword-args :group) | |
cbd87c94 RS |
1255 | (not (and (consp name) (eq (car name) 'quote))) |
1256 | (byte-compile-warn | |
1257 | "%s for `%s' fails to specify containing group" | |
1258 | (cdr (assq (car form) | |
1259 | '((custom-declare-group . defgroup) | |
1260 | (custom-declare-face . defface) | |
1261 | (custom-declare-variable . defcustom)))) | |
1262 | (cadr name))))) | |
11efeb9b | 1263 | |
52799cb8 RS |
1264 | ;; Warn if the function or macro is being redefined with a different |
1265 | ;; number of arguments. | |
1c393159 | 1266 | (defun byte-compile-arglist-warn (form macrop) |
1c393159 | 1267 | (let ((old (byte-compile-fdefinition (nth 1 form) macrop))) |
a7a7ddf1 | 1268 | (if (and old (not (eq old t))) |
1c393159 JB |
1269 | (let ((sig1 (byte-compile-arglist-signature |
1270 | (if (eq 'lambda (car-safe old)) | |
1271 | (nth 1 old) | |
d82e848c | 1272 | (if (byte-code-function-p old) |
5286a842 RS |
1273 | (aref old 0) |
1274 | '(&rest def))))) | |
1c393159 | 1275 | (sig2 (byte-compile-arglist-signature (nth 2 form)))) |
ccb3c8de CW |
1276 | (unless (byte-compile-arglist-signatures-congruent-p sig1 sig2) |
1277 | (byte-compile-set-symbol-position (nth 1 form)) | |
1278 | (byte-compile-warn | |
1279 | "%s %s used to take %s %s, now takes %s" | |
1280 | (if (eq (car form) 'defun) "function" "macro") | |
1281 | (nth 1 form) | |
1282 | (byte-compile-arglist-signature-string sig1) | |
1283 | (if (equal sig1 '(1 . 1)) "argument" "arguments") | |
1284 | (byte-compile-arglist-signature-string sig2)))) | |
1c393159 JB |
1285 | ;; This is the first definition. See if previous calls are compatible. |
1286 | (let ((calls (assq (nth 1 form) byte-compile-unresolved-functions)) | |
1287 | nums sig min max) | |
1288 | (if calls | |
1289 | (progn | |
1290 | (setq sig (byte-compile-arglist-signature (nth 2 form)) | |
1291 | nums (sort (copy-sequence (cdr calls)) (function <)) | |
1292 | min (car nums) | |
1293 | max (car (nreverse nums))) | |
ccb3c8de | 1294 | (when (or (< min (car sig)) |
1c393159 | 1295 | (and (cdr sig) (> max (cdr sig)))) |
ccb3c8de CW |
1296 | (byte-compile-set-symbol-position (nth 1 form)) |
1297 | (byte-compile-warn | |
1298 | "%s being defined to take %s%s, but was previously called with %s" | |
1299 | (nth 1 form) | |
1300 | (byte-compile-arglist-signature-string sig) | |
1301 | (if (equal sig '(1 . 1)) " arg" " args") | |
1302 | (byte-compile-arglist-signature-string (cons min max)))) | |
1f006824 | 1303 | |
1c393159 JB |
1304 | (setq byte-compile-unresolved-functions |
1305 | (delq calls byte-compile-unresolved-functions))))) | |
1306 | ))) | |
1307 | ||
95c997fa RS |
1308 | (defvar byte-compile-cl-functions nil |
1309 | "List of functions defined in CL.") | |
1310 | ||
1311 | (defun byte-compile-find-cl-functions () | |
1312 | (unless byte-compile-cl-functions | |
1313 | (dolist (elt load-history) | |
c43008c4 RS |
1314 | (when (and (stringp (car elt)) |
1315 | (string-match "^cl\\>" (car elt))) | |
95c997fa RS |
1316 | (setq byte-compile-cl-functions |
1317 | (append byte-compile-cl-functions | |
1318 | (cdr elt))))) | |
1319 | (let ((tail byte-compile-cl-functions)) | |
1320 | (while tail | |
1321 | (if (and (consp (car tail)) | |
1322 | (eq (car (car tail)) 'autoload)) | |
1323 | (setcar tail (cdr (car tail)))) | |
1324 | (setq tail (cdr tail)))))) | |
1325 | ||
4795d1c7 RS |
1326 | (defun byte-compile-cl-warn (form) |
1327 | "Warn if FORM is a call of a function from the CL package." | |
95c997fa RS |
1328 | (let ((func (car-safe form))) |
1329 | (if (and byte-compile-cl-functions | |
1330 | (memq func byte-compile-cl-functions) | |
ab43c850 | 1331 | ;; Aliases which won't have been expanded at this point. |
4795d1c7 RS |
1332 | ;; These aren't all aliases of subrs, so not trivial to |
1333 | ;; avoid hardwiring the list. | |
1334 | (not (memq func | |
9cb9a7bc RS |
1335 | '(cl-block-wrapper cl-block-throw |
1336 | multiple-value-call nth-value | |
95c997fa | 1337 | copy-seq first second rest endp cl-member |
d1a57439 RS |
1338 | ;; These are included in generated code |
1339 | ;; that can't be called except at compile time | |
1340 | ;; or unless cl is loaded anyway. | |
1341 | cl-defsubst-expand cl-struct-setf-expander | |
8f876842 RS |
1342 | ;; These would sometimes be warned about |
1343 | ;; but such warnings are never useful, | |
1344 | ;; so don't warn about them. | |
118861df DL |
1345 | macroexpand cl-macroexpand-all |
1346 | cl-compiling-file))) | |
1347 | ;; Avoid warnings for things which are safe because they | |
1348 | ;; have suitable compiler macros, but those aren't | |
1349 | ;; expanded at this stage. There should probably be more | |
1350 | ;; here than caaar and friends. | |
1351 | (not (and (eq (get func 'byte-compile) | |
1352 | 'cl-byte-compile-compiler-macro) | |
6640c250 | 1353 | (string-match "\\`c[ad]+r\\'" (symbol-name func))))) |
4795d1c7 RS |
1354 | (byte-compile-warn "Function `%s' from cl package called at runtime" |
1355 | func))) | |
1356 | form) | |
1357 | ||
a586093f | 1358 | (defun byte-compile-print-syms (str1 strn syms) |
ccb3c8de CW |
1359 | (when syms |
1360 | (byte-compile-set-symbol-position (car syms) t)) | |
b8175fe6 GM |
1361 | (cond ((and (cdr syms) (not noninteractive)) |
1362 | (let* ((str strn) | |
1363 | (L (length str)) | |
1364 | s) | |
1365 | (while syms | |
1366 | (setq s (symbol-name (pop syms)) | |
1367 | L (+ L (length s) 2)) | |
1368 | (if (< L (1- fill-column)) | |
1369 | (setq str (concat str " " s (and syms ","))) | |
1370 | (setq str (concat str "\n " s (and syms ",")) | |
1371 | L (+ (length s) 4)))) | |
1372 | (byte-compile-warn "%s" str))) | |
1373 | ((cdr syms) | |
1f006824 | 1374 | (byte-compile-warn "%s %s" |
b8175fe6 GM |
1375 | strn |
1376 | (mapconcat #'symbol-name syms ", "))) | |
1377 | ||
1378 | (syms | |
1379 | (byte-compile-warn str1 (car syms))))) | |
a586093f | 1380 | |
1f006824 | 1381 | ;; If we have compiled any calls to functions which are not known to be |
52799cb8 RS |
1382 | ;; defined, issue a warning enumerating them. |
1383 | ;; `unresolved' in the list `byte-compile-warnings' disables this. | |
1c393159 | 1384 | (defun byte-compile-warn-about-unresolved-functions () |
a586093f | 1385 | (when (memq 'unresolved byte-compile-warnings) |
b8175fe6 | 1386 | (let ((byte-compile-current-form :end) |
a586093f SM |
1387 | (noruntime nil) |
1388 | (unresolved nil)) | |
1389 | ;; Separate the functions that will not be available at runtime | |
1390 | ;; from the truly unresolved ones. | |
1391 | (dolist (f byte-compile-unresolved-functions) | |
1392 | (setq f (car f)) | |
1393 | (if (fboundp f) (push f noruntime) (push f unresolved))) | |
1394 | ;; Complain about the no-run-time functions | |
1395 | (byte-compile-print-syms | |
b8175fe6 GM |
1396 | "the function `%s' might not be defined at runtime." |
1397 | "the following functions might not be defined at runtime:" | |
a586093f SM |
1398 | noruntime) |
1399 | ;; Complain about the unresolved functions | |
1400 | (byte-compile-print-syms | |
b8175fe6 GM |
1401 | "the function `%s' is not known to be defined." |
1402 | "the following functions are not known to be defined:" | |
a586093f | 1403 | unresolved))) |
1c393159 JB |
1404 | nil) |
1405 | ||
1406 | \f | |
582a857c | 1407 | (defsubst byte-compile-const-symbol-p (symbol &optional any-value) |
6c2161c4 | 1408 | "Non-nil if SYMBOL is constant. |
582a857c | 1409 | If ANY-VALUE is nil, only return non-nil if the value of the symbol is the |
6c2161c4 | 1410 | symbol itself." |
1639b803 | 1411 | (or (memq symbol '(nil t)) |
6c2161c4 | 1412 | (keywordp symbol) |
582a857c | 1413 | (if any-value (memq symbol byte-compile-const-variables)))) |
1639b803 | 1414 | |
1c393159 | 1415 | (defmacro byte-compile-constp (form) |
c5091f25 | 1416 | "Return non-nil if FORM is a constant." |
1639b803 DL |
1417 | `(cond ((consp ,form) (eq (car ,form) 'quote)) |
1418 | ((not (symbolp ,form))) | |
1419 | ((byte-compile-const-symbol-p ,form)))) | |
1c393159 JB |
1420 | |
1421 | (defmacro byte-compile-close-variables (&rest body) | |
1422 | (cons 'let | |
1423 | (cons '(;; | |
1424 | ;; Close over these variables to encapsulate the | |
1425 | ;; compilation state | |
1426 | ;; | |
1427 | (byte-compile-macro-environment | |
1428 | ;; Copy it because the compiler may patch into the | |
1429 | ;; macroenvironment. | |
1430 | (copy-alist byte-compile-initial-macro-environment)) | |
1431 | (byte-compile-function-environment nil) | |
1432 | (byte-compile-bound-variables nil) | |
6c2161c4 | 1433 | (byte-compile-const-variables nil) |
1c393159 JB |
1434 | (byte-compile-free-references nil) |
1435 | (byte-compile-free-assignments nil) | |
1436 | ;; | |
1437 | ;; Close over these variables so that `byte-compiler-options' | |
1438 | ;; can change them on a per-file basis. | |
1439 | ;; | |
1440 | (byte-compile-verbose byte-compile-verbose) | |
1441 | (byte-optimize byte-optimize) | |
d82e848c RS |
1442 | (byte-compile-compatibility byte-compile-compatibility) |
1443 | (byte-compile-dynamic byte-compile-dynamic) | |
1444 | (byte-compile-dynamic-docstrings | |
1445 | byte-compile-dynamic-docstrings) | |
52799cb8 RS |
1446 | ;; (byte-compile-generate-emacs19-bytecodes |
1447 | ;; byte-compile-generate-emacs19-bytecodes) | |
1c393159 JB |
1448 | (byte-compile-warnings (if (eq byte-compile-warnings t) |
1449 | byte-compile-warning-types | |
1450 | byte-compile-warnings)) | |
1451 | ) | |
1452 | body))) | |
1453 | ||
1c393159 | 1454 | (defmacro displaying-byte-compile-warnings (&rest body) |
4390021b RS |
1455 | `(let* ((--displaying-byte-compile-warnings-fn (lambda () ,@body)) |
1456 | (warning-series-started | |
1457 | (and (markerp warning-series) | |
1458 | (eq (marker-buffer warning-series) | |
1459 | (get-buffer "*Compile-Log*"))))) | |
95c997fa | 1460 | (byte-compile-find-cl-functions) |
4390021b RS |
1461 | (if (or (eq warning-series 'byte-compile-warning-series) |
1462 | warning-series-started) | |
1463 | ;; warning-series does come from compilation, | |
1464 | ;; so don't bind it, but maybe do set it. | |
1465 | (let (tem) | |
1466 | ;; Log the file name. Record position of that text. | |
1467 | (setq tem (byte-compile-log-file)) | |
1468 | (unless warning-series-started | |
1469 | (setq warning-series (or tem 'byte-compile-warning-series))) | |
1470 | (if byte-compile-debug | |
1471 | (funcall --displaying-byte-compile-warnings-fn) | |
1472 | (condition-case error-info | |
1473 | (funcall --displaying-byte-compile-warnings-fn) | |
1474 | (error (byte-compile-report-error error-info))))) | |
1475 | ;; warning-series does not come from compilation, so bind it. | |
1476 | (let ((warning-series | |
1477 | ;; Log the file name. Record position of that text. | |
1478 | (or (byte-compile-log-file) 'byte-compile-warning-series))) | |
1479 | (if byte-compile-debug | |
22788fb8 | 1480 | (funcall --displaying-byte-compile-warnings-fn) |
4390021b RS |
1481 | (condition-case error-info |
1482 | (funcall --displaying-byte-compile-warnings-fn) | |
1483 | (error (byte-compile-report-error error-info)))))))) | |
1c393159 | 1484 | \f |
fd5285f3 | 1485 | ;;;###autoload |
9742dbc0 RS |
1486 | (defun byte-force-recompile (directory) |
1487 | "Recompile every `.el' file in DIRECTORY that already has a `.elc' file. | |
1488 | Files in subdirectories of DIRECTORY are processed also." | |
c0f43df5 | 1489 | (interactive "DByte force recompile (directory): ") |
9742dbc0 RS |
1490 | (byte-recompile-directory directory nil t)) |
1491 | ||
1492 | ;;;###autoload | |
1493 | (defun byte-recompile-directory (directory &optional arg force) | |
1c393159 JB |
1494 | "Recompile every `.el' file in DIRECTORY that needs recompilation. |
1495 | This is if a `.elc' file exists but is older than the `.el' file. | |
691e7e76 | 1496 | Files in subdirectories of DIRECTORY are processed also. |
1c393159 | 1497 | |
c4f2cabd RS |
1498 | If the `.elc' file does not exist, normally this function *does not* |
1499 | compile the corresponding `.el' file. However, | |
1500 | if ARG (the prefix argument) is 0, that means do compile all those files. | |
1501 | A nonzero ARG means ask the user, for each such `.el' file, | |
1502 | whether to compile it. | |
691e7e76 | 1503 | |
c4f2cabd | 1504 | A nonzero ARG also means ask about each subdirectory before scanning it. |
9742dbc0 RS |
1505 | |
1506 | If the third argument FORCE is non-nil, | |
1507 | recompile every `.el' file that already has a `.elc' file." | |
1c393159 | 1508 | (interactive "DByte recompile directory: \nP") |
0dea0bbe RM |
1509 | (if arg |
1510 | (setq arg (prefix-numeric-value arg))) | |
e27c3564 JB |
1511 | (if noninteractive |
1512 | nil | |
1513 | (save-some-buffers) | |
ba901388 | 1514 | (force-mode-line-update)) |
4eb4926c | 1515 | (save-current-buffer |
977f31f8 | 1516 | (set-buffer (get-buffer-create "*Compile-Log*")) |
6c2161c4 | 1517 | (setq default-directory (expand-file-name directory)) |
977f31f8 RS |
1518 | ;; compilation-mode copies value of default-directory. |
1519 | (unless (eq major-mode 'compilation-mode) | |
1520 | (compilation-mode)) | |
4eb4926c RS |
1521 | (let ((directories (list (expand-file-name directory))) |
1522 | (default-directory default-directory) | |
1523 | (skip-count 0) | |
1524 | (fail-count 0) | |
1525 | (file-count 0) | |
1526 | (dir-count 0) | |
1527 | last-dir) | |
1528 | (displaying-byte-compile-warnings | |
1529 | (while directories | |
1530 | (setq directory (car directories)) | |
1531 | (message "Checking %s..." directory) | |
1532 | (let ((files (directory-files directory)) | |
1533 | source dest) | |
1534 | (dolist (file files) | |
1535 | (setq source (expand-file-name file directory)) | |
b122f3fb SM |
1536 | (if (and (not (member file '("RCS" "CVS"))) |
1537 | (not (eq ?\. (aref file 0))) | |
4eb4926c RS |
1538 | (file-directory-p source) |
1539 | (not (file-symlink-p source))) | |
1540 | ;; This file is a subdirectory. Handle them differently. | |
1541 | (when (or (null arg) | |
1542 | (eq 0 arg) | |
1543 | (y-or-n-p (concat "Check " source "? "))) | |
1544 | (setq directories | |
1545 | (nconc directories (list source)))) | |
1546 | ;; It is an ordinary file. Decide whether to compile it. | |
1547 | (if (and (string-match emacs-lisp-file-regexp source) | |
1548 | (file-readable-p source) | |
1549 | (not (auto-save-file-name-p source)) | |
1550 | (setq dest (byte-compile-dest-file source)) | |
1551 | (if (file-exists-p dest) | |
1552 | ;; File was already compiled. | |
1553 | (or force (file-newer-than-file-p source dest)) | |
1554 | ;; No compiled file exists yet. | |
1555 | (and arg | |
1556 | (or (eq 0 arg) | |
1557 | (y-or-n-p (concat "Compile " source "? ")))))) | |
1558 | (progn (if (and noninteractive (not byte-compile-verbose)) | |
1559 | (message "Compiling %s..." source)) | |
1560 | (let ((res (byte-compile-file source))) | |
1561 | (cond ((eq res 'no-byte-compile) | |
1562 | (setq skip-count (1+ skip-count))) | |
1563 | ((eq res t) | |
1564 | (setq file-count (1+ file-count))) | |
1565 | ((eq res nil) | |
1566 | (setq fail-count (1+ fail-count))))) | |
1567 | (or noninteractive | |
1568 | (message "Checking %s..." directory)) | |
1569 | (if (not (eq last-dir directory)) | |
1570 | (setq last-dir directory | |
1571 | dir-count (1+ dir-count))) | |
1572 | ))))) | |
1573 | (setq directories (cdr directories)))) | |
1574 | (message "Done (Total of %d file%s compiled%s%s%s)" | |
1575 | file-count (if (= file-count 1) "" "s") | |
1576 | (if (> fail-count 0) (format ", %d failed" fail-count) "") | |
1577 | (if (> skip-count 0) (format ", %d skipped" skip-count) "") | |
1578 | (if (> dir-count 1) (format " in %d directories" dir-count) ""))))) | |
1c393159 | 1579 | |
fef3407e SM |
1580 | (defvar no-byte-compile nil |
1581 | "Non-nil to prevent byte-compiling of emacs-lisp code. | |
1582 | This is normally set in local file variables at the end of the elisp file: | |
1583 | ||
1584 | ;; Local Variables:\n;; no-byte-compile: t\n;; End: ") | |
1585 | ||
fd5285f3 | 1586 | ;;;###autoload |
1c393159 JB |
1587 | (defun byte-compile-file (filename &optional load) |
1588 | "Compile a file of Lisp code named FILENAME into a file of byte code. | |
1589 | The output file's name is made by appending `c' to the end of FILENAME. | |
3614fc84 | 1590 | With prefix arg (noninteractively: 2nd arg), LOAD the file after compiling. |
d90a41e8 | 1591 | The value is non-nil if there were no errors, nil if errors." |
1c393159 JB |
1592 | ;; (interactive "fByte compile file: \nP") |
1593 | (interactive | |
1594 | (let ((file buffer-file-name) | |
1595 | (file-name nil) | |
1596 | (file-dir nil)) | |
1597 | (and file | |
1598 | (eq (cdr (assq 'major-mode (buffer-local-variables))) | |
1599 | 'emacs-lisp-mode) | |
1600 | (setq file-name (file-name-nondirectory file) | |
1601 | file-dir (file-name-directory file))) | |
52799cb8 RS |
1602 | (list (read-file-name (if current-prefix-arg |
1603 | "Byte compile and load file: " | |
1604 | "Byte compile file: ") | |
79c6071d | 1605 | file-dir file-name nil) |
fd5285f3 | 1606 | current-prefix-arg))) |
1c393159 JB |
1607 | ;; Expand now so we get the current buffer's defaults |
1608 | (setq filename (expand-file-name filename)) | |
1609 | ||
1610 | ;; If we're compiling a file that's in a buffer and is modified, offer | |
1611 | ;; to save it first. | |
1612 | (or noninteractive | |
1613 | (let ((b (get-file-buffer (expand-file-name filename)))) | |
1614 | (if (and b (buffer-modified-p b) | |
a586093f | 1615 | (y-or-n-p (format "Save buffer %s first? " (buffer-name b)))) |
1c393159 JB |
1616 | (save-excursion (set-buffer b) (save-buffer))))) |
1617 | ||
4390021b RS |
1618 | ;; Force logging of the file name for each file compiled. |
1619 | (setq byte-compile-last-logged-file nil) | |
3ea1f391 | 1620 | (let ((byte-compile-current-file filename) |
dc14ae36 | 1621 | (set-auto-coding-for-load t) |
d82e848c RS |
1622 | target-file input-buffer output-buffer |
1623 | byte-compile-dest-file) | |
1624 | (setq target-file (byte-compile-dest-file filename)) | |
1625 | (setq byte-compile-dest-file target-file) | |
1c393159 | 1626 | (save-excursion |
ab94e6e7 RS |
1627 | (setq input-buffer (get-buffer-create " *Compiler Input*")) |
1628 | (set-buffer input-buffer) | |
1c393159 | 1629 | (erase-buffer) |
7a28e3b1 | 1630 | (setq buffer-file-coding-system nil) |
746dd298 | 1631 | ;; Always compile an Emacs Lisp file as multibyte |
b92dd692 | 1632 | ;; unless the file itself forces unibyte with -*-coding: raw-text;-*- |
746dd298 | 1633 | (set-buffer-multibyte t) |
1c393159 | 1634 | (insert-file-contents filename) |
844da0ff KH |
1635 | ;; Mimic the way after-insert-file-set-coding can make the |
1636 | ;; buffer unibyte when visiting this file. | |
7a28e3b1 RS |
1637 | (when (or (eq last-coding-system-used 'no-conversion) |
1638 | (eq (coding-system-type last-coding-system-used) 5)) | |
1639 | ;; For coding systems no-conversion and raw-text..., | |
1640 | ;; edit the buffer as unibyte. | |
1641 | (set-buffer-multibyte nil)) | |
1c393159 JB |
1642 | ;; Run hooks including the uncompression hook. |
1643 | ;; If they change the file name, then change it for the output also. | |
d82e848c | 1644 | (let ((buffer-file-name filename) |
a096f13f | 1645 | (default-major-mode 'emacs-lisp-mode) |
d82e848c RS |
1646 | (enable-local-eval nil)) |
1647 | (normal-mode) | |
cd891e68 RS |
1648 | (setq filename buffer-file-name)) |
1649 | ;; Set the default directory, in case an eval-when-compile uses it. | |
1650 | (setq default-directory (file-name-directory filename))) | |
3614fc84 GM |
1651 | ;; Check if the file's local variables explicitly specify not to |
1652 | ;; compile this file. | |
fef3407e | 1653 | (if (with-current-buffer input-buffer no-byte-compile) |
3614fc84 | 1654 | (progn |
b122f3fb SM |
1655 | ;; (message "%s not compiled because of `no-byte-compile: %s'" |
1656 | ;; (file-relative-name filename) | |
1657 | ;; (with-current-buffer input-buffer no-byte-compile)) | |
1658 | (when (file-exists-p target-file) | |
1659 | (message "%s deleted because of `no-byte-compile: %s'" | |
1660 | (file-relative-name target-file) | |
1661 | (buffer-local-value 'no-byte-compile input-buffer)) | |
1662 | (condition-case nil (delete-file target-file) (error nil))) | |
82345a9a | 1663 | ;; We successfully didn't compile this file. |
d90a41e8 | 1664 | 'no-byte-compile) |
ccb3c8de CW |
1665 | (when byte-compile-verbose |
1666 | (message "Compiling %s..." filename)) | |
82345a9a SM |
1667 | (setq byte-compiler-error-flag nil) |
1668 | ;; It is important that input-buffer not be current at this call, | |
1669 | ;; so that the value of point set in input-buffer | |
1670 | ;; within byte-compile-from-buffer lingers in that buffer. | |
4f6d5bf0 SM |
1671 | (setq output-buffer |
1672 | (save-current-buffer | |
1673 | (byte-compile-from-buffer input-buffer filename))) | |
82345a9a SM |
1674 | (if byte-compiler-error-flag |
1675 | nil | |
ccb3c8de CW |
1676 | (when byte-compile-verbose |
1677 | (message "Compiling %s...done" filename)) | |
82345a9a SM |
1678 | (kill-buffer input-buffer) |
1679 | (with-current-buffer output-buffer | |
1680 | (goto-char (point-max)) | |
1681 | (insert "\n") ; aaah, unix. | |
1682 | (let ((vms-stmlf-recfm t)) | |
1683 | (if (file-writable-p target-file) | |
1684 | ;; We must disable any code conversion here. | |
1685 | (let ((coding-system-for-write 'no-conversion)) | |
1686 | (if (memq system-type '(ms-dos 'windows-nt)) | |
1687 | (setq buffer-file-type t)) | |
1688 | (when (file-exists-p target-file) | |
1689 | ;; Remove the target before writing it, so that any | |
1690 | ;; hard-links continue to point to the old file (this makes | |
1691 | ;; it possible for installed files to share disk space with | |
1692 | ;; the build tree, without causing problems when emacs-lisp | |
1693 | ;; files in the build tree are recompiled). | |
1694 | (delete-file target-file)) | |
ba76e7fa | 1695 | (write-region (point-min) (point-max) target-file)) |
82345a9a SM |
1696 | ;; This is just to give a better error message than write-region |
1697 | (signal 'file-error | |
1698 | (list "Opening output file" | |
1699 | (if (file-exists-p target-file) | |
1700 | "cannot overwrite file" | |
1701 | "directory not writable or nonexistent") | |
1702 | target-file)))) | |
1703 | (kill-buffer (current-buffer))) | |
1704 | (if (and byte-compile-generate-call-tree | |
1705 | (or (eq t byte-compile-generate-call-tree) | |
1706 | (y-or-n-p (format "Report call tree for %s? " filename)))) | |
1707 | (save-excursion | |
1708 | (display-call-tree filename))) | |
1709 | (if load | |
1710 | (load target-file)) | |
1711 | t)))) | |
1c393159 | 1712 | |
52799cb8 RS |
1713 | ;;(defun byte-compile-and-load-file (&optional filename) |
1714 | ;; "Compile a file of Lisp code named FILENAME into a file of byte code, | |
c5091f25 | 1715 | ;;and then load it. The output file's name is made by appending \"c\" to |
52799cb8 RS |
1716 | ;;the end of FILENAME." |
1717 | ;; (interactive) | |
1718 | ;; (if filename ; I don't get it, (interactive-p) doesn't always work | |
1719 | ;; (byte-compile-file filename t) | |
1720 | ;; (let ((current-prefix-arg '(4))) | |
1721 | ;; (call-interactively 'byte-compile-file)))) | |
1722 | ||
1723 | ;;(defun byte-compile-buffer (&optional buffer) | |
1724 | ;; "Byte-compile and evaluate contents of BUFFER (default: the current buffer)." | |
1725 | ;; (interactive "bByte compile buffer: ") | |
1726 | ;; (setq buffer (if buffer (get-buffer buffer) (current-buffer))) | |
1727 | ;; (message "Compiling %s..." (buffer-name buffer)) | |
1728 | ;; (let* ((filename (or (buffer-file-name buffer) | |
1729 | ;; (concat "#<buffer " (buffer-name buffer) ">"))) | |
1730 | ;; (byte-compile-current-file buffer)) | |
8a5dd086 | 1731 | ;; (byte-compile-from-buffer buffer nil)) |
52799cb8 RS |
1732 | ;; (message "Compiling %s...done" (buffer-name buffer)) |
1733 | ;; t) | |
1c393159 JB |
1734 | |
1735 | ;;; compiling a single function | |
fd5285f3 | 1736 | ;;;###autoload |
52799cb8 | 1737 | (defun compile-defun (&optional arg) |
1c393159 | 1738 | "Compile and evaluate the current top-level form. |
7618fe8e | 1739 | Print the result in the echo area. |
1c393159 JB |
1740 | With argument, insert value in current buffer after the form." |
1741 | (interactive "P") | |
1742 | (save-excursion | |
1743 | (end-of-defun) | |
1744 | (beginning-of-defun) | |
1745 | (let* ((byte-compile-current-file nil) | |
ccb3c8de CW |
1746 | (byte-compile-current-buffer (current-buffer)) |
1747 | (byte-compile-read-position (point)) | |
1748 | (byte-compile-last-position byte-compile-read-position) | |
1c393159 | 1749 | (byte-compile-last-warned-form 'nothing) |
ccb3c8de | 1750 | (value (eval |
9cb9a7bc | 1751 | (let ((read-with-symbol-positions (current-buffer)) |
ccb3c8de CW |
1752 | (read-symbol-positions-list nil)) |
1753 | (displaying-byte-compile-warnings | |
1754 | (byte-compile-sexp (read (current-buffer)))))))) | |
1c393159 JB |
1755 | (cond (arg |
1756 | (message "Compiling from buffer... done.") | |
1757 | (prin1 value (current-buffer)) | |
1758 | (insert "\n")) | |
1759 | ((message "%s" (prin1-to-string value))))))) | |
1760 | ||
1761 | ||
8a5dd086 RS |
1762 | (defun byte-compile-from-buffer (inbuffer &optional filename) |
1763 | ;; Filename is used for the loading-into-Emacs-18 error message. | |
d82e848c | 1764 | (let (outbuffer |
ccb3c8de CW |
1765 | (byte-compile-current-buffer inbuffer) |
1766 | (byte-compile-read-position nil) | |
1767 | (byte-compile-last-position nil) | |
d82e848c RS |
1768 | ;; Prevent truncation of flonums and lists as we read and print them |
1769 | (float-output-format nil) | |
1770 | (case-fold-search nil) | |
1771 | (print-length nil) | |
95e7d933 | 1772 | (print-level nil) |
74dfd056 RS |
1773 | ;; Prevent edebug from interfering when we compile |
1774 | ;; and put the output into a file. | |
ccb3c8de CW |
1775 | ;; (edebug-all-defs nil) |
1776 | ;; (edebug-all-forms nil) | |
d82e848c RS |
1777 | ;; Simulate entry to byte-compile-top-level |
1778 | (byte-compile-constants nil) | |
1779 | (byte-compile-variables nil) | |
1780 | (byte-compile-tag-number 0) | |
1781 | (byte-compile-depth 0) | |
1782 | (byte-compile-maxdepth 0) | |
1783 | (byte-compile-output nil) | |
ccb3c8de | 1784 | ;; This allows us to get the positions of symbols read; it's |
bf247b6e | 1785 | ;; new in Emacs 22.1. |
ccb3c8de CW |
1786 | (read-with-symbol-positions inbuffer) |
1787 | (read-symbol-positions-list nil) | |
d82e848c RS |
1788 | ;; #### This is bound in b-c-close-variables. |
1789 | ;; (byte-compile-warnings (if (eq byte-compile-warnings t) | |
1790 | ;; byte-compile-warning-types | |
1791 | ;; byte-compile-warnings)) | |
1792 | ) | |
1793 | (byte-compile-close-variables | |
1794 | (save-excursion | |
1795 | (setq outbuffer | |
1796 | (set-buffer (get-buffer-create " *Compiler Output*"))) | |
08b59cd3 | 1797 | (set-buffer-multibyte t) |
d82e848c RS |
1798 | (erase-buffer) |
1799 | ;; (emacs-lisp-mode) | |
1800 | (setq case-fold-search nil) | |
d82e848c RS |
1801 | ;; This is a kludge. Some operating systems (OS/2, DOS) need to |
1802 | ;; write files containing binary information specially. | |
1803 | ;; Under most circumstances, such files will be in binary | |
1804 | ;; overwrite mode, so those OS's use that flag to guess how | |
1805 | ;; they should write their data. Advise them that .elc files | |
1806 | ;; need to be written carefully. | |
1807 | (setq overwrite-mode 'overwrite-mode-binary)) | |
1808 | (displaying-byte-compile-warnings | |
fb639443 | 1809 | (and filename (byte-compile-insert-header filename inbuffer outbuffer)) |
d82e848c RS |
1810 | (save-excursion |
1811 | (set-buffer inbuffer) | |
1812 | (goto-char 1) | |
1813 | ||
1814 | ;; Compile the forms from the input buffer. | |
1815 | (while (progn | |
1816 | (while (progn (skip-chars-forward " \t\n\^l") | |
1817 | (looking-at ";")) | |
1818 | (forward-line 1)) | |
1819 | (not (eobp))) | |
ccb3c8de CW |
1820 | (setq byte-compile-read-position (point) |
1821 | byte-compile-last-position byte-compile-read-position) | |
1822 | (let ((form (read inbuffer))) | |
1823 | (byte-compile-file-form form))) | |
d82e848c RS |
1824 | ;; Compile pending forms at end of file. |
1825 | (byte-compile-flush-pending) | |
977f31f8 RS |
1826 | ;; Make warnings about unresolved functions |
1827 | ;; give the end of the file as their position. | |
1828 | (setq byte-compile-last-position (point-max)) | |
d82e848c | 1829 | (byte-compile-warn-about-unresolved-functions) |
a7acbbe4 | 1830 | ;; Should we always do this? When calling multiple files, it |
d82e848c RS |
1831 | ;; would be useful to delay this warning until all have |
1832 | ;; been compiled. | |
fb639443 RS |
1833 | (setq byte-compile-unresolved-functions nil)) |
1834 | ;; Fix up the header at the front of the output | |
1835 | ;; if the buffer contains multibyte characters. | |
1836 | (and filename (byte-compile-fix-header filename inbuffer outbuffer)))) | |
285cdf4e | 1837 | outbuffer)) |
8a5dd086 | 1838 | |
fb639443 | 1839 | (defun byte-compile-fix-header (filename inbuffer outbuffer) |
6c2161c4 | 1840 | (with-current-buffer outbuffer |
fb639443 | 1841 | ;; See if the buffer has any multibyte characters. |
447a052b | 1842 | (when (< (point-max) (position-bytes (point-max))) |
fb639443 RS |
1843 | (when (byte-compile-version-cond byte-compile-compatibility) |
1844 | (error "Version-18 compatibility not valid with multibyte characters")) | |
1845 | (goto-char (point-min)) | |
1846 | ;; Find the comment that describes the version test. | |
1847 | (search-forward "\n;;; This file") | |
1848 | (beginning-of-line) | |
1849 | (narrow-to-region (point) (point-max)) | |
1850 | ;; Find the line of ballast semicolons. | |
1851 | (search-forward ";;;;;;;;;;") | |
1852 | (beginning-of-line) | |
1853 | ||
1854 | (narrow-to-region (point-min) (point)) | |
1855 | (let ((old-header-end (point)) | |
1856 | delta) | |
1857 | (goto-char (point-min)) | |
1858 | (delete-region (point) (progn (re-search-forward "^(") | |
1859 | (beginning-of-line) | |
1860 | (point))) | |
1861 | (insert ";;; This file contains multibyte non-ASCII characters\n" | |
1862 | ";;; and therefore cannot be loaded into Emacs 19.\n") | |
1863 | ;; Replace "19" or "19.29" with "20", twice. | |
1864 | (re-search-forward "19\\(\\.[0-9]+\\)") | |
1865 | (replace-match "20") | |
1866 | (re-search-forward "19\\(\\.[0-9]+\\)") | |
1867 | (replace-match "20") | |
1868 | ;; Now compensate for the change in size, | |
1869 | ;; to make sure all positions in the file remain valid. | |
1870 | (setq delta (- (point-max) old-header-end)) | |
1871 | (goto-char (point-max)) | |
1872 | (widen) | |
1873 | (delete-char delta))))) | |
1874 | ||
f1f32df9 RS |
1875 | (defun byte-compile-insert-header (filename inbuffer outbuffer) |
1876 | (set-buffer inbuffer) | |
1e098504 | 1877 | (let ((dynamic-docstrings byte-compile-dynamic-docstrings) |
fb639443 | 1878 | (dynamic byte-compile-dynamic)) |
f1f32df9 RS |
1879 | (set-buffer outbuffer) |
1880 | (goto-char 1) | |
1596952e RS |
1881 | ;; The magic number of .elc files is ";ELC", or 0x3B454C43. After |
1882 | ;; that is the file-format version number (18, 19 or 20) as a | |
1883 | ;; byte, followed by some nulls. The primary motivation for doing | |
1884 | ;; this is to get some binary characters up in the first line of | |
1885 | ;; the file so that `diff' will simply say "Binary files differ" | |
1886 | ;; instead of actually doing a diff of two .elc files. An extra | |
1887 | ;; benefit is that you can add this to /etc/magic: | |
1888 | ||
f1f32df9 RS |
1889 | ;; 0 string ;ELC GNU Emacs Lisp compiled file, |
1890 | ;; >4 byte x version %d | |
1596952e | 1891 | |
f1f32df9 RS |
1892 | (insert |
1893 | ";ELC" | |
1596952e | 1894 | (if (byte-compile-version-cond byte-compile-compatibility) 18 20) |
f1f32df9 RS |
1895 | "\000\000\000\n" |
1896 | ) | |
1e098504 | 1897 | (insert ";;; Compiled by " |
f1f32df9 RS |
1898 | (or (and (boundp 'user-mail-address) user-mail-address) |
1899 | (concat (user-login-name) "@" (system-name))) | |
1900 | " on " | |
1901 | (current-time-string) "\n;;; from file " filename "\n") | |
1e098504 | 1902 | (insert ";;; in Emacs version " emacs-version "\n") |
1f3ddf11 | 1903 | (insert ";;; " |
f1f32df9 | 1904 | (cond |
1e098504 RS |
1905 | ((eq byte-optimize 'source) "with source-level optimization only") |
1906 | ((eq byte-optimize 'byte) "with byte-level optimization only") | |
1907 | (byte-optimize "with all optimizations") | |
1908 | (t "without optimization")) | |
f1f32df9 RS |
1909 | (if (byte-compile-version-cond byte-compile-compatibility) |
1910 | "; compiled with Emacs 18 compatibility.\n" | |
1911 | ".\n")) | |
1e098504 RS |
1912 | (if dynamic |
1913 | (insert ";;; Function definitions are lazy-loaded.\n")) | |
fb639443 | 1914 | (if (not (byte-compile-version-cond byte-compile-compatibility)) |
1596952e RS |
1915 | (let (intro-string minimum-version) |
1916 | ;; Figure out which Emacs version to require, | |
1917 | ;; and what comment to use to explain why. | |
fb639443 RS |
1918 | ;; Note that this fails to take account of whether |
1919 | ;; the buffer contains multibyte characters. We may have to | |
1920 | ;; compensate at the end in byte-compile-fix-header. | |
1921 | (if dynamic-docstrings | |
1596952e | 1922 | (setq intro-string |
fb639443 RS |
1923 | ";;; This file uses dynamic docstrings, first added in Emacs 19.29.\n" |
1924 | minimum-version "19.29") | |
1925 | (setq intro-string | |
1926 | ";;; This file uses opcodes which do not exist in Emacs 18.\n" | |
1927 | minimum-version "19")) | |
1596952e RS |
1928 | ;; Now insert the comment and the error check. |
1929 | (insert | |
fb639443 | 1930 | "\n" |
1596952e RS |
1931 | intro-string |
1932 | ;; Have to check if emacs-version is bound so that this works | |
1933 | ;; in files loaded early in loadup.el. | |
fb639443 | 1934 | "(if (and (boundp 'emacs-version)\n" |
1596952e RS |
1935 | ;; If there is a name at the end of emacs-version, |
1936 | ;; don't try to check the version number. | |
1937 | "\t (< (aref emacs-version (1- (length emacs-version))) ?A)\n" | |
1938 | "\t (or (and (boundp 'epoch::version) epoch::version)\n" | |
1939 | (format "\t (string-lessp emacs-version \"%s\")))\n" | |
1940 | minimum-version) | |
1941 | " (error \"`" | |
1942 | ;; prin1-to-string is used to quote backslashes. | |
1943 | (substring (prin1-to-string (file-name-nondirectory filename)) | |
1944 | 1 -1) | |
1945 | (format "' was compiled for Emacs %s or later\"))\n\n" | |
fb639443 RS |
1946 | minimum-version) |
1947 | ;; Insert semicolons as ballast, so that byte-compile-fix-header | |
1948 | ;; can delete them so as to keep the buffer positions | |
1949 | ;; constant for the actual compiled code. | |
1950 | ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n\n")) | |
1596952e | 1951 | ;; Here if we want Emacs 18 compatibility. |
fb639443 RS |
1952 | (when dynamic-docstrings |
1953 | (error "Version-18 compatibility doesn't support dynamic doc strings")) | |
1954 | (when byte-compile-dynamic | |
1955 | (error "Version-18 compatibility doesn't support dynamic byte code")) | |
f1f32df9 | 1956 | (insert "(or (boundp 'current-load-list) (setq current-load-list nil))\n" |
1596952e | 1957 | "\n")))) |
1c393159 JB |
1958 | |
1959 | (defun byte-compile-output-file-form (form) | |
1960 | ;; writes the given form to the output buffer, being careful of docstrings | |
36b7e523 RS |
1961 | ;; in defun, defmacro, defvar, defconst, autoload and |
1962 | ;; custom-declare-variable because make-docfile is so amazingly stupid. | |
c36881cf ER |
1963 | ;; defalias calls are output directly by byte-compile-file-form-defmumble; |
1964 | ;; it does not pay to first build the defalias in defmumble and then parse | |
1965 | ;; it here. | |
36b7e523 RS |
1966 | (if (and (memq (car-safe form) '(defun defmacro defvar defconst autoload |
1967 | custom-declare-variable)) | |
1c393159 | 1968 | (stringp (nth 3 form))) |
d82e848c | 1969 | (byte-compile-output-docform nil nil '("\n(" 3 ")") form nil |
36b7e523 RS |
1970 | (memq (car form) |
1971 | '(autoload custom-declare-variable))) | |
1c393159 | 1972 | (let ((print-escape-newlines t) |
37c29340 KH |
1973 | (print-length nil) |
1974 | (print-level nil) | |
77308fd7 EN |
1975 | (print-quoted t) |
1976 | (print-gensym t)) | |
1c393159 JB |
1977 | (princ "\n" outbuffer) |
1978 | (prin1 form outbuffer) | |
1979 | nil))) | |
1980 | ||
6c2161c4 SM |
1981 | (defvar print-gensym-alist) ;Used before print-circle existed. |
1982 | ||
d82e848c | 1983 | (defun byte-compile-output-docform (preface name info form specindex quoted) |
dac6f673 RS |
1984 | "Print a form with a doc string. INFO is (prefix doc-index postfix). |
1985 | If PREFACE and NAME are non-nil, print them too, | |
1986 | before INFO and the FORM but after the doc string itself. | |
1987 | If SPECINDEX is non-nil, it is the index in FORM | |
1988 | of the function bytecode string. In that case, | |
1989 | we output that argument and the following argument (the constants vector) | |
1990 | together, for lazy loading. | |
1991 | QUOTED says that we have to put a quote before the | |
1992 | list that represents a doc string reference. | |
36b7e523 | 1993 | `autoload' and `custom-declare-variable' need that." |
dac6f673 RS |
1994 | ;; We need to examine byte-compile-dynamic-docstrings |
1995 | ;; in the input buffer (now current), not in the output buffer. | |
1996 | (let ((dynamic-docstrings byte-compile-dynamic-docstrings)) | |
1997 | (set-buffer | |
1998 | (prog1 (current-buffer) | |
1999 | (set-buffer outbuffer) | |
2000 | (let (position) | |
2001 | ||
2002 | ;; Insert the doc string, and make it a comment with #@LENGTH. | |
2003 | (and (>= (nth 1 info) 0) | |
2004 | dynamic-docstrings | |
393ae6ec | 2005 | (not byte-compile-compatibility) |
dac6f673 RS |
2006 | (progn |
2007 | ;; Make the doc string start at beginning of line | |
2008 | ;; for make-docfile's sake. | |
2009 | (insert "\n") | |
2010 | (setq position | |
2011 | (byte-compile-output-as-comment | |
2012 | (nth (nth 1 info) form) nil)) | |
ba76e7fa | 2013 | (setq position (- (position-bytes position) (point-min) -1)) |
dac6f673 RS |
2014 | ;; If the doc string starts with * (a user variable), |
2015 | ;; negate POSITION. | |
2016 | (if (and (stringp (nth (nth 1 info) form)) | |
2017 | (> (length (nth (nth 1 info) form)) 0) | |
2018 | (eq (aref (nth (nth 1 info) form) 0) ?*)) | |
2019 | (setq position (- position))))) | |
2020 | ||
2021 | (if preface | |
2022 | (progn | |
2023 | (insert preface) | |
2024 | (prin1 name outbuffer))) | |
2025 | (insert (car info)) | |
2026 | (let ((print-escape-newlines t) | |
77308fd7 | 2027 | (print-quoted t) |
3606c1c5 RS |
2028 | ;; For compatibility with code before print-circle, |
2029 | ;; use a cons cell to say that we want | |
2030 | ;; print-gensym-alist not to be cleared | |
2031 | ;; between calls to print functions. | |
2032 | (print-gensym '(t)) | |
6c2161c4 | 2033 | print-gensym-alist ; was used before print-circle existed. |
42e0601d RS |
2034 | (print-continuous-numbering t) |
2035 | print-number-table | |
dac6f673 RS |
2036 | (index 0)) |
2037 | (prin1 (car form) outbuffer) | |
2038 | (while (setq form (cdr form)) | |
2039 | (setq index (1+ index)) | |
2040 | (insert " ") | |
2b25de04 RS |
2041 | (cond ((and (numberp specindex) (= index specindex) |
2042 | ;; Don't handle the definition dynamically | |
2043 | ;; if it refers (or might refer) | |
2044 | ;; to objects already output | |
2045 | ;; (for instance, gensyms in the arg list). | |
2046 | (let (non-nil) | |
2047 | (dotimes (i (length print-number-table)) | |
2048 | (if (aref print-number-table i) | |
2049 | (setq non-nil t))) | |
2050 | (not non-nil))) | |
2051 | ;; Output the byte code and constants specially | |
2052 | ;; for lazy dynamic loading. | |
dac6f673 RS |
2053 | (let ((position |
2054 | (byte-compile-output-as-comment | |
2055 | (cons (car form) (nth 1 form)) | |
2056 | t))) | |
ba76e7fa | 2057 | (setq position (- (position-bytes position) (point-min) -1)) |
dac6f673 RS |
2058 | (princ (format "(#$ . %d) nil" position) outbuffer) |
2059 | (setq form (cdr form)) | |
2060 | (setq index (1+ index)))) | |
2061 | ((= index (nth 1 info)) | |
2062 | (if position | |
2063 | (princ (format (if quoted "'(#$ . %d)" "(#$ . %d)") | |
2064 | position) | |
2065 | outbuffer) | |
2066 | (let ((print-escape-newlines nil)) | |
2067 | (goto-char (prog1 (1+ (point)) | |
2068 | (prin1 (car form) outbuffer))) | |
2069 | (insert "\\\n") | |
2070 | (goto-char (point-max))))) | |
2071 | (t | |
2072 | (prin1 (car form) outbuffer))))) | |
2073 | (insert (nth 2 info)))))) | |
1c393159 JB |
2074 | nil) |
2075 | ||
2076 | (defun byte-compile-keep-pending (form &optional handler) | |
2077 | (if (memq byte-optimize '(t source)) | |
2078 | (setq form (byte-optimize-form form t))) | |
2079 | (if handler | |
2080 | (let ((for-effect t)) | |
2081 | ;; To avoid consing up monstrously large forms at load time, we split | |
2082 | ;; the output regularly. | |
b4ff4a23 RS |
2083 | (and (memq (car-safe form) '(fset defalias)) |
2084 | (nthcdr 300 byte-compile-output) | |
1c393159 JB |
2085 | (byte-compile-flush-pending)) |
2086 | (funcall handler form) | |
2087 | (if for-effect | |
2088 | (byte-compile-discard))) | |
2089 | (byte-compile-form form t)) | |
2090 | nil) | |
2091 | ||
2092 | (defun byte-compile-flush-pending () | |
2093 | (if byte-compile-output | |
2094 | (let ((form (byte-compile-out-toplevel t 'file))) | |
2095 | (cond ((eq (car-safe form) 'progn) | |
ed62683d | 2096 | (mapc 'byte-compile-output-file-form (cdr form))) |
1c393159 JB |
2097 | (form |
2098 | (byte-compile-output-file-form form))) | |
2099 | (setq byte-compile-constants nil | |
2100 | byte-compile-variables nil | |
2101 | byte-compile-depth 0 | |
2102 | byte-compile-maxdepth 0 | |
2103 | byte-compile-output nil)))) | |
2104 | ||
2105 | (defun byte-compile-file-form (form) | |
2106 | (let ((byte-compile-current-form nil) ; close over this for warnings. | |
2107 | handler) | |
2108 | (cond | |
2109 | ((not (consp form)) | |
2110 | (byte-compile-keep-pending form)) | |
2111 | ((and (symbolp (car form)) | |
2112 | (setq handler (get (car form) 'byte-hunk-handler))) | |
2113 | (cond ((setq form (funcall handler form)) | |
2114 | (byte-compile-flush-pending) | |
2115 | (byte-compile-output-file-form form)))) | |
2116 | ((eq form (setq form (macroexpand form byte-compile-macro-environment))) | |
2117 | (byte-compile-keep-pending form)) | |
2118 | (t | |
2119 | (byte-compile-file-form form))))) | |
2120 | ||
2121 | ;; Functions and variables with doc strings must be output separately, | |
2122 | ;; so make-docfile can recognise them. Most other things can be output | |
2123 | ;; as byte-code. | |
2124 | ||
2125 | (put 'defsubst 'byte-hunk-handler 'byte-compile-file-form-defsubst) | |
2126 | (defun byte-compile-file-form-defsubst (form) | |
6c2161c4 SM |
2127 | (when (assq (nth 1 form) byte-compile-unresolved-functions) |
2128 | (setq byte-compile-current-form (nth 1 form)) | |
1d5c17c0 | 2129 | (byte-compile-warn "defsubst `%s' was used before it was defined" |
6c2161c4 | 2130 | (nth 1 form))) |
1c393159 JB |
2131 | (byte-compile-file-form |
2132 | (macroexpand form byte-compile-macro-environment)) | |
2133 | ;; Return nil so the form is not output twice. | |
2134 | nil) | |
2135 | ||
2136 | (put 'autoload 'byte-hunk-handler 'byte-compile-file-form-autoload) | |
2137 | (defun byte-compile-file-form-autoload (form) | |
2138 | (and (let ((form form)) | |
2139 | (while (if (setq form (cdr form)) (byte-compile-constp (car form)))) | |
2140 | (null form)) ;Constants only | |
2141 | (eval (nth 5 form)) ;Macro | |
2142 | (eval form)) ;Define the autoload. | |
c5091f25 | 2143 | ;; Avoid undefined function warnings for the autoload. |
c3b2784b | 2144 | (if (and (consp (nth 1 form)) |
c5091f25 DL |
2145 | (eq (car (nth 1 form)) 'quote) |
2146 | (consp (cdr (nth 1 form))) | |
2147 | (symbolp (nth 1 (nth 1 form)))) | |
977b50fb SM |
2148 | (push (cons (nth 1 (nth 1 form)) |
2149 | (cons 'autoload (cdr (cdr form)))) | |
2150 | byte-compile-function-environment)) | |
1c393159 JB |
2151 | (if (stringp (nth 3 form)) |
2152 | form | |
2153 | ;; No doc string, so we can compile this as a normal form. | |
2154 | (byte-compile-keep-pending form 'byte-compile-normal-call))) | |
2155 | ||
2156 | (put 'defvar 'byte-hunk-handler 'byte-compile-file-form-defvar) | |
2157 | (put 'defconst 'byte-hunk-handler 'byte-compile-file-form-defvar) | |
2158 | (defun byte-compile-file-form-defvar (form) | |
2159 | (if (null (nth 3 form)) | |
2160 | ;; Since there is no doc string, we can compile this as a normal form, | |
2161 | ;; and not do a file-boundary. | |
2162 | (byte-compile-keep-pending form) | |
6c2161c4 | 2163 | (when (memq 'free-vars byte-compile-warnings) |
8898f44e | 2164 | (push (nth 1 form) byte-compile-bound-variables) |
6c2161c4 SM |
2165 | (if (eq (car form) 'defconst) |
2166 | (push (nth 1 form) byte-compile-const-variables))) | |
1c393159 JB |
2167 | (cond ((consp (nth 2 form)) |
2168 | (setq form (copy-sequence form)) | |
2169 | (setcar (cdr (cdr form)) | |
2170 | (byte-compile-top-level (nth 2 form) nil 'file)))) | |
2171 | form)) | |
2172 | ||
8c731d3d RS |
2173 | (put 'custom-declare-variable 'byte-hunk-handler |
2174 | 'byte-compile-file-form-custom-declare-variable) | |
2175 | (defun byte-compile-file-form-custom-declare-variable (form) | |
fe33e7c8 RS |
2176 | (when (memq 'callargs byte-compile-warnings) |
2177 | (byte-compile-nogroup-warn form)) | |
6c2161c4 SM |
2178 | (when (memq 'free-vars byte-compile-warnings) |
2179 | (push (nth 1 (nth 1 form)) byte-compile-bound-variables)) | |
347a36bc RS |
2180 | (let ((tail (nthcdr 4 form))) |
2181 | (while tail | |
2182 | ;; If there are any (function (lambda ...)) expressions, compile | |
2183 | ;; those functions. | |
2184 | (if (and (consp (car tail)) | |
2185 | (eq (car (car tail)) 'function) | |
2186 | (consp (nth 1 (car tail)))) | |
2187 | (setcar tail (byte-compile-lambda (nth 1 (car tail)))) | |
2188 | ;; Likewise for a bare lambda. | |
2189 | (if (and (consp (car tail)) | |
2190 | (eq (car (car tail)) 'lambda)) | |
2191 | (setcar tail (byte-compile-lambda (car tail))))) | |
2192 | (setq tail (cdr tail)))) | |
8c731d3d RS |
2193 | form) |
2194 | ||
997011eb RS |
2195 | (put 'require 'byte-hunk-handler 'byte-compile-file-form-require) |
2196 | (defun byte-compile-file-form-require (form) | |
2197 | (let ((old-load-list current-load-list) | |
2198 | (args (mapcar 'eval (cdr form)))) | |
2199 | (apply 'require args) | |
4db98503 | 2200 | ;; Detect (require 'cl) in a way that works even if cl is already loaded. |
997011eb RS |
2201 | (if (member (car args) '("cl" cl)) |
2202 | (setq byte-compile-warnings | |
2203 | (remq 'cl-functions byte-compile-warnings)))) | |
1c393159 JB |
2204 | (byte-compile-keep-pending form 'byte-compile-normal-call)) |
2205 | ||
2206 | (put 'progn 'byte-hunk-handler 'byte-compile-file-form-progn) | |
2207 | (put 'prog1 'byte-hunk-handler 'byte-compile-file-form-progn) | |
2208 | (put 'prog2 'byte-hunk-handler 'byte-compile-file-form-progn) | |
2209 | (defun byte-compile-file-form-progn (form) | |
ed62683d | 2210 | (mapc 'byte-compile-file-form (cdr form)) |
1c393159 JB |
2211 | ;; Return nil so the forms are not output twice. |
2212 | nil) | |
2213 | ||
2214 | ;; This handler is not necessary, but it makes the output from dont-compile | |
2215 | ;; and similar macros cleaner. | |
2216 | (put 'eval 'byte-hunk-handler 'byte-compile-file-form-eval) | |
2217 | (defun byte-compile-file-form-eval (form) | |
2218 | (if (eq (car-safe (nth 1 form)) 'quote) | |
2219 | (nth 1 (nth 1 form)) | |
2220 | (byte-compile-keep-pending form))) | |
2221 | ||
2222 | (put 'defun 'byte-hunk-handler 'byte-compile-file-form-defun) | |
2223 | (defun byte-compile-file-form-defun (form) | |
2224 | (byte-compile-file-form-defmumble form nil)) | |
2225 | ||
2226 | (put 'defmacro 'byte-hunk-handler 'byte-compile-file-form-defmacro) | |
2227 | (defun byte-compile-file-form-defmacro (form) | |
2228 | (byte-compile-file-form-defmumble form t)) | |
2229 | ||
2230 | (defun byte-compile-file-form-defmumble (form macrop) | |
2231 | (let* ((name (car (cdr form))) | |
2232 | (this-kind (if macrop 'byte-compile-macro-environment | |
2233 | 'byte-compile-function-environment)) | |
2234 | (that-kind (if macrop 'byte-compile-function-environment | |
2235 | 'byte-compile-macro-environment)) | |
2236 | (this-one (assq name (symbol-value this-kind))) | |
2237 | (that-one (assq name (symbol-value that-kind))) | |
2238 | (byte-compile-free-references nil) | |
2239 | (byte-compile-free-assignments nil)) | |
ccb3c8de | 2240 | (byte-compile-set-symbol-position name) |
1c393159 JB |
2241 | ;; When a function or macro is defined, add it to the call tree so that |
2242 | ;; we can tell when functions are not used. | |
2243 | (if byte-compile-generate-call-tree | |
2244 | (or (assq name byte-compile-call-tree) | |
2245 | (setq byte-compile-call-tree | |
2246 | (cons (list name nil nil) byte-compile-call-tree)))) | |
2247 | ||
2248 | (setq byte-compile-current-form name) ; for warnings | |
2249 | (if (memq 'redefine byte-compile-warnings) | |
2250 | (byte-compile-arglist-warn form macrop)) | |
2251 | (if byte-compile-verbose | |
47cf9d3a | 2252 | (message "Compiling %s... (%s)" (or filename "") (nth 1 form))) |
1c393159 JB |
2253 | (cond (that-one |
2254 | (if (and (memq 'redefine byte-compile-warnings) | |
52799cb8 | 2255 | ;; don't warn when compiling the stubs in byte-run... |
1c393159 JB |
2256 | (not (assq (nth 1 form) |
2257 | byte-compile-initial-macro-environment))) | |
2258 | (byte-compile-warn | |
1d5c17c0 | 2259 | "`%s' defined multiple times, as both function and macro" |
1c393159 JB |
2260 | (nth 1 form))) |
2261 | (setcdr that-one nil)) | |
2262 | (this-one | |
ccb3c8de | 2263 | (when (and (memq 'redefine byte-compile-warnings) |
1c393159 | 2264 | ;; hack: don't warn when compiling the magic internal |
52799cb8 | 2265 | ;; byte-compiler macros in byte-run.el... |
1c393159 JB |
2266 | (not (assq (nth 1 form) |
2267 | byte-compile-initial-macro-environment))) | |
1d5c17c0 | 2268 | (byte-compile-warn "%s `%s' defined multiple times in this file" |
ccb3c8de CW |
2269 | (if macrop "macro" "function") |
2270 | (nth 1 form)))) | |
1c393159 JB |
2271 | ((and (fboundp name) |
2272 | (eq (car-safe (symbol-function name)) | |
2273 | (if macrop 'lambda 'macro))) | |
ccb3c8de | 2274 | (when (memq 'redefine byte-compile-warnings) |
1d5c17c0 | 2275 | (byte-compile-warn "%s `%s' being redefined as a %s" |
ccb3c8de CW |
2276 | (if macrop "function" "macro") |
2277 | (nth 1 form) | |
2278 | (if macrop "macro" "function"))) | |
1c393159 JB |
2279 | ;; shadow existing definition |
2280 | (set this-kind | |
2281 | (cons (cons name nil) (symbol-value this-kind)))) | |
2282 | ) | |
2283 | (let ((body (nthcdr 3 form))) | |
ccb3c8de CW |
2284 | (when (and (stringp (car body)) |
2285 | (symbolp (car-safe (cdr-safe body))) | |
2286 | (car-safe (cdr-safe body)) | |
2287 | (stringp (car-safe (cdr-safe (cdr-safe body))))) | |
2288 | (byte-compile-set-symbol-position (nth 1 form)) | |
2289 | (byte-compile-warn "probable `\"' without `\\' in doc string of %s" | |
2290 | (nth 1 form)))) | |
6b8c2efc | 2291 | |
985b4686 GM |
2292 | ;; Generate code for declarations in macro definitions. |
2293 | ;; Remove declarations from the body of the macro definition. | |
2294 | (when macrop | |
2295 | (let ((tail (nthcdr 2 form))) | |
2296 | (when (stringp (car (cdr tail))) | |
2297 | (setq tail (cdr tail))) | |
2298 | (while (and (consp (car (cdr tail))) | |
2299 | (eq (car (car (cdr tail))) 'declare)) | |
2300 | (let ((declaration (car (cdr tail)))) | |
2301 | (setcdr tail (cdr (cdr tail))) | |
2302 | (princ `(if macro-declaration-function | |
2303 | (funcall macro-declaration-function | |
2304 | ',name ',declaration)) | |
2305 | outbuffer))))) | |
6b8c2efc | 2306 | |
1c393159 JB |
2307 | (let* ((new-one (byte-compile-lambda (cons 'lambda (nthcdr 2 form)))) |
2308 | (code (byte-compile-byte-code-maker new-one))) | |
2309 | (if this-one | |
2310 | (setcdr this-one new-one) | |
2311 | (set this-kind | |
2312 | (cons (cons name new-one) (symbol-value this-kind)))) | |
2313 | (if (and (stringp (nth 3 form)) | |
2314 | (eq 'quote (car-safe code)) | |
2315 | (eq 'lambda (car-safe (nth 1 code)))) | |
2316 | (cons (car form) | |
2317 | (cons name (cdr (nth 1 code)))) | |
d82e848c | 2318 | (byte-compile-flush-pending) |
1c393159 | 2319 | (if (not (stringp (nth 3 form))) |
d82e848c RS |
2320 | ;; No doc string. Provide -1 as the "doc string index" |
2321 | ;; so that no element will be treated as a doc string. | |
2322 | (byte-compile-output-docform | |
2323 | (if (byte-compile-version-cond byte-compile-compatibility) | |
2324 | "\n(fset '" "\n(defalias '") | |
2325 | name | |
2326 | (cond ((atom code) | |
2327 | (if macrop '(" '(macro . #[" -1 "])") '(" #[" -1 "]"))) | |
2328 | ((eq (car code) 'quote) | |
2329 | (setq code new-one) | |
2330 | (if macrop '(" '(macro " -1 ")") '(" '(" -1 ")"))) | |
2331 | ((if macrop '(" (cons 'macro (" -1 "))") '(" (" -1 ")")))) | |
2332 | (append code nil) | |
2333 | (and (atom code) byte-compile-dynamic | |
2334 | 1) | |
2335 | nil) | |
1c393159 | 2336 | ;; Output the form by hand, that's much simpler than having |
c36881cf | 2337 | ;; b-c-output-file-form analyze the defalias. |
1c393159 | 2338 | (byte-compile-output-docform |
d82e848c RS |
2339 | (if (byte-compile-version-cond byte-compile-compatibility) |
2340 | "\n(fset '" "\n(defalias '") | |
2341 | name | |
1c393159 JB |
2342 | (cond ((atom code) |
2343 | (if macrop '(" '(macro . #[" 4 "])") '(" #[" 4 "]"))) | |
2344 | ((eq (car code) 'quote) | |
2345 | (setq code new-one) | |
2346 | (if macrop '(" '(macro " 2 ")") '(" '(" 2 ")"))) | |
2347 | ((if macrop '(" (cons 'macro (" 5 "))") '(" (" 5 ")")))) | |
d82e848c RS |
2348 | (append code nil) |
2349 | (and (atom code) byte-compile-dynamic | |
2350 | 1) | |
2351 | nil)) | |
2352 | (princ ")" outbuffer) | |
2353 | nil)))) | |
2354 | ||
2355 | ;; Print Lisp object EXP in the output file, inside a comment, | |
2356 | ;; and return the file position it will have. | |
2357 | ;; If QUOTED is non-nil, print with quoting; otherwise, print without quoting. | |
2358 | (defun byte-compile-output-as-comment (exp quoted) | |
2d5975fa | 2359 | (let ((position (point))) |
d82e848c RS |
2360 | (set-buffer |
2361 | (prog1 (current-buffer) | |
2362 | (set-buffer outbuffer) | |
2363 | ||
2364 | ;; Insert EXP, and make it a comment with #@LENGTH. | |
2365 | (insert " ") | |
2366 | (if quoted | |
2367 | (prin1 exp outbuffer) | |
2368 | (princ exp outbuffer)) | |
2369 | (goto-char position) | |
2370 | ;; Quote certain special characters as needed. | |
2371 | ;; get_doc_string in doc.c does the unquoting. | |
2372 | (while (search-forward "\^A" nil t) | |
2373 | (replace-match "\^A\^A" t t)) | |
2374 | (goto-char position) | |
2375 | (while (search-forward "\000" nil t) | |
2376 | (replace-match "\^A0" t t)) | |
2377 | (goto-char position) | |
2378 | (while (search-forward "\037" nil t) | |
2379 | (replace-match "\^A_" t t)) | |
2380 | (goto-char (point-max)) | |
2381 | (insert "\037") | |
2382 | (goto-char position) | |
2d5975fa KH |
2383 | (insert "#@" (format "%d" (- (position-bytes (point-max)) |
2384 | (position-bytes position)))) | |
d82e848c RS |
2385 | |
2386 | ;; Save the file position of the object. | |
2387 | ;; Note we should add 1 to skip the space | |
2388 | ;; that we inserted before the actual doc string, | |
2389 | ;; and subtract 1 to convert from an 1-origin Emacs position | |
2390 | ;; to a file position; they cancel. | |
2391 | (setq position (point)) | |
2392 | (goto-char (point-max)))) | |
2393 | position)) | |
2394 | ||
1c393159 JB |
2395 | |
2396 | \f | |
fd5285f3 | 2397 | ;;;###autoload |
1c393159 JB |
2398 | (defun byte-compile (form) |
2399 | "If FORM is a symbol, byte-compile its function definition. | |
2400 | If FORM is a lambda or a macro, byte-compile it as a function." | |
2401 | (displaying-byte-compile-warnings | |
2402 | (byte-compile-close-variables | |
2403 | (let* ((fun (if (symbolp form) | |
2404 | (and (fboundp form) (symbol-function form)) | |
2405 | form)) | |
2406 | (macro (eq (car-safe fun) 'macro))) | |
2407 | (if macro | |
2408 | (setq fun (cdr fun))) | |
2409 | (cond ((eq (car-safe fun) 'lambda) | |
2410 | (setq fun (if macro | |
2411 | (cons 'macro (byte-compile-lambda fun)) | |
2412 | (byte-compile-lambda fun))) | |
2413 | (if (symbolp form) | |
c36881cf | 2414 | (defalias form fun) |
1c393159 JB |
2415 | fun))))))) |
2416 | ||
2417 | (defun byte-compile-sexp (sexp) | |
2418 | "Compile and return SEXP." | |
2419 | (displaying-byte-compile-warnings | |
2420 | (byte-compile-close-variables | |
2421 | (byte-compile-top-level sexp)))) | |
2422 | ||
2423 | ;; Given a function made by byte-compile-lambda, make a form which produces it. | |
2424 | (defun byte-compile-byte-code-maker (fun) | |
2425 | (cond | |
52799cb8 | 2426 | ((byte-compile-version-cond byte-compile-compatibility) |
1c393159 JB |
2427 | ;; Return (quote (lambda ...)). |
2428 | (list 'quote (byte-compile-byte-code-unmake fun))) | |
2429 | ;; ## atom is faster than compiled-func-p. | |
2430 | ((atom fun) ; compiled function. | |
2431 | ;; generate-emacs19-bytecodes must be on, otherwise byte-compile-lambda | |
2432 | ;; would have produced a lambda. | |
469414a0 | 2433 | fun) |
1c393159 | 2434 | ;; b-c-lambda didn't produce a compiled-function, so it's either a trivial |
52799cb8 | 2435 | ;; function, or this is Emacs 18, or generate-emacs19-bytecodes is off. |
1c393159 JB |
2436 | ((let (tmp) |
2437 | (if (and (setq tmp (assq 'byte-code (cdr-safe (cdr fun)))) | |
2438 | (null (cdr (memq tmp fun)))) | |
2439 | ;; Generate a make-byte-code call. | |
2440 | (let* ((interactive (assq 'interactive (cdr (cdr fun))))) | |
2441 | (nconc (list 'make-byte-code | |
2442 | (list 'quote (nth 1 fun)) ;arglist | |
2443 | (nth 1 tmp) ;bytes | |
2444 | (nth 2 tmp) ;consts | |
2445 | (nth 3 tmp)) ;depth | |
2446 | (cond ((stringp (nth 2 fun)) | |
2447 | (list (nth 2 fun))) ;doc | |
2448 | (interactive | |
2449 | (list nil))) | |
2450 | (cond (interactive | |
2451 | (list (if (or (null (nth 1 interactive)) | |
2452 | (stringp (nth 1 interactive))) | |
2453 | (nth 1 interactive) | |
2454 | ;; Interactive spec is a list or a variable | |
2455 | ;; (if it is correct). | |
2456 | (list 'quote (nth 1 interactive)))))))) | |
2457 | ;; a non-compiled function (probably trivial) | |
2458 | (list 'quote fun)))))) | |
2459 | ||
2460 | ;; Turn a function into an ordinary lambda. Needed for v18 files. | |
2461 | (defun byte-compile-byte-code-unmake (function) | |
2462 | (if (consp function) | |
2463 | function;;It already is a lambda. | |
2464 | (setq function (append function nil)) ; turn it into a list | |
2465 | (nconc (list 'lambda (nth 0 function)) | |
2466 | (and (nth 4 function) (list (nth 4 function))) | |
2467 | (if (nthcdr 5 function) | |
2468 | (list (cons 'interactive (if (nth 5 function) | |
2469 | (nthcdr 5 function))))) | |
2470 | (list (list 'byte-code | |
2471 | (nth 1 function) (nth 2 function) | |
2472 | (nth 3 function)))))) | |
2473 | ||
2474 | ||
eadd6444 GM |
2475 | (defun byte-compile-check-lambda-list (list) |
2476 | "Check lambda-list LIST for errors." | |
2477 | (let (vars) | |
2478 | (while list | |
2479 | (let ((arg (car list))) | |
ccb3c8de CW |
2480 | (when (symbolp arg) |
2481 | (byte-compile-set-symbol-position arg)) | |
1f006824 | 2482 | (cond ((or (not (symbolp arg)) |
6c2161c4 | 2483 | (byte-compile-const-symbol-p arg t)) |
eadd6444 GM |
2484 | (error "Invalid lambda variable %s" arg)) |
2485 | ((eq arg '&rest) | |
2486 | (unless (cdr list) | |
2487 | (error "&rest without variable name")) | |
2488 | (when (cddr list) | |
2489 | (error "Garbage following &rest VAR in lambda-list"))) | |
2490 | ((eq arg '&optional) | |
2491 | (unless (cdr list) | |
2492 | (error "Variable name missing after &optional"))) | |
2493 | ((memq arg vars) | |
e34fd2f2 | 2494 | (byte-compile-warn "repeated variable %s in lambda-list" arg)) |
1f006824 | 2495 | (t |
eadd6444 GM |
2496 | (push arg vars)))) |
2497 | (setq list (cdr list))))) | |
2498 | ||
2499 | ||
1c393159 JB |
2500 | ;; Byte-compile a lambda-expression and return a valid function. |
2501 | ;; The value is usually a compiled function but may be the original | |
2502 | ;; lambda-expression. | |
2503 | (defun byte-compile-lambda (fun) | |
b92dd692 DL |
2504 | (unless (eq 'lambda (car-safe fun)) |
2505 | (error "Not a lambda list: %S" fun)) | |
ccb3c8de | 2506 | (byte-compile-set-symbol-position 'lambda) |
eadd6444 | 2507 | (byte-compile-check-lambda-list (nth 1 fun)) |
1c393159 JB |
2508 | (let* ((arglist (nth 1 fun)) |
2509 | (byte-compile-bound-variables | |
2510 | (nconc (and (memq 'free-vars byte-compile-warnings) | |
2511 | (delq '&rest (delq '&optional (copy-sequence arglist)))) | |
2512 | byte-compile-bound-variables)) | |
2513 | (body (cdr (cdr fun))) | |
2514 | (doc (if (stringp (car body)) | |
2515 | (prog1 (car body) | |
d8f59f56 RS |
2516 | ;; Discard the doc string |
2517 | ;; unless it is the last element of the body. | |
b9edcafb | 2518 | (if (cdr body) |
d8f59f56 | 2519 | (setq body (cdr body)))))) |
1c393159 | 2520 | (int (assq 'interactive body))) |
6c2161c4 SM |
2521 | ;; Process the interactive spec. |
2522 | (when int | |
2523 | (byte-compile-set-symbol-position 'interactive) | |
2524 | ;; Skip (interactive) if it is in front (the most usual location). | |
2525 | (if (eq int (car body)) | |
2526 | (setq body (cdr body))) | |
2527 | (cond ((consp (cdr int)) | |
2528 | (if (cdr (cdr int)) | |
2529 | (byte-compile-warn "malformed interactive spec: %s" | |
2530 | (prin1-to-string int))) | |
ab43c850 RS |
2531 | ;; If the interactive spec is a call to `list', don't |
2532 | ;; compile it, because `call-interactively' looks at the | |
2533 | ;; args of `list'. Actually, compile it to get warnings, | |
2534 | ;; but don't use the result. | |
6c2161c4 SM |
2535 | (let ((form (nth 1 int))) |
2536 | (while (memq (car-safe form) '(let let* progn save-excursion)) | |
2537 | (while (consp (cdr form)) | |
2538 | (setq form (cdr form))) | |
2539 | (setq form (car form))) | |
ab43c850 RS |
2540 | (if (eq (car-safe form) 'list) |
2541 | (byte-compile-top-level (nth 1 int)) | |
2542 | (setq int (list 'interactive | |
2543 | (byte-compile-top-level (nth 1 int))))))) | |
6c2161c4 SM |
2544 | ((cdr int) |
2545 | (byte-compile-warn "malformed interactive spec: %s" | |
2546 | (prin1-to-string int))))) | |
2547 | ;; Process the body. | |
1c393159 | 2548 | (let ((compiled (byte-compile-top-level (cons 'progn body) nil 'lambda))) |
6c2161c4 | 2549 | ;; Build the actual byte-coded function. |
1c393159 | 2550 | (if (and (eq 'byte-code (car-safe compiled)) |
b890df1a RS |
2551 | (not (byte-compile-version-cond |
2552 | byte-compile-compatibility))) | |
1c393159 JB |
2553 | (apply 'make-byte-code |
2554 | (append (list arglist) | |
2555 | ;; byte-string, constants-vector, stack depth | |
2556 | (cdr compiled) | |
2557 | ;; optionally, the doc string. | |
2558 | (if (or doc int) | |
2559 | (list doc)) | |
2560 | ;; optionally, the interactive spec. | |
2561 | (if int | |
2562 | (list (nth 1 int))))) | |
2563 | (setq compiled | |
2564 | (nconc (if int (list int)) | |
2565 | (cond ((eq (car-safe compiled) 'progn) (cdr compiled)) | |
2566 | (compiled (list compiled))))) | |
2567 | (nconc (list 'lambda arglist) | |
2568 | (if (or doc (stringp (car compiled))) | |
2569 | (cons doc (cond (compiled) | |
2570 | (body (list nil)))) | |
2571 | compiled)))))) | |
2572 | ||
2573 | (defun byte-compile-constants-vector () | |
2574 | ;; Builds the constants-vector from the current variables and constants. | |
2575 | ;; This modifies the constants from (const . nil) to (const . offset). | |
2576 | ;; To keep the byte-codes to look up the vector as short as possible: | |
2577 | ;; First 6 elements are vars, as there are one-byte varref codes for those. | |
2578 | ;; Next up to byte-constant-limit are constants, still with one-byte codes. | |
2579 | ;; Next variables again, to get 2-byte codes for variable lookup. | |
2580 | ;; The rest of the constants and variables need 3-byte byte-codes. | |
2581 | (let* ((i -1) | |
2582 | (rest (nreverse byte-compile-variables)) ; nreverse because the first | |
2583 | (other (nreverse byte-compile-constants)) ; vars often are used most. | |
2584 | ret tmp | |
2585 | (limits '(5 ; Use the 1-byte varref codes, | |
2586 | 63 ; 1-constlim ; 1-byte byte-constant codes, | |
2587 | 255 ; 2-byte varref codes, | |
2588 | 65535)) ; 3-byte codes for the rest. | |
2589 | limit) | |
2590 | (while (or rest other) | |
2591 | (setq limit (car limits)) | |
2592 | (while (and rest (not (eq i limit))) | |
2593 | (if (setq tmp (assq (car (car rest)) ret)) | |
2594 | (setcdr (car rest) (cdr tmp)) | |
2595 | (setcdr (car rest) (setq i (1+ i))) | |
2596 | (setq ret (cons (car rest) ret))) | |
2597 | (setq rest (cdr rest))) | |
2598 | (setq limits (cdr limits) | |
2599 | rest (prog1 other | |
2600 | (setq other rest)))) | |
2601 | (apply 'vector (nreverse (mapcar 'car ret))))) | |
2602 | ||
2603 | ;; Given an expression FORM, compile it and return an equivalent byte-code | |
2604 | ;; expression (a call to the function byte-code). | |
2605 | (defun byte-compile-top-level (form &optional for-effect output-type) | |
2606 | ;; OUTPUT-TYPE advises about how form is expected to be used: | |
2607 | ;; 'eval or nil -> a single form, | |
2608 | ;; 'progn or t -> a list of forms, | |
2609 | ;; 'lambda -> body of a lambda, | |
2610 | ;; 'file -> used at file-level. | |
285cdf4e RS |
2611 | (let ((byte-compile-constants nil) |
2612 | (byte-compile-variables nil) | |
2613 | (byte-compile-tag-number 0) | |
2614 | (byte-compile-depth 0) | |
2615 | (byte-compile-maxdepth 0) | |
2616 | (byte-compile-output nil)) | |
d9e42bcf RS |
2617 | (if (memq byte-optimize '(t source)) |
2618 | (setq form (byte-optimize-form form for-effect))) | |
2619 | (while (and (eq (car-safe form) 'progn) (null (cdr (cdr form)))) | |
2620 | (setq form (nth 1 form))) | |
2621 | (if (and (eq 'byte-code (car-safe form)) | |
2622 | (not (memq byte-optimize '(t byte))) | |
2623 | (stringp (nth 1 form)) (vectorp (nth 2 form)) | |
2624 | (natnump (nth 3 form))) | |
2625 | form | |
2626 | (byte-compile-form form for-effect) | |
285cdf4e | 2627 | (byte-compile-out-toplevel for-effect output-type)))) |
1c393159 JB |
2628 | |
2629 | (defun byte-compile-out-toplevel (&optional for-effect output-type) | |
2630 | (if for-effect | |
2631 | ;; The stack is empty. Push a value to be returned from (byte-code ..). | |
2632 | (if (eq (car (car byte-compile-output)) 'byte-discard) | |
2633 | (setq byte-compile-output (cdr byte-compile-output)) | |
2634 | (byte-compile-push-constant | |
2635 | ;; Push any constant - preferably one which already is used, and | |
2636 | ;; a number or symbol - ie not some big sequence. The return value | |
2637 | ;; isn't returned, but it would be a shame if some textually large | |
2638 | ;; constant was not optimized away because we chose to return it. | |
2639 | (and (not (assq nil byte-compile-constants)) ; Nil is often there. | |
2640 | (let ((tmp (reverse byte-compile-constants))) | |
ba76e7fa SM |
2641 | (while (and tmp (not (or (symbolp (caar tmp)) |
2642 | (numberp (caar tmp))))) | |
1c393159 | 2643 | (setq tmp (cdr tmp))) |
ba76e7fa | 2644 | (caar tmp)))))) |
1c393159 JB |
2645 | (byte-compile-out 'byte-return 0) |
2646 | (setq byte-compile-output (nreverse byte-compile-output)) | |
2647 | (if (memq byte-optimize '(t byte)) | |
2648 | (setq byte-compile-output | |
2649 | (byte-optimize-lapcode byte-compile-output for-effect))) | |
1f006824 | 2650 | |
1c393159 JB |
2651 | ;; Decompile trivial functions: |
2652 | ;; only constants and variables, or a single funcall except in lambdas. | |
2653 | ;; Except for Lisp_Compiled objects, forms like (foo "hi") | |
2654 | ;; are still quicker than (byte-code "..." [foo "hi"] 2). | |
2655 | ;; Note that even (quote foo) must be parsed just as any subr by the | |
2656 | ;; interpreter, so quote should be compiled into byte-code in some contexts. | |
2657 | ;; What to leave uncompiled: | |
69dc83fd KH |
2658 | ;; lambda -> never. we used to leave it uncompiled if the body was |
2659 | ;; a single atom, but that causes confusion if the docstring | |
2660 | ;; uses the (file . pos) syntax. Besides, now that we have | |
2661 | ;; the Lisp_Compiled type, the compiled form is faster. | |
1c393159 JB |
2662 | ;; eval -> atom, quote or (function atom atom atom) |
2663 | ;; progn -> as <<same-as-eval>> or (progn <<same-as-eval>> atom) | |
2664 | ;; file -> as progn, but takes both quotes and atoms, and longer forms. | |
2665 | (let (rest | |
2666 | (maycall (not (eq output-type 'lambda))) ; t if we may make a funcall. | |
2667 | tmp body) | |
2668 | (cond | |
2669 | ;; #### This should be split out into byte-compile-nontrivial-function-p. | |
69dc83fd KH |
2670 | ((or (eq output-type 'lambda) |
2671 | (nthcdr (if (eq output-type 'file) 50 8) byte-compile-output) | |
1c393159 JB |
2672 | (assq 'TAG byte-compile-output) ; Not necessary, but speeds up a bit. |
2673 | (not (setq tmp (assq 'byte-return byte-compile-output))) | |
2674 | (progn | |
2675 | (setq rest (nreverse | |
2676 | (cdr (memq tmp (reverse byte-compile-output))))) | |
2677 | (while (cond | |
2678 | ((memq (car (car rest)) '(byte-varref byte-constant)) | |
2679 | (setq tmp (car (cdr (car rest)))) | |
469414a0 RS |
2680 | (if (if (eq (car (car rest)) 'byte-constant) |
2681 | (or (consp tmp) | |
2682 | (and (symbolp tmp) | |
1639b803 | 2683 | (not (byte-compile-const-symbol-p tmp))))) |
469414a0 RS |
2684 | (if maycall |
2685 | (setq body (cons (list 'quote tmp) body))) | |
2686 | (setq body (cons tmp body)))) | |
1c393159 JB |
2687 | ((and maycall |
2688 | ;; Allow a funcall if at most one atom follows it. | |
2689 | (null (nthcdr 3 rest)) | |
2690 | (setq tmp (get (car (car rest)) 'byte-opcode-invert)) | |
2691 | (or (null (cdr rest)) | |
2692 | (and (memq output-type '(file progn t)) | |
2693 | (cdr (cdr rest)) | |
2694 | (eq (car (nth 1 rest)) 'byte-discard) | |
2695 | (progn (setq rest (cdr rest)) t)))) | |
2696 | (setq maycall nil) ; Only allow one real function call. | |
2697 | (setq body (nreverse body)) | |
2698 | (setq body (list | |
2699 | (if (and (eq tmp 'funcall) | |
2700 | (eq (car-safe (car body)) 'quote)) | |
2701 | (cons (nth 1 (car body)) (cdr body)) | |
2702 | (cons tmp body)))) | |
2703 | (or (eq output-type 'file) | |
2704 | (not (delq nil (mapcar 'consp (cdr (car body)))))))) | |
2705 | (setq rest (cdr rest))) | |
69dc83fd | 2706 | rest)) |
1c393159 JB |
2707 | (let ((byte-compile-vector (byte-compile-constants-vector))) |
2708 | (list 'byte-code (byte-compile-lapcode byte-compile-output) | |
2709 | byte-compile-vector byte-compile-maxdepth))) | |
2710 | ;; it's a trivial function | |
2711 | ((cdr body) (cons 'progn (nreverse body))) | |
2712 | ((car body))))) | |
2713 | ||
2714 | ;; Given BODY, compile it and return a new body. | |
2715 | (defun byte-compile-top-level-body (body &optional for-effect) | |
2716 | (setq body (byte-compile-top-level (cons 'progn body) for-effect t)) | |
2717 | (cond ((eq (car-safe body) 'progn) | |
2718 | (cdr body)) | |
2719 | (body | |
2720 | (list body)))) | |
2721 | \f | |
c5091f25 | 2722 | ;; This is the recursive entry point for compiling each subform of an |
1c393159 JB |
2723 | ;; expression. |
2724 | ;; If for-effect is non-nil, byte-compile-form will output a byte-discard | |
2725 | ;; before terminating (ie no value will be left on the stack). | |
2726 | ;; A byte-compile handler may, when for-effect is non-nil, choose output code | |
2727 | ;; which does not leave a value on the stack, and then set for-effect to nil | |
2728 | ;; (to prevent byte-compile-form from outputting the byte-discard). | |
2729 | ;; If a handler wants to call another handler, it should do so via | |
2730 | ;; byte-compile-form, or take extreme care to handle for-effect correctly. | |
2731 | ;; (Use byte-compile-form-do-effect to reset the for-effect flag too.) | |
2732 | ;; | |
2733 | (defun byte-compile-form (form &optional for-effect) | |
2734 | (setq form (macroexpand form byte-compile-macro-environment)) | |
2735 | (cond ((not (consp form)) | |
1639b803 | 2736 | (cond ((or (not (symbolp form)) (byte-compile-const-symbol-p form)) |
0b46acbf RS |
2737 | (when (symbolp form) |
2738 | (byte-compile-set-symbol-position form)) | |
1c393159 JB |
2739 | (byte-compile-constant form)) |
2740 | ((and for-effect byte-compile-delete-errors) | |
0b46acbf RS |
2741 | (when (symbolp form) |
2742 | (byte-compile-set-symbol-position form)) | |
1c393159 JB |
2743 | (setq for-effect nil)) |
2744 | (t (byte-compile-variable-ref 'byte-varref form)))) | |
2745 | ((symbolp (car form)) | |
2746 | (let* ((fn (car form)) | |
2747 | (handler (get fn 'byte-compile))) | |
ccb3c8de | 2748 | (when (byte-compile-const-symbol-p fn) |
1d5c17c0 | 2749 | (byte-compile-warn "`%s' called as a function" fn)) |
086af77c | 2750 | (and (memq 'interactive-only byte-compile-warnings) |
11efeb9b | 2751 | (memq fn byte-compile-interactive-only-functions) |
086af77c RS |
2752 | (byte-compile-warn "`%s' used from Lisp code\n\ |
2753 | That command is designed for interactive use only" fn)) | |
1c393159 | 2754 | (if (and handler |
e27c3564 JB |
2755 | (or (not (byte-compile-version-cond |
2756 | byte-compile-compatibility)) | |
1c393159 | 2757 | (not (get (get fn 'byte-opcode) 'emacs19-opcode)))) |
0b46acbf RS |
2758 | (progn |
2759 | (byte-compile-set-symbol-position fn) | |
2760 | (funcall handler form)) | |
11efeb9b RS |
2761 | (when (memq 'callargs byte-compile-warnings) |
2762 | (if (memq fn '(custom-declare-group custom-declare-variable custom-declare-face)) | |
2763 | (byte-compile-nogroup-warn form)) | |
2764 | (byte-compile-callargs-warn form)) | |
4795d1c7 RS |
2765 | (byte-compile-normal-call form)) |
2766 | (if (memq 'cl-functions byte-compile-warnings) | |
2767 | (byte-compile-cl-warn form)))) | |
ed015bdd | 2768 | ((and (or (byte-code-function-p (car form)) |
1c393159 JB |
2769 | (eq (car-safe (car form)) 'lambda)) |
2770 | ;; if the form comes out the same way it went in, that's | |
2771 | ;; because it was malformed, and we couldn't unfold it. | |
2772 | (not (eq form (setq form (byte-compile-unfold-lambda form))))) | |
2773 | (byte-compile-form form for-effect) | |
2774 | (setq for-effect nil)) | |
2775 | ((byte-compile-normal-call form))) | |
2776 | (if for-effect | |
2777 | (byte-compile-discard))) | |
2778 | ||
2779 | (defun byte-compile-normal-call (form) | |
2780 | (if byte-compile-generate-call-tree | |
2781 | (byte-compile-annotate-call-tree form)) | |
2782 | (byte-compile-push-constant (car form)) | |
ed62683d | 2783 | (mapc 'byte-compile-form (cdr form)) ; wasteful, but faster. |
1c393159 JB |
2784 | (byte-compile-out 'byte-call (length (cdr form)))) |
2785 | ||
2786 | (defun byte-compile-variable-ref (base-op var) | |
ccb3c8de CW |
2787 | (when (symbolp var) |
2788 | (byte-compile-set-symbol-position var)) | |
6c2161c4 SM |
2789 | (if (or (not (symbolp var)) |
2790 | (byte-compile-const-symbol-p var (not (eq base-op 'byte-varref)))) | |
2791 | (byte-compile-warn | |
1d5c17c0 RS |
2792 | (cond ((eq base-op 'byte-varbind) "attempt to let-bind %s `%s'") |
2793 | ((eq base-op 'byte-varset) "variable assignment to %s `%s'") | |
2794 | (t "variable reference to %s `%s'")) | |
6c2161c4 SM |
2795 | (if (symbolp var) "constant" "nonvariable") |
2796 | (prin1-to-string var)) | |
9290191f | 2797 | (if (and (get var 'byte-obsolete-variable) |
9e31e67b RS |
2798 | (memq 'obsolete byte-compile-warnings) |
2799 | (not (eq var byte-compile-not-obsolete-var))) | |
20482b70 SM |
2800 | (let* ((ob (get var 'byte-obsolete-variable)) |
2801 | (when (cdr ob))) | |
1d5c17c0 | 2802 | (byte-compile-warn "`%s' is an obsolete variable%s; %s" var |
f1953880 | 2803 | (if when (concat " (as of Emacs " when ")") "") |
20482b70 SM |
2804 | (if (stringp (car ob)) |
2805 | (car ob) | |
1d5c17c0 | 2806 | (format "use `%s' instead." (car ob)))))) |
1c393159 JB |
2807 | (if (memq 'free-vars byte-compile-warnings) |
2808 | (if (eq base-op 'byte-varbind) | |
6c2161c4 | 2809 | (push var byte-compile-bound-variables) |
1c393159 JB |
2810 | (or (boundp var) |
2811 | (memq var byte-compile-bound-variables) | |
2812 | (if (eq base-op 'byte-varset) | |
2813 | (or (memq var byte-compile-free-assignments) | |
2814 | (progn | |
1d5c17c0 | 2815 | (byte-compile-warn "assignment to free variable `%s'" var) |
6c2161c4 | 2816 | (push var byte-compile-free-assignments))) |
1c393159 JB |
2817 | (or (memq var byte-compile-free-references) |
2818 | (progn | |
1d5c17c0 | 2819 | (byte-compile-warn "reference to free variable `%s'" var) |
6c2161c4 | 2820 | (push var byte-compile-free-references)))))))) |
1c393159 | 2821 | (let ((tmp (assq var byte-compile-variables))) |
6c2161c4 SM |
2822 | (unless tmp |
2823 | (setq tmp (list var)) | |
2824 | (push tmp byte-compile-variables)) | |
1c393159 JB |
2825 | (byte-compile-out base-op tmp))) |
2826 | ||
2827 | (defmacro byte-compile-get-constant (const) | |
1639b803 | 2828 | `(or (if (stringp ,const) |
8de44769 RS |
2829 | (assoc-default ,const byte-compile-constants |
2830 | 'equal-including-properties nil) | |
1639b803 DL |
2831 | (assq ,const byte-compile-constants)) |
2832 | (car (setq byte-compile-constants | |
2833 | (cons (list ,const) byte-compile-constants))))) | |
1c393159 JB |
2834 | |
2835 | ;; Use this when the value of a form is a constant. This obeys for-effect. | |
2836 | (defun byte-compile-constant (const) | |
2837 | (if for-effect | |
2838 | (setq for-effect nil) | |
ccb3c8de CW |
2839 | (when (symbolp const) |
2840 | (byte-compile-set-symbol-position const)) | |
1c393159 JB |
2841 | (byte-compile-out 'byte-constant (byte-compile-get-constant const)))) |
2842 | ||
2843 | ;; Use this for a constant that is not the value of its containing form. | |
2844 | ;; This ignores for-effect. | |
2845 | (defun byte-compile-push-constant (const) | |
2846 | (let ((for-effect nil)) | |
2847 | (inline (byte-compile-constant const)))) | |
2848 | ||
2849 | \f | |
2850 | ;; Compile those primitive ordinary functions | |
2851 | ;; which have special byte codes just for speed. | |
2852 | ||
2853 | (defmacro byte-defop-compiler (function &optional compile-handler) | |
2854 | ;; add a compiler-form for FUNCTION. | |
2855 | ;; If function is a symbol, then the variable "byte-SYMBOL" must name | |
2856 | ;; the opcode to be used. If function is a list, the first element | |
2857 | ;; is the function and the second element is the bytecode-symbol. | |
3c9dc1cf | 2858 | ;; The second element may be nil, meaning there is no opcode. |
1c393159 JB |
2859 | ;; COMPILE-HANDLER is the function to use to compile this byte-op, or |
2860 | ;; may be the abbreviations 0, 1, 2, 3, 0-1, or 1-2. | |
2861 | ;; If it is nil, then the handler is "byte-compile-SYMBOL." | |
2862 | (let (opcode) | |
2863 | (if (symbolp function) | |
2864 | (setq opcode (intern (concat "byte-" (symbol-name function)))) | |
2865 | (setq opcode (car (cdr function)) | |
2866 | function (car function))) | |
2867 | (let ((fnform | |
2868 | (list 'put (list 'quote function) ''byte-compile | |
2869 | (list 'quote | |
2870 | (or (cdr (assq compile-handler | |
2871 | '((0 . byte-compile-no-args) | |
2872 | (1 . byte-compile-one-arg) | |
2873 | (2 . byte-compile-two-args) | |
2874 | (3 . byte-compile-three-args) | |
2875 | (0-1 . byte-compile-zero-or-one-arg) | |
2876 | (1-2 . byte-compile-one-or-two-args) | |
2877 | (2-3 . byte-compile-two-or-three-args) | |
2878 | ))) | |
2879 | compile-handler | |
2880 | (intern (concat "byte-compile-" | |
2881 | (symbol-name function)))))))) | |
2882 | (if opcode | |
2883 | (list 'progn fnform | |
2884 | (list 'put (list 'quote function) | |
2885 | ''byte-opcode (list 'quote opcode)) | |
2886 | (list 'put (list 'quote opcode) | |
2887 | ''byte-opcode-invert (list 'quote function))) | |
2888 | fnform)))) | |
2889 | ||
2890 | (defmacro byte-defop-compiler19 (function &optional compile-handler) | |
2891 | ;; Just like byte-defop-compiler, but defines an opcode that will only | |
e27c3564 | 2892 | ;; be used when byte-compile-compatibility is false. |
1c393159 | 2893 | (if (and (byte-compile-single-version) |
e27c3564 | 2894 | byte-compile-compatibility) |
9e2b097b JB |
2895 | ;; #### instead of doing nothing, this should do some remprops, |
2896 | ;; #### to protect against the case where a single-version compiler | |
2897 | ;; #### is loaded into a world that has contained a multi-version one. | |
1c393159 JB |
2898 | nil |
2899 | (list 'progn | |
2900 | (list 'put | |
2901 | (list 'quote | |
2902 | (or (car (cdr-safe function)) | |
2903 | (intern (concat "byte-" | |
2904 | (symbol-name (or (car-safe function) function)))))) | |
2905 | ''emacs19-opcode t) | |
2906 | (list 'byte-defop-compiler function compile-handler)))) | |
2907 | ||
2908 | (defmacro byte-defop-compiler-1 (function &optional compile-handler) | |
2909 | (list 'byte-defop-compiler (list function nil) compile-handler)) | |
2910 | ||
2911 | \f | |
2912 | (put 'byte-call 'byte-opcode-invert 'funcall) | |
2913 | (put 'byte-list1 'byte-opcode-invert 'list) | |
2914 | (put 'byte-list2 'byte-opcode-invert 'list) | |
2915 | (put 'byte-list3 'byte-opcode-invert 'list) | |
2916 | (put 'byte-list4 'byte-opcode-invert 'list) | |
2917 | (put 'byte-listN 'byte-opcode-invert 'list) | |
2918 | (put 'byte-concat2 'byte-opcode-invert 'concat) | |
2919 | (put 'byte-concat3 'byte-opcode-invert 'concat) | |
2920 | (put 'byte-concat4 'byte-opcode-invert 'concat) | |
2921 | (put 'byte-concatN 'byte-opcode-invert 'concat) | |
2922 | (put 'byte-insertN 'byte-opcode-invert 'insert) | |
2923 | ||
1c393159 JB |
2924 | (byte-defop-compiler point 0) |
2925 | ;;(byte-defop-compiler mark 0) ;; obsolete | |
2926 | (byte-defop-compiler point-max 0) | |
2927 | (byte-defop-compiler point-min 0) | |
2928 | (byte-defop-compiler following-char 0) | |
2929 | (byte-defop-compiler preceding-char 0) | |
2930 | (byte-defop-compiler current-column 0) | |
2931 | (byte-defop-compiler eolp 0) | |
2932 | (byte-defop-compiler eobp 0) | |
2933 | (byte-defop-compiler bolp 0) | |
2934 | (byte-defop-compiler bobp 0) | |
2935 | (byte-defop-compiler current-buffer 0) | |
2936 | ;;(byte-defop-compiler read-char 0) ;; obsolete | |
2937 | (byte-defop-compiler interactive-p 0) | |
2938 | (byte-defop-compiler19 widen 0) | |
2939 | (byte-defop-compiler19 end-of-line 0-1) | |
2940 | (byte-defop-compiler19 forward-char 0-1) | |
2941 | (byte-defop-compiler19 forward-line 0-1) | |
2942 | (byte-defop-compiler symbolp 1) | |
2943 | (byte-defop-compiler consp 1) | |
2944 | (byte-defop-compiler stringp 1) | |
2945 | (byte-defop-compiler listp 1) | |
2946 | (byte-defop-compiler not 1) | |
2947 | (byte-defop-compiler (null byte-not) 1) | |
2948 | (byte-defop-compiler car 1) | |
2949 | (byte-defop-compiler cdr 1) | |
2950 | (byte-defop-compiler length 1) | |
2951 | (byte-defop-compiler symbol-value 1) | |
2952 | (byte-defop-compiler symbol-function 1) | |
2953 | (byte-defop-compiler (1+ byte-add1) 1) | |
2954 | (byte-defop-compiler (1- byte-sub1) 1) | |
2955 | (byte-defop-compiler goto-char 1) | |
b8ae93ad | 2956 | (byte-defop-compiler char-after 0-1) |
1c393159 JB |
2957 | (byte-defop-compiler set-buffer 1) |
2958 | ;;(byte-defop-compiler set-mark 1) ;; obsolete | |
78642e03 | 2959 | (byte-defop-compiler19 forward-word 0-1) |
1c393159 JB |
2960 | (byte-defop-compiler19 char-syntax 1) |
2961 | (byte-defop-compiler19 nreverse 1) | |
2962 | (byte-defop-compiler19 car-safe 1) | |
2963 | (byte-defop-compiler19 cdr-safe 1) | |
2964 | (byte-defop-compiler19 numberp 1) | |
2965 | (byte-defop-compiler19 integerp 1) | |
2966 | (byte-defop-compiler19 skip-chars-forward 1-2) | |
2967 | (byte-defop-compiler19 skip-chars-backward 1-2) | |
1c393159 JB |
2968 | (byte-defop-compiler eq 2) |
2969 | (byte-defop-compiler memq 2) | |
2970 | (byte-defop-compiler cons 2) | |
2971 | (byte-defop-compiler aref 2) | |
2972 | (byte-defop-compiler set 2) | |
2973 | (byte-defop-compiler (= byte-eqlsign) 2) | |
2974 | (byte-defop-compiler (< byte-lss) 2) | |
2975 | (byte-defop-compiler (> byte-gtr) 2) | |
2976 | (byte-defop-compiler (<= byte-leq) 2) | |
2977 | (byte-defop-compiler (>= byte-geq) 2) | |
2978 | (byte-defop-compiler get 2) | |
2979 | (byte-defop-compiler nth 2) | |
2980 | (byte-defop-compiler substring 2-3) | |
9e2b097b | 2981 | (byte-defop-compiler19 (move-marker byte-set-marker) 2-3) |
1c393159 JB |
2982 | (byte-defop-compiler19 set-marker 2-3) |
2983 | (byte-defop-compiler19 match-beginning 1) | |
2984 | (byte-defop-compiler19 match-end 1) | |
2985 | (byte-defop-compiler19 upcase 1) | |
2986 | (byte-defop-compiler19 downcase 1) | |
2987 | (byte-defop-compiler19 string= 2) | |
2988 | (byte-defop-compiler19 string< 2) | |
9e2b097b JB |
2989 | (byte-defop-compiler19 (string-equal byte-string=) 2) |
2990 | (byte-defop-compiler19 (string-lessp byte-string<) 2) | |
1c393159 JB |
2991 | (byte-defop-compiler19 equal 2) |
2992 | (byte-defop-compiler19 nthcdr 2) | |
2993 | (byte-defop-compiler19 elt 2) | |
2994 | (byte-defop-compiler19 member 2) | |
2995 | (byte-defop-compiler19 assq 2) | |
9e2b097b JB |
2996 | (byte-defop-compiler19 (rplaca byte-setcar) 2) |
2997 | (byte-defop-compiler19 (rplacd byte-setcdr) 2) | |
1c393159 JB |
2998 | (byte-defop-compiler19 setcar 2) |
2999 | (byte-defop-compiler19 setcdr 2) | |
3000 | (byte-defop-compiler19 buffer-substring 2) | |
3001 | (byte-defop-compiler19 delete-region 2) | |
3002 | (byte-defop-compiler19 narrow-to-region 2) | |
1c393159 JB |
3003 | (byte-defop-compiler19 (% byte-rem) 2) |
3004 | (byte-defop-compiler aset 3) | |
3005 | ||
3006 | (byte-defop-compiler max byte-compile-associative) | |
3007 | (byte-defop-compiler min byte-compile-associative) | |
3008 | (byte-defop-compiler (+ byte-plus) byte-compile-associative) | |
3009 | (byte-defop-compiler19 (* byte-mult) byte-compile-associative) | |
3010 | ||
3011 | ;;####(byte-defop-compiler19 move-to-column 1) | |
3012 | (byte-defop-compiler-1 interactive byte-compile-noop) | |
3013 | ||
3014 | \f | |
3015 | (defun byte-compile-subr-wrong-args (form n) | |
ccb3c8de | 3016 | (byte-compile-set-symbol-position (car form)) |
1d5c17c0 | 3017 | (byte-compile-warn "`%s' called with %d arg%s, but requires %s" |
1c393159 JB |
3018 | (car form) (length (cdr form)) |
3019 | (if (= 1 (length (cdr form))) "" "s") n) | |
3020 | ;; get run-time wrong-number-of-args error. | |
3021 | (byte-compile-normal-call form)) | |
3022 | ||
3023 | (defun byte-compile-no-args (form) | |
3024 | (if (not (= (length form) 1)) | |
3025 | (byte-compile-subr-wrong-args form "none") | |
3026 | (byte-compile-out (get (car form) 'byte-opcode) 0))) | |
3027 | ||
3028 | (defun byte-compile-one-arg (form) | |
3029 | (if (not (= (length form) 2)) | |
3030 | (byte-compile-subr-wrong-args form 1) | |
3031 | (byte-compile-form (car (cdr form))) ;; Push the argument | |
3032 | (byte-compile-out (get (car form) 'byte-opcode) 0))) | |
3033 | ||
3034 | (defun byte-compile-two-args (form) | |
3035 | (if (not (= (length form) 3)) | |
3036 | (byte-compile-subr-wrong-args form 2) | |
3037 | (byte-compile-form (car (cdr form))) ;; Push the arguments | |
3038 | (byte-compile-form (nth 2 form)) | |
3039 | (byte-compile-out (get (car form) 'byte-opcode) 0))) | |
3040 | ||
3041 | (defun byte-compile-three-args (form) | |
3042 | (if (not (= (length form) 4)) | |
3043 | (byte-compile-subr-wrong-args form 3) | |
3044 | (byte-compile-form (car (cdr form))) ;; Push the arguments | |
3045 | (byte-compile-form (nth 2 form)) | |
3046 | (byte-compile-form (nth 3 form)) | |
3047 | (byte-compile-out (get (car form) 'byte-opcode) 0))) | |
3048 | ||
3049 | (defun byte-compile-zero-or-one-arg (form) | |
3050 | (let ((len (length form))) | |
3051 | (cond ((= len 1) (byte-compile-one-arg (append form '(nil)))) | |
3052 | ((= len 2) (byte-compile-one-arg form)) | |
3053 | (t (byte-compile-subr-wrong-args form "0-1"))))) | |
3054 | ||
3055 | (defun byte-compile-one-or-two-args (form) | |
3056 | (let ((len (length form))) | |
3057 | (cond ((= len 2) (byte-compile-two-args (append form '(nil)))) | |
3058 | ((= len 3) (byte-compile-two-args form)) | |
3059 | (t (byte-compile-subr-wrong-args form "1-2"))))) | |
3060 | ||
3061 | (defun byte-compile-two-or-three-args (form) | |
3062 | (let ((len (length form))) | |
3063 | (cond ((= len 3) (byte-compile-three-args (append form '(nil)))) | |
3064 | ((= len 4) (byte-compile-three-args form)) | |
3065 | (t (byte-compile-subr-wrong-args form "2-3"))))) | |
3066 | ||
3067 | (defun byte-compile-noop (form) | |
3068 | (byte-compile-constant nil)) | |
3069 | ||
3070 | (defun byte-compile-discard () | |
3071 | (byte-compile-out 'byte-discard 0)) | |
3072 | ||
3073 | ||
3074 | ;; Compile a function that accepts one or more args and is right-associative. | |
c0f43df5 RS |
3075 | ;; We do it by left-associativity so that the operations |
3076 | ;; are done in the same order as in interpreted code. | |
10809e0f RS |
3077 | ;; We treat the one-arg case, as in (+ x), like (+ x 0). |
3078 | ;; in order to convert markers to numbers, and trigger expected errors. | |
1c393159 JB |
3079 | (defun byte-compile-associative (form) |
3080 | (if (cdr form) | |
c0f43df5 RS |
3081 | (let ((opcode (get (car form) 'byte-opcode)) |
3082 | (args (copy-sequence (cdr form)))) | |
3083 | (byte-compile-form (car args)) | |
3084 | (setq args (cdr args)) | |
10809e0f RS |
3085 | (or args (setq args '(0) |
3086 | opcode (get '+ 'byte-opcode))) | |
6c2161c4 SM |
3087 | (dolist (arg args) |
3088 | (byte-compile-form arg) | |
3089 | (byte-compile-out opcode 0))) | |
1c393159 JB |
3090 | (byte-compile-constant (eval form)))) |
3091 | ||
3092 | \f | |
3093 | ;; more complicated compiler macros | |
3094 | ||
3095 | (byte-defop-compiler list) | |
3096 | (byte-defop-compiler concat) | |
3097 | (byte-defop-compiler fset) | |
3098 | (byte-defop-compiler (indent-to-column byte-indent-to) byte-compile-indent-to) | |
3099 | (byte-defop-compiler indent-to) | |
3100 | (byte-defop-compiler insert) | |
3101 | (byte-defop-compiler-1 function byte-compile-function-form) | |
3102 | (byte-defop-compiler-1 - byte-compile-minus) | |
3103 | (byte-defop-compiler19 (/ byte-quo) byte-compile-quo) | |
3104 | (byte-defop-compiler19 nconc) | |
1c393159 JB |
3105 | |
3106 | (defun byte-compile-list (form) | |
3107 | (let ((count (length (cdr form)))) | |
3108 | (cond ((= count 0) | |
3109 | (byte-compile-constant nil)) | |
3110 | ((< count 5) | |
ed62683d | 3111 | (mapc 'byte-compile-form (cdr form)) |
1c393159 JB |
3112 | (byte-compile-out |
3113 | (aref [byte-list1 byte-list2 byte-list3 byte-list4] (1- count)) 0)) | |
e27c3564 JB |
3114 | ((and (< count 256) (not (byte-compile-version-cond |
3115 | byte-compile-compatibility))) | |
ed62683d | 3116 | (mapc 'byte-compile-form (cdr form)) |
1c393159 JB |
3117 | (byte-compile-out 'byte-listN count)) |
3118 | (t (byte-compile-normal-call form))))) | |
3119 | ||
3120 | (defun byte-compile-concat (form) | |
3121 | (let ((count (length (cdr form)))) | |
3122 | (cond ((and (< 1 count) (< count 5)) | |
ed62683d | 3123 | (mapc 'byte-compile-form (cdr form)) |
1c393159 JB |
3124 | (byte-compile-out |
3125 | (aref [byte-concat2 byte-concat3 byte-concat4] (- count 2)) | |
3126 | 0)) | |
3127 | ;; Concat of one arg is not a no-op if arg is not a string. | |
3128 | ((= count 0) | |
3129 | (byte-compile-form "")) | |
e27c3564 JB |
3130 | ((and (< count 256) (not (byte-compile-version-cond |
3131 | byte-compile-compatibility))) | |
ed62683d | 3132 | (mapc 'byte-compile-form (cdr form)) |
1c393159 JB |
3133 | (byte-compile-out 'byte-concatN count)) |
3134 | ((byte-compile-normal-call form))))) | |
3135 | ||
3136 | (defun byte-compile-minus (form) | |
3137 | (if (null (setq form (cdr form))) | |
3138 | (byte-compile-constant 0) | |
3139 | (byte-compile-form (car form)) | |
3140 | (if (cdr form) | |
3141 | (while (setq form (cdr form)) | |
3142 | (byte-compile-form (car form)) | |
3143 | (byte-compile-out 'byte-diff 0)) | |
3144 | (byte-compile-out 'byte-negate 0)))) | |
3145 | ||
3146 | (defun byte-compile-quo (form) | |
3147 | (let ((len (length form))) | |
3148 | (cond ((<= len 2) | |
3149 | (byte-compile-subr-wrong-args form "2 or more")) | |
3150 | (t | |
3151 | (byte-compile-form (car (setq form (cdr form)))) | |
3152 | (while (setq form (cdr form)) | |
3153 | (byte-compile-form (car form)) | |
3154 | (byte-compile-out 'byte-quo 0)))))) | |
3155 | ||
3156 | (defun byte-compile-nconc (form) | |
3157 | (let ((len (length form))) | |
3158 | (cond ((= len 1) | |
3159 | (byte-compile-constant nil)) | |
3160 | ((= len 2) | |
3161 | ;; nconc of one arg is a noop, even if that arg isn't a list. | |
3162 | (byte-compile-form (nth 1 form))) | |
3163 | (t | |
3164 | (byte-compile-form (car (setq form (cdr form)))) | |
3165 | (while (setq form (cdr form)) | |
3166 | (byte-compile-form (car form)) | |
3167 | (byte-compile-out 'byte-nconc 0)))))) | |
3168 | ||
3169 | (defun byte-compile-fset (form) | |
3170 | ;; warn about forms like (fset 'foo '(lambda () ...)) | |
3171 | ;; (where the lambda expression is non-trivial...) | |
3172 | (let ((fn (nth 2 form)) | |
3173 | body) | |
3174 | (if (and (eq (car-safe fn) 'quote) | |
3175 | (eq (car-safe (setq fn (nth 1 fn))) 'lambda)) | |
3176 | (progn | |
3177 | (setq body (cdr (cdr fn))) | |
3178 | (if (stringp (car body)) (setq body (cdr body))) | |
3179 | (if (eq 'interactive (car-safe (car body))) (setq body (cdr body))) | |
3180 | (if (and (consp (car body)) | |
3181 | (not (eq 'byte-code (car (car body))))) | |
3182 | (byte-compile-warn | |
1d5c17c0 | 3183 | "A quoted lambda form is the second argument of `fset'. This is probably |
1c393159 JB |
3184 | not what you want, as that lambda cannot be compiled. Consider using |
3185 | the syntax (function (lambda (...) ...)) instead."))))) | |
3186 | (byte-compile-two-args form)) | |
3187 | ||
3188 | (defun byte-compile-funarg (form) | |
3189 | ;; (mapcar '(lambda (x) ..) ..) ==> (mapcar (function (lambda (x) ..)) ..) | |
eb8c3be9 | 3190 | ;; for cases where it's guaranteed that first arg will be used as a lambda. |
1c393159 JB |
3191 | (byte-compile-normal-call |
3192 | (let ((fn (nth 1 form))) | |
3193 | (if (and (eq (car-safe fn) 'quote) | |
3194 | (eq (car-safe (nth 1 fn)) 'lambda)) | |
3195 | (cons (car form) | |
3196 | (cons (cons 'function (cdr fn)) | |
3197 | (cdr (cdr form)))) | |
3198 | form)))) | |
3199 | ||
5a6037bb RS |
3200 | (defun byte-compile-funarg-2 (form) |
3201 | ;; (sort ... '(lambda (x) ..)) ==> (sort ... (function (lambda (x) ..))) | |
3202 | ;; for cases where it's guaranteed that second arg will be used as a lambda. | |
3203 | (byte-compile-normal-call | |
3204 | (let ((fn (nth 2 form))) | |
3205 | (if (and (eq (car-safe fn) 'quote) | |
3206 | (eq (car-safe (nth 1 fn)) 'lambda)) | |
3207 | (cons (car form) | |
3208 | (cons (nth 1 form) | |
3209 | (cons (cons 'function (cdr fn)) | |
3210 | (cdr (cdr (cdr form)))))) | |
3211 | form)))) | |
3212 | ||
1c393159 JB |
3213 | ;; (function foo) must compile like 'foo, not like (symbol-function 'foo). |
3214 | ;; Otherwise it will be incompatible with the interpreter, | |
3215 | ;; and (funcall (function foo)) will lose with autoloads. | |
3216 | ||
3217 | (defun byte-compile-function-form (form) | |
3218 | (byte-compile-constant | |
3219 | (cond ((symbolp (nth 1 form)) | |
3220 | (nth 1 form)) | |
3221 | ;; If we're not allowed to use #[] syntax, then output a form like | |
3222 | ;; '(lambda (..) (byte-code ..)) instead of a call to make-byte-code. | |
3223 | ;; In this situation, calling make-byte-code at run-time will usually | |
3224 | ;; be less efficient than processing a call to byte-code. | |
52799cb8 | 3225 | ((byte-compile-version-cond byte-compile-compatibility) |
1c393159 JB |
3226 | (byte-compile-byte-code-unmake (byte-compile-lambda (nth 1 form)))) |
3227 | ((byte-compile-lambda (nth 1 form)))))) | |
3228 | ||
3229 | (defun byte-compile-indent-to (form) | |
3230 | (let ((len (length form))) | |
3231 | (cond ((= len 2) | |
3232 | (byte-compile-form (car (cdr form))) | |
3233 | (byte-compile-out 'byte-indent-to 0)) | |
3234 | ((= len 3) | |
3235 | ;; no opcode for 2-arg case. | |
3236 | (byte-compile-normal-call form)) | |
3237 | (t | |
3238 | (byte-compile-subr-wrong-args form "1-2"))))) | |
3239 | ||
3240 | (defun byte-compile-insert (form) | |
3241 | (cond ((null (cdr form)) | |
3242 | (byte-compile-constant nil)) | |
e27c3564 JB |
3243 | ((and (not (byte-compile-version-cond |
3244 | byte-compile-compatibility)) | |
1c393159 | 3245 | (<= (length form) 256)) |
ed62683d | 3246 | (mapc 'byte-compile-form (cdr form)) |
1c393159 JB |
3247 | (if (cdr (cdr form)) |
3248 | (byte-compile-out 'byte-insertN (length (cdr form))) | |
3249 | (byte-compile-out 'byte-insert 0))) | |
3250 | ((memq t (mapcar 'consp (cdr (cdr form)))) | |
3251 | (byte-compile-normal-call form)) | |
3252 | ;; We can split it; there is no function call after inserting 1st arg. | |
3253 | (t | |
3254 | (while (setq form (cdr form)) | |
3255 | (byte-compile-form (car form)) | |
3256 | (byte-compile-out 'byte-insert 0) | |
3257 | (if (cdr form) | |
3258 | (byte-compile-discard)))))) | |
3259 | ||
1c393159 JB |
3260 | \f |
3261 | (byte-defop-compiler-1 setq) | |
3262 | (byte-defop-compiler-1 setq-default) | |
3263 | (byte-defop-compiler-1 quote) | |
3264 | (byte-defop-compiler-1 quote-form) | |
3265 | ||
3266 | (defun byte-compile-setq (form) | |
3267 | (let ((args (cdr form))) | |
3268 | (if args | |
3269 | (while args | |
3270 | (byte-compile-form (car (cdr args))) | |
3271 | (or for-effect (cdr (cdr args)) | |
3272 | (byte-compile-out 'byte-dup 0)) | |
3273 | (byte-compile-variable-ref 'byte-varset (car args)) | |
3274 | (setq args (cdr (cdr args)))) | |
3275 | ;; (setq), with no arguments. | |
3276 | (byte-compile-form nil for-effect)) | |
3277 | (setq for-effect nil))) | |
3278 | ||
3279 | (defun byte-compile-setq-default (form) | |
ca38179a RS |
3280 | (let ((args (cdr form)) |
3281 | setters) | |
3282 | (while args | |
3283 | (setq setters | |
3284 | (cons (list 'set-default (list 'quote (car args)) (car (cdr args))) | |
3285 | setters)) | |
3286 | (setq args (cdr (cdr args)))) | |
3287 | (byte-compile-form (cons 'progn (nreverse setters))))) | |
1c393159 JB |
3288 | |
3289 | (defun byte-compile-quote (form) | |
3290 | (byte-compile-constant (car (cdr form)))) | |
3291 | ||
3292 | (defun byte-compile-quote-form (form) | |
3293 | (byte-compile-constant (byte-compile-top-level (nth 1 form)))) | |
3294 | ||
3295 | \f | |
3296 | ;;; control structures | |
3297 | ||
3298 | (defun byte-compile-body (body &optional for-effect) | |
3299 | (while (cdr body) | |
3300 | (byte-compile-form (car body) t) | |
3301 | (setq body (cdr body))) | |
3302 | (byte-compile-form (car body) for-effect)) | |
3303 | ||
52799cb8 | 3304 | (defsubst byte-compile-body-do-effect (body) |
1c393159 JB |
3305 | (byte-compile-body body for-effect) |
3306 | (setq for-effect nil)) | |
3307 | ||
52799cb8 | 3308 | (defsubst byte-compile-form-do-effect (form) |
1c393159 JB |
3309 | (byte-compile-form form for-effect) |
3310 | (setq for-effect nil)) | |
3311 | ||
3312 | (byte-defop-compiler-1 inline byte-compile-progn) | |
3313 | (byte-defop-compiler-1 progn) | |
3314 | (byte-defop-compiler-1 prog1) | |
3315 | (byte-defop-compiler-1 prog2) | |
3316 | (byte-defop-compiler-1 if) | |
3317 | (byte-defop-compiler-1 cond) | |
3318 | (byte-defop-compiler-1 and) | |
3319 | (byte-defop-compiler-1 or) | |
3320 | (byte-defop-compiler-1 while) | |
3321 | (byte-defop-compiler-1 funcall) | |
3322 | (byte-defop-compiler-1 apply byte-compile-funarg) | |
3323 | (byte-defop-compiler-1 mapcar byte-compile-funarg) | |
3324 | (byte-defop-compiler-1 mapatoms byte-compile-funarg) | |
3325 | (byte-defop-compiler-1 mapconcat byte-compile-funarg) | |
28bb2cef | 3326 | (byte-defop-compiler-1 mapc byte-compile-funarg) |
def9389a DL |
3327 | (byte-defop-compiler-1 maphash byte-compile-funarg) |
3328 | (byte-defop-compiler-1 map-char-table byte-compile-funarg) | |
5a6037bb | 3329 | (byte-defop-compiler-1 sort byte-compile-funarg-2) |
1c393159 JB |
3330 | (byte-defop-compiler-1 let) |
3331 | (byte-defop-compiler-1 let*) | |
3332 | ||
3333 | (defun byte-compile-progn (form) | |
3334 | (byte-compile-body-do-effect (cdr form))) | |
3335 | ||
3336 | (defun byte-compile-prog1 (form) | |
3337 | (byte-compile-form-do-effect (car (cdr form))) | |
3338 | (byte-compile-body (cdr (cdr form)) t)) | |
3339 | ||
3340 | (defun byte-compile-prog2 (form) | |
3341 | (byte-compile-form (nth 1 form) t) | |
3342 | (byte-compile-form-do-effect (nth 2 form)) | |
3343 | (byte-compile-body (cdr (cdr (cdr form))) t)) | |
3344 | ||
3345 | (defmacro byte-compile-goto-if (cond discard tag) | |
1639b803 DL |
3346 | `(byte-compile-goto |
3347 | (if ,cond | |
3348 | (if ,discard 'byte-goto-if-not-nil 'byte-goto-if-not-nil-else-pop) | |
3349 | (if ,discard 'byte-goto-if-nil 'byte-goto-if-nil-else-pop)) | |
3350 | ,tag)) | |
1c393159 | 3351 | |
ab43c850 RS |
3352 | (defmacro byte-compile-maybe-guarded (condition &rest body) |
3353 | "Execute forms in BODY, potentially guarded by CONDITION. | |
82a726b4 RS |
3354 | CONDITION is a variable whose value is a test in an `if' or `cond'. |
3355 | BODY is the code to compile first arm of the if or the body of the | |
b2e948ee | 3356 | cond clause. If CONDITION's value is of the form (fboundp 'foo) |
ad50a502 | 3357 | or (boundp 'foo), the relevant warnings from BODY about foo's |
82a726b4 RS |
3358 | being undefined will be suppressed. |
3359 | ||
b2e948ee | 3360 | If CONDITION's value is (not (featurep 'emacs)) or (featurep 'xemacs), |
ad50a502 | 3361 | that suppresses all warnings during execution of BODY." |
ab43c850 RS |
3362 | (declare (indent 1) (debug t)) |
3363 | `(let* ((fbound | |
3364 | (if (eq 'fboundp (car-safe ,condition)) | |
3365 | (and (eq 'quote (car-safe (nth 1 ,condition))) | |
3366 | ;; Ignore if the symbol is already on the | |
3367 | ;; unresolved list. | |
3368 | (not (assq (nth 1 (nth 1 ,condition)) ; the relevant symbol | |
3369 | byte-compile-unresolved-functions)) | |
3370 | (nth 1 (nth 1 ,condition))))) | |
3371 | (bound (if (or (eq 'boundp (car-safe ,condition)) | |
3372 | (eq 'default-boundp (car-safe ,condition))) | |
3373 | (and (eq 'quote (car-safe (nth 1 ,condition))) | |
3374 | (nth 1 (nth 1 ,condition))))) | |
3375 | ;; Maybe add to the bound list. | |
3376 | (byte-compile-bound-variables | |
3377 | (if bound | |
3378 | (cons bound byte-compile-bound-variables) | |
82a726b4 | 3379 | byte-compile-bound-variables)) |
83b0af6e | 3380 | ;; Suppress all warnings, for code not used in Emacs. |
82a726b4 | 3381 | (byte-compile-warnings |
83b0af6e RS |
3382 | (if (member ,condition '((featurep 'xemacs) |
3383 | (not (featurep 'emacs)))) | |
82a726b4 RS |
3384 | nil byte-compile-warnings))) |
3385 | (unwind-protect | |
3386 | (progn ,@body) | |
3387 | ;; Maybe remove the function symbol from the unresolved list. | |
3388 | (if fbound | |
3389 | (setq byte-compile-unresolved-functions | |
3390 | (delq (assq fbound byte-compile-unresolved-functions) | |
3391 | byte-compile-unresolved-functions)))))) | |
ab43c850 | 3392 | |
1c393159 JB |
3393 | (defun byte-compile-if (form) |
3394 | (byte-compile-form (car (cdr form))) | |
b8234c84 DL |
3395 | ;; Check whether we have `(if (fboundp ...' or `(if (boundp ...' |
3396 | ;; and avoid warnings about the relevent symbols in the consequent. | |
ab43c850 RS |
3397 | (let ((clause (nth 1 form)) |
3398 | (donetag (byte-compile-make-tag))) | |
b8234c84 DL |
3399 | (if (null (nthcdr 3 form)) |
3400 | ;; No else-forms | |
3401 | (progn | |
3402 | (byte-compile-goto-if nil for-effect donetag) | |
ab43c850 | 3403 | (byte-compile-maybe-guarded clause |
b8234c84 | 3404 | (byte-compile-form (nth 2 form) for-effect)) |
b8234c84 DL |
3405 | (byte-compile-out-tag donetag)) |
3406 | (let ((elsetag (byte-compile-make-tag))) | |
3407 | (byte-compile-goto 'byte-goto-if-nil elsetag) | |
ab43c850 RS |
3408 | (byte-compile-maybe-guarded clause |
3409 | (byte-compile-form (nth 2 form) for-effect)) | |
b8234c84 DL |
3410 | (byte-compile-goto 'byte-goto donetag) |
3411 | (byte-compile-out-tag elsetag) | |
300f994a RS |
3412 | (byte-compile-maybe-guarded (list 'not clause) |
3413 | (byte-compile-body (cdr (cdr (cdr form))) for-effect)) | |
b8234c84 | 3414 | (byte-compile-out-tag donetag)))) |
1c393159 JB |
3415 | (setq for-effect nil)) |
3416 | ||
3417 | (defun byte-compile-cond (clauses) | |
3418 | (let ((donetag (byte-compile-make-tag)) | |
3419 | nexttag clause) | |
3420 | (while (setq clauses (cdr clauses)) | |
3421 | (setq clause (car clauses)) | |
3422 | (cond ((or (eq (car clause) t) | |
3423 | (and (eq (car-safe (car clause)) 'quote) | |
3424 | (car-safe (cdr-safe (car clause))))) | |
3425 | ;; Unconditional clause | |
3426 | (setq clause (cons t clause) | |
3427 | clauses nil)) | |
3428 | ((cdr clauses) | |
3429 | (byte-compile-form (car clause)) | |
3430 | (if (null (cdr clause)) | |
3431 | ;; First clause is a singleton. | |
3432 | (byte-compile-goto-if t for-effect donetag) | |
82a726b4 RS |
3433 | (setq nexttag (byte-compile-make-tag)) |
3434 | (byte-compile-goto 'byte-goto-if-nil nexttag) | |
3435 | (byte-compile-maybe-guarded (car clause) | |
3436 | (byte-compile-body (cdr clause) for-effect)) | |
3437 | (byte-compile-goto 'byte-goto donetag) | |
3438 | (byte-compile-out-tag nexttag))))) | |
1c393159 | 3439 | ;; Last clause |
7d0e0955 SM |
3440 | (let ((guard (car clause))) |
3441 | (and (cdr clause) (not (eq guard t)) | |
3442 | (progn (byte-compile-form guard) | |
3443 | (byte-compile-goto-if nil for-effect donetag) | |
3444 | (setq clause (cdr clause)))) | |
3445 | (byte-compile-maybe-guarded guard | |
3446 | (byte-compile-body-do-effect clause))) | |
1c393159 JB |
3447 | (byte-compile-out-tag donetag))) |
3448 | ||
3449 | (defun byte-compile-and (form) | |
3450 | (let ((failtag (byte-compile-make-tag)) | |
3451 | (args (cdr form))) | |
3452 | (if (null args) | |
3453 | (byte-compile-form-do-effect t) | |
8877fa6f RS |
3454 | (byte-compile-and-recursion args failtag)))) |
3455 | ||
83b0af6e | 3456 | ;; Handle compilation of a nontrivial `and' call. |
8877fa6f RS |
3457 | ;; We use tail recursion so we can use byte-compile-maybe-guarded. |
3458 | (defun byte-compile-and-recursion (rest failtag) | |
3459 | (if (cdr rest) | |
3460 | (progn | |
3461 | (byte-compile-form (car rest)) | |
1c393159 | 3462 | (byte-compile-goto-if nil for-effect failtag) |
8877fa6f RS |
3463 | (byte-compile-maybe-guarded (car rest) |
3464 | (byte-compile-and-recursion (cdr rest) failtag))) | |
3465 | (byte-compile-form-do-effect (car rest)) | |
3466 | (byte-compile-out-tag failtag))) | |
1c393159 JB |
3467 | |
3468 | (defun byte-compile-or (form) | |
3469 | (let ((wintag (byte-compile-make-tag)) | |
3470 | (args (cdr form))) | |
3471 | (if (null args) | |
3472 | (byte-compile-form-do-effect nil) | |
83b0af6e RS |
3473 | (byte-compile-or-recursion args wintag)))) |
3474 | ||
3475 | ;; Handle compilation of a nontrivial `or' call. | |
3476 | ;; We use tail recursion so we can use byte-compile-maybe-guarded. | |
3477 | (defun byte-compile-or-recursion (rest wintag) | |
3478 | (if (cdr rest) | |
3479 | (progn | |
3480 | (byte-compile-form (car rest)) | |
1c393159 | 3481 | (byte-compile-goto-if t for-effect wintag) |
83b0af6e RS |
3482 | (byte-compile-maybe-guarded (list 'not (car rest)) |
3483 | (byte-compile-or-recursion (cdr rest) wintag))) | |
3484 | (byte-compile-form-do-effect (car rest)) | |
3485 | (byte-compile-out-tag wintag))) | |
1c393159 JB |
3486 | |
3487 | (defun byte-compile-while (form) | |
3488 | (let ((endtag (byte-compile-make-tag)) | |
3489 | (looptag (byte-compile-make-tag))) | |
3490 | (byte-compile-out-tag looptag) | |
3491 | (byte-compile-form (car (cdr form))) | |
3492 | (byte-compile-goto-if nil for-effect endtag) | |
3493 | (byte-compile-body (cdr (cdr form)) t) | |
3494 | (byte-compile-goto 'byte-goto looptag) | |
3495 | (byte-compile-out-tag endtag) | |
3496 | (setq for-effect nil))) | |
3497 | ||
3498 | (defun byte-compile-funcall (form) | |
ed62683d | 3499 | (mapc 'byte-compile-form (cdr form)) |
1c393159 JB |
3500 | (byte-compile-out 'byte-call (length (cdr (cdr form))))) |
3501 | ||
3502 | ||
3503 | (defun byte-compile-let (form) | |
3504 | ;; First compute the binding values in the old scope. | |
3505 | (let ((varlist (car (cdr form)))) | |
6c2161c4 SM |
3506 | (dolist (var varlist) |
3507 | (if (consp var) | |
3508 | (byte-compile-form (car (cdr var))) | |
3509 | (byte-compile-push-constant nil)))) | |
1c393159 JB |
3510 | (let ((byte-compile-bound-variables byte-compile-bound-variables) ;new scope |
3511 | (varlist (reverse (car (cdr form))))) | |
6c2161c4 SM |
3512 | (dolist (var varlist) |
3513 | (byte-compile-variable-ref 'byte-varbind (if (consp var) (car var) var))) | |
1c393159 JB |
3514 | (byte-compile-body-do-effect (cdr (cdr form))) |
3515 | (byte-compile-out 'byte-unbind (length (car (cdr form)))))) | |
3516 | ||
3517 | (defun byte-compile-let* (form) | |
3518 | (let ((byte-compile-bound-variables byte-compile-bound-variables) ;new scope | |
3519 | (varlist (copy-sequence (car (cdr form))))) | |
6c2161c4 SM |
3520 | (dolist (var varlist) |
3521 | (if (atom var) | |
1c393159 | 3522 | (byte-compile-push-constant nil) |
6c2161c4 SM |
3523 | (byte-compile-form (car (cdr var))) |
3524 | (setq var (car var))) | |
3525 | (byte-compile-variable-ref 'byte-varbind var)) | |
1c393159 JB |
3526 | (byte-compile-body-do-effect (cdr (cdr form))) |
3527 | (byte-compile-out 'byte-unbind (length (car (cdr form)))))) | |
3528 | ||
3529 | ||
3530 | (byte-defop-compiler-1 /= byte-compile-negated) | |
3531 | (byte-defop-compiler-1 atom byte-compile-negated) | |
3532 | (byte-defop-compiler-1 nlistp byte-compile-negated) | |
3533 | ||
3534 | (put '/= 'byte-compile-negated-op '=) | |
3535 | (put 'atom 'byte-compile-negated-op 'consp) | |
3536 | (put 'nlistp 'byte-compile-negated-op 'listp) | |
3537 | ||
3538 | (defun byte-compile-negated (form) | |
3539 | (byte-compile-form-do-effect (byte-compile-negation-optimizer form))) | |
3540 | ||
3541 | ;; Even when optimization is off, /= is optimized to (not (= ...)). | |
3542 | (defun byte-compile-negation-optimizer (form) | |
3543 | ;; an optimizer for forms where <form1> is less efficient than (not <form2>) | |
ccb3c8de | 3544 | (byte-compile-set-symbol-position (car form)) |
1c393159 JB |
3545 | (list 'not |
3546 | (cons (or (get (car form) 'byte-compile-negated-op) | |
3547 | (error | |
52799cb8 | 3548 | "Compiler error: `%s' has no `byte-compile-negated-op' property" |
1c393159 JB |
3549 | (car form))) |
3550 | (cdr form)))) | |
3551 | \f | |
3552 | ;;; other tricky macro-like special-forms | |
3553 | ||
3554 | (byte-defop-compiler-1 catch) | |
3555 | (byte-defop-compiler-1 unwind-protect) | |
3556 | (byte-defop-compiler-1 condition-case) | |
3557 | (byte-defop-compiler-1 save-excursion) | |
f3e472b0 | 3558 | (byte-defop-compiler-1 save-current-buffer) |
1c393159 JB |
3559 | (byte-defop-compiler-1 save-restriction) |
3560 | (byte-defop-compiler-1 save-window-excursion) | |
3561 | (byte-defop-compiler-1 with-output-to-temp-buffer) | |
6e8d0db7 | 3562 | (byte-defop-compiler-1 track-mouse) |
1c393159 JB |
3563 | |
3564 | (defun byte-compile-catch (form) | |
3565 | (byte-compile-form (car (cdr form))) | |
3566 | (byte-compile-push-constant | |
3567 | (byte-compile-top-level (cons 'progn (cdr (cdr form))) for-effect)) | |
3568 | (byte-compile-out 'byte-catch 0)) | |
3569 | ||
3570 | (defun byte-compile-unwind-protect (form) | |
3571 | (byte-compile-push-constant | |
3572 | (byte-compile-top-level-body (cdr (cdr form)) t)) | |
3573 | (byte-compile-out 'byte-unwind-protect 0) | |
3574 | (byte-compile-form-do-effect (car (cdr form))) | |
3575 | (byte-compile-out 'byte-unbind 1)) | |
3576 | ||
6e8d0db7 | 3577 | (defun byte-compile-track-mouse (form) |
d7846e08 | 3578 | (byte-compile-form |
6c2161c4 SM |
3579 | `(funcall '(lambda nil |
3580 | (track-mouse ,@(byte-compile-top-level-body (cdr form))))))) | |
6e8d0db7 | 3581 | |
1c393159 JB |
3582 | (defun byte-compile-condition-case (form) |
3583 | (let* ((var (nth 1 form)) | |
3584 | (byte-compile-bound-variables | |
3585 | (if var (cons var byte-compile-bound-variables) | |
3586 | byte-compile-bound-variables))) | |
ccb3c8de CW |
3587 | (byte-compile-set-symbol-position 'condition-case) |
3588 | (unless (symbolp var) | |
3589 | (byte-compile-warn | |
1d5c17c0 | 3590 | "`%s' is not a variable-name or nil (in condition-case)" var)) |
1c393159 JB |
3591 | (byte-compile-push-constant var) |
3592 | (byte-compile-push-constant (byte-compile-top-level | |
3593 | (nth 2 form) for-effect)) | |
3594 | (let ((clauses (cdr (cdr (cdr form)))) | |
3595 | compiled-clauses) | |
3596 | (while clauses | |
e27c3564 JB |
3597 | (let* ((clause (car clauses)) |
3598 | (condition (car clause))) | |
2abcddce RS |
3599 | (cond ((not (or (symbolp condition) |
3600 | (and (listp condition) | |
3601 | (let ((syms condition) (ok t)) | |
3602 | (while syms | |
3603 | (if (not (symbolp (car syms))) | |
3604 | (setq ok nil)) | |
3605 | (setq syms (cdr syms))) | |
3606 | ok)))) | |
e27c3564 | 3607 | (byte-compile-warn |
1d5c17c0 | 3608 | "`%s' is not a condition name or list of such (in condition-case)" |
e27c3564 | 3609 | (prin1-to-string condition))) |
2abcddce RS |
3610 | ;; ((not (or (eq condition 't) |
3611 | ;; (and (stringp (get condition 'error-message)) | |
3612 | ;; (consp (get condition 'error-conditions))))) | |
3613 | ;; (byte-compile-warn | |
1d5c17c0 | 3614 | ;; "`%s' is not a known condition name (in condition-case)" |
2abcddce RS |
3615 | ;; condition)) |
3616 | ) | |
1c393159 | 3617 | (setq compiled-clauses |
e27c3564 | 3618 | (cons (cons condition |
1c393159 JB |
3619 | (byte-compile-top-level-body |
3620 | (cdr clause) for-effect)) | |
3621 | compiled-clauses))) | |
3622 | (setq clauses (cdr clauses))) | |
3623 | (byte-compile-push-constant (nreverse compiled-clauses))) | |
3624 | (byte-compile-out 'byte-condition-case 0))) | |
3625 | ||
3626 | ||
3627 | (defun byte-compile-save-excursion (form) | |
3628 | (byte-compile-out 'byte-save-excursion 0) | |
3629 | (byte-compile-body-do-effect (cdr form)) | |
3630 | (byte-compile-out 'byte-unbind 1)) | |
3631 | ||
3632 | (defun byte-compile-save-restriction (form) | |
3633 | (byte-compile-out 'byte-save-restriction 0) | |
3634 | (byte-compile-body-do-effect (cdr form)) | |
3635 | (byte-compile-out 'byte-unbind 1)) | |
3636 | ||
f3e472b0 RS |
3637 | (defun byte-compile-save-current-buffer (form) |
3638 | (byte-compile-out 'byte-save-current-buffer 0) | |
3639 | (byte-compile-body-do-effect (cdr form)) | |
3640 | (byte-compile-out 'byte-unbind 1)) | |
3641 | ||
1c393159 JB |
3642 | (defun byte-compile-save-window-excursion (form) |
3643 | (byte-compile-push-constant | |
3644 | (byte-compile-top-level-body (cdr form) for-effect)) | |
3645 | (byte-compile-out 'byte-save-window-excursion 0)) | |
3646 | ||
3647 | (defun byte-compile-with-output-to-temp-buffer (form) | |
3648 | (byte-compile-form (car (cdr form))) | |
3649 | (byte-compile-out 'byte-temp-output-buffer-setup 0) | |
3650 | (byte-compile-body (cdr (cdr form))) | |
3651 | (byte-compile-out 'byte-temp-output-buffer-show 0)) | |
1c393159 JB |
3652 | \f |
3653 | ;;; top-level forms elsewhere | |
3654 | ||
3655 | (byte-defop-compiler-1 defun) | |
3656 | (byte-defop-compiler-1 defmacro) | |
3657 | (byte-defop-compiler-1 defvar) | |
3658 | (byte-defop-compiler-1 defconst byte-compile-defvar) | |
3659 | (byte-defop-compiler-1 autoload) | |
3660 | (byte-defop-compiler-1 lambda byte-compile-lambda-form) | |
3661 | ||
3662 | (defun byte-compile-defun (form) | |
3663 | ;; This is not used for file-level defuns with doc strings. | |
ccb3c8de CW |
3664 | (if (symbolp (car form)) |
3665 | (byte-compile-set-symbol-position (car form)) | |
3666 | (byte-compile-set-symbol-position 'defun) | |
eadd6444 | 3667 | (error "defun name must be a symbol, not %s" (car form))) |
d8c91258 RS |
3668 | (if (byte-compile-version-cond byte-compile-compatibility) |
3669 | (progn | |
3670 | (byte-compile-two-args ; Use this to avoid byte-compile-fset's warning. | |
3671 | (list 'fset | |
3672 | (list 'quote (nth 1 form)) | |
3673 | (byte-compile-byte-code-maker | |
3674 | (byte-compile-lambda (cons 'lambda (cdr (cdr form))))))) | |
3675 | (byte-compile-discard)) | |
a81edd91 RS |
3676 | ;; We prefer to generate a defalias form so it will record the function |
3677 | ;; definition just like interpreting a defun. | |
d8c91258 RS |
3678 | (byte-compile-form |
3679 | (list 'defalias | |
3680 | (list 'quote (nth 1 form)) | |
3681 | (byte-compile-byte-code-maker | |
3682 | (byte-compile-lambda (cons 'lambda (cdr (cdr form)))))) | |
3683 | t)) | |
1c393159 JB |
3684 | (byte-compile-constant (nth 1 form))) |
3685 | ||
3686 | (defun byte-compile-defmacro (form) | |
3687 | ;; This is not used for file-level defmacros with doc strings. | |
3688 | (byte-compile-body-do-effect | |
3689 | (list (list 'fset (list 'quote (nth 1 form)) | |
3690 | (let ((code (byte-compile-byte-code-maker | |
3691 | (byte-compile-lambda | |
3692 | (cons 'lambda (cdr (cdr form))))))) | |
3693 | (if (eq (car-safe code) 'make-byte-code) | |
3694 | (list 'cons ''macro code) | |
3695 | (list 'quote (cons 'macro (eval code)))))) | |
3696 | (list 'quote (nth 1 form))))) | |
3697 | ||
3698 | (defun byte-compile-defvar (form) | |
3699 | ;; This is not used for file-level defvar/consts with doc strings. | |
1bc20d83 GM |
3700 | (let ((fun (nth 0 form)) |
3701 | (var (nth 1 form)) | |
1c393159 JB |
3702 | (value (nth 2 form)) |
3703 | (string (nth 3 form))) | |
ccb3c8de | 3704 | (byte-compile-set-symbol-position fun) |
6c2161c4 SM |
3705 | (when (or (> (length form) 4) |
3706 | (and (eq fun 'defconst) (null (cddr form)))) | |
d0e07261 SM |
3707 | (let ((ncall (length (cdr form)))) |
3708 | (byte-compile-warn | |
1d5c17c0 | 3709 | "`%s' called with %d argument%s, but %s %s" |
d0e07261 SM |
3710 | fun ncall |
3711 | (if (= 1 ncall) "" "s") | |
3712 | (if (< ncall 2) "requires" "accepts only") | |
3713 | "2-3"))) | |
1bc20d83 | 3714 | (when (memq 'free-vars byte-compile-warnings) |
8898f44e | 3715 | (push var byte-compile-bound-variables) |
6c2161c4 SM |
3716 | (if (eq fun 'defconst) |
3717 | (push var byte-compile-const-variables))) | |
1c393159 | 3718 | (byte-compile-body-do-effect |
1bc20d83 GM |
3719 | (list |
3720 | ;; Put the defined variable in this library's load-history entry | |
3721 | ;; just as a real defvar would, but only in top-level forms. | |
3614fc84 | 3722 | (when (and (cddr form) (null byte-compile-current-form)) |
1bc20d83 GM |
3723 | `(push ',var current-load-list)) |
3724 | (when (> (length form) 3) | |
3725 | (when (and string (not (stringp string))) | |
1d5c17c0 | 3726 | (byte-compile-warn "third arg to `%s %s' is not a string: %s" |
1bc20d83 GM |
3727 | fun var string)) |
3728 | `(put ',var 'variable-documentation ,string)) | |
fef3407e | 3729 | (if (cddr form) ; `value' provided |
9e31e67b RS |
3730 | (let ((byte-compile-not-obsolete-var var)) |
3731 | (if (eq fun 'defconst) | |
3732 | ;; `defconst' sets `var' unconditionally. | |
3733 | (let ((tmp (make-symbol "defconst-tmp-var"))) | |
3734 | `(funcall '(lambda (,tmp) (defconst ,var ,tmp)) | |
3735 | ,value)) | |
3736 | ;; `defvar' sets `var' only when unbound. | |
3737 | `(if (not (default-boundp ',var)) (setq-default ,var ,value)))) | |
6c2161c4 SM |
3738 | (when (eq fun 'defconst) |
3739 | ;; This will signal an appropriate error at runtime. | |
3740 | `(eval ',form))) | |
1bc20d83 | 3741 | `',var)))) |
1c393159 JB |
3742 | |
3743 | (defun byte-compile-autoload (form) | |
ccb3c8de | 3744 | (byte-compile-set-symbol-position 'autoload) |
1c393159 JB |
3745 | (and (byte-compile-constp (nth 1 form)) |
3746 | (byte-compile-constp (nth 5 form)) | |
3747 | (eval (nth 5 form)) ; macro-p | |
3748 | (not (fboundp (eval (nth 1 form)))) | |
3749 | (byte-compile-warn | |
c5091f25 | 3750 | "The compiler ignores `autoload' except at top level. You should |
1c393159 JB |
3751 | probably put the autoload of the macro `%s' at top-level." |
3752 | (eval (nth 1 form)))) | |
3753 | (byte-compile-normal-call form)) | |
3754 | ||
c5091f25 | 3755 | ;; Lambdas in valid places are handled as special cases by various code. |
1c393159 JB |
3756 | ;; The ones that remain are errors. |
3757 | (defun byte-compile-lambda-form (form) | |
ccb3c8de | 3758 | (byte-compile-set-symbol-position 'lambda) |
1c393159 JB |
3759 | (error "`lambda' used as function name is invalid")) |
3760 | ||
5286a842 | 3761 | ;; Compile normally, but deal with warnings for the function being defined. |
977b50fb SM |
3762 | (put 'defalias 'byte-hunk-handler 'byte-compile-file-form-defalias) |
3763 | (defun byte-compile-file-form-defalias (form) | |
5286a842 RS |
3764 | (if (and (consp (cdr form)) (consp (nth 1 form)) |
3765 | (eq (car (nth 1 form)) 'quote) | |
3766 | (consp (cdr (nth 1 form))) | |
a7a7ddf1 RS |
3767 | (symbolp (nth 1 (nth 1 form)))) |
3768 | (let ((constant | |
3769 | (and (consp (nthcdr 2 form)) | |
3770 | (consp (nth 2 form)) | |
3771 | (eq (car (nth 2 form)) 'quote) | |
3772 | (consp (cdr (nth 2 form))) | |
3773 | (symbolp (nth 1 (nth 2 form)))))) | |
6c2161c4 | 3774 | (byte-compile-defalias-warn (nth 1 (nth 1 form))) |
977b50fb SM |
3775 | (push (cons (nth 1 (nth 1 form)) |
3776 | (if constant (nth 1 (nth 2 form)) t)) | |
3777 | byte-compile-function-environment))) | |
b3848c28 | 3778 | (byte-compile-normal-call form)) |
5286a842 RS |
3779 | |
3780 | ;; Turn off warnings about prior calls to the function being defalias'd. | |
3781 | ;; This could be smarter and compare those calls with | |
3782 | ;; the function it is being aliased to. | |
6c2161c4 | 3783 | (defun byte-compile-defalias-warn (new) |
5286a842 RS |
3784 | (let ((calls (assq new byte-compile-unresolved-functions))) |
3785 | (if calls | |
3786 | (setq byte-compile-unresolved-functions | |
3787 | (delq calls byte-compile-unresolved-functions))))) | |
3c9dc1cf RS |
3788 | |
3789 | (byte-defop-compiler-1 with-no-warnings byte-compile-no-warnings) | |
3790 | (defun byte-compile-no-warnings (form) | |
3791 | (let (byte-compile-warnings) | |
a4f66531 | 3792 | (byte-compile-form (cons 'progn (cdr form))))) |
01e4a4fa SM |
3793 | |
3794 | ;; Warn about misuses of make-variable-buffer-local. | |
3795 | (byte-defop-compiler-1 make-variable-buffer-local byte-compile-make-variable-buffer-local) | |
3796 | (defun byte-compile-make-variable-buffer-local (form) | |
3797 | (if (eq (car-safe (car-safe (cdr-safe form))) 'quote) | |
3798 | (byte-compile-warn | |
3799 | "`make-variable-buffer-local' should be called at toplevel")) | |
3800 | (byte-compile-normal-call form)) | |
3801 | (put 'make-variable-buffer-local | |
3802 | 'byte-hunk-handler 'byte-compile-form-make-variable-buffer-local) | |
3803 | (defun byte-compile-form-make-variable-buffer-local (form) | |
3804 | (byte-compile-keep-pending form 'byte-compile-normal-call)) | |
3805 | ||
1c393159 JB |
3806 | \f |
3807 | ;;; tags | |
3808 | ||
3809 | ;; Note: Most operations will strip off the 'TAG, but it speeds up | |
3810 | ;; optimization to have the 'TAG as a part of the tag. | |
3811 | ;; Tags will be (TAG . (tag-number . stack-depth)). | |
3812 | (defun byte-compile-make-tag () | |
3813 | (list 'TAG (setq byte-compile-tag-number (1+ byte-compile-tag-number)))) | |
3814 | ||
3815 | ||
3816 | (defun byte-compile-out-tag (tag) | |
3817 | (setq byte-compile-output (cons tag byte-compile-output)) | |
3818 | (if (cdr (cdr tag)) | |
3819 | (progn | |
3820 | ;; ## remove this someday | |
3821 | (and byte-compile-depth | |
3822 | (not (= (cdr (cdr tag)) byte-compile-depth)) | |
52799cb8 | 3823 | (error "Compiler bug: depth conflict at tag %d" (car (cdr tag)))) |
1c393159 JB |
3824 | (setq byte-compile-depth (cdr (cdr tag)))) |
3825 | (setcdr (cdr tag) byte-compile-depth))) | |
3826 | ||
3827 | (defun byte-compile-goto (opcode tag) | |
6c2161c4 | 3828 | (push (cons opcode tag) byte-compile-output) |
1c393159 JB |
3829 | (setcdr (cdr tag) (if (memq opcode byte-goto-always-pop-ops) |
3830 | (1- byte-compile-depth) | |
3831 | byte-compile-depth)) | |
3832 | (setq byte-compile-depth (and (not (eq opcode 'byte-goto)) | |
3833 | (1- byte-compile-depth)))) | |
3834 | ||
3835 | (defun byte-compile-out (opcode offset) | |
6c2161c4 | 3836 | (push (cons opcode offset) byte-compile-output) |
1c393159 JB |
3837 | (cond ((eq opcode 'byte-call) |
3838 | (setq byte-compile-depth (- byte-compile-depth offset))) | |
3839 | ((eq opcode 'byte-return) | |
3840 | ;; This is actually an unnecessary case, because there should be | |
3841 | ;; no more opcodes behind byte-return. | |
3842 | (setq byte-compile-depth nil)) | |
3843 | (t | |
3844 | (setq byte-compile-depth (+ byte-compile-depth | |
3845 | (or (aref byte-stack+-info | |
3846 | (symbol-value opcode)) | |
3847 | (- (1- offset)))) | |
3848 | byte-compile-maxdepth (max byte-compile-depth | |
3849 | byte-compile-maxdepth)))) | |
52799cb8 | 3850 | ;;(if (< byte-compile-depth 0) (error "Compiler error: stack underflow")) |
1c393159 JB |
3851 | ) |
3852 | ||
3853 | \f | |
3854 | ;;; call tree stuff | |
3855 | ||
3856 | (defun byte-compile-annotate-call-tree (form) | |
3857 | (let (entry) | |
3858 | ;; annotate the current call | |
3859 | (if (setq entry (assq (car form) byte-compile-call-tree)) | |
3860 | (or (memq byte-compile-current-form (nth 1 entry)) ;callers | |
3861 | (setcar (cdr entry) | |
3862 | (cons byte-compile-current-form (nth 1 entry)))) | |
3863 | (setq byte-compile-call-tree | |
3864 | (cons (list (car form) (list byte-compile-current-form) nil) | |
3865 | byte-compile-call-tree))) | |
3866 | ;; annotate the current function | |
3867 | (if (setq entry (assq byte-compile-current-form byte-compile-call-tree)) | |
3868 | (or (memq (car form) (nth 2 entry)) ;called | |
3869 | (setcar (cdr (cdr entry)) | |
3870 | (cons (car form) (nth 2 entry)))) | |
3871 | (setq byte-compile-call-tree | |
3872 | (cons (list byte-compile-current-form nil (list (car form))) | |
3873 | byte-compile-call-tree))) | |
3874 | )) | |
3875 | ||
52799cb8 RS |
3876 | ;; Renamed from byte-compile-report-call-tree |
3877 | ;; to avoid interfering with completion of byte-compile-file. | |
fd5285f3 | 3878 | ;;;###autoload |
52799cb8 RS |
3879 | (defun display-call-tree (&optional filename) |
3880 | "Display a call graph of a specified file. | |
3881 | This lists which functions have been called, what functions called | |
3882 | them, and what functions they call. The list includes all functions | |
3883 | whose definitions have been compiled in this Emacs session, as well as | |
3884 | all functions called by those functions. | |
1c393159 | 3885 | |
52799cb8 RS |
3886 | The call graph does not include macros, inline functions, or |
3887 | primitives that the byte-code interpreter knows about directly \(eq, | |
3888 | cons, etc.\). | |
1c393159 JB |
3889 | |
3890 | The call tree also lists those functions which are not known to be called | |
52799cb8 RS |
3891 | \(that is, to which no calls have been compiled\), and which cannot be |
3892 | invoked interactively." | |
1c393159 JB |
3893 | (interactive) |
3894 | (message "Generating call tree...") | |
3895 | (with-output-to-temp-buffer "*Call-Tree*" | |
3896 | (set-buffer "*Call-Tree*") | |
3897 | (erase-buffer) | |
47cf9d3a | 3898 | (message "Generating call tree... (sorting on %s)" |
1c393159 JB |
3899 | byte-compile-call-tree-sort) |
3900 | (insert "Call tree for " | |
3901 | (cond ((null byte-compile-current-file) (or filename "???")) | |
3902 | ((stringp byte-compile-current-file) | |
3903 | byte-compile-current-file) | |
3904 | (t (buffer-name byte-compile-current-file))) | |
3905 | " sorted on " | |
3906 | (prin1-to-string byte-compile-call-tree-sort) | |
3907 | ":\n\n") | |
3908 | (if byte-compile-call-tree-sort | |
3909 | (setq byte-compile-call-tree | |
3910 | (sort byte-compile-call-tree | |
3911 | (cond ((eq byte-compile-call-tree-sort 'callers) | |
3912 | (function (lambda (x y) (< (length (nth 1 x)) | |
3913 | (length (nth 1 y)))))) | |
3914 | ((eq byte-compile-call-tree-sort 'calls) | |
3915 | (function (lambda (x y) (< (length (nth 2 x)) | |
3916 | (length (nth 2 y)))))) | |
3917 | ((eq byte-compile-call-tree-sort 'calls+callers) | |
3918 | (function (lambda (x y) (< (+ (length (nth 1 x)) | |
3919 | (length (nth 2 x))) | |
3920 | (+ (length (nth 1 y)) | |
3921 | (length (nth 2 y))))))) | |
3922 | ((eq byte-compile-call-tree-sort 'name) | |
3923 | (function (lambda (x y) (string< (car x) | |
3924 | (car y))))) | |
52799cb8 | 3925 | (t (error "`byte-compile-call-tree-sort': `%s' - unknown sort mode" |
1c393159 JB |
3926 | byte-compile-call-tree-sort)))))) |
3927 | (message "Generating call tree...") | |
3928 | (let ((rest byte-compile-call-tree) | |
3929 | (b (current-buffer)) | |
3930 | f p | |
3931 | callers calls) | |
3932 | (while rest | |
3933 | (prin1 (car (car rest)) b) | |
3934 | (setq callers (nth 1 (car rest)) | |
3935 | calls (nth 2 (car rest))) | |
3936 | (insert "\t" | |
3937 | (cond ((not (fboundp (setq f (car (car rest))))) | |
3938 | (if (null f) | |
3939 | " <top level>";; shouldn't insert nil then, actually -sk | |
3940 | " <not defined>")) | |
3941 | ((subrp (setq f (symbol-function f))) | |
3942 | " <subr>") | |
3943 | ((symbolp f) | |
3944 | (format " ==> %s" f)) | |
ed015bdd | 3945 | ((byte-code-function-p f) |
1c393159 JB |
3946 | "<compiled function>") |
3947 | ((not (consp f)) | |
3948 | "<malformed function>") | |
3949 | ((eq 'macro (car f)) | |
ed015bdd | 3950 | (if (or (byte-code-function-p (cdr f)) |
1c393159 JB |
3951 | (assq 'byte-code (cdr (cdr (cdr f))))) |
3952 | " <compiled macro>" | |
3953 | " <macro>")) | |
3954 | ((assq 'byte-code (cdr (cdr f))) | |
3955 | "<compiled lambda>") | |
3956 | ((eq 'lambda (car f)) | |
3957 | "<function>") | |
3958 | (t "???")) | |
3959 | (format " (%d callers + %d calls = %d)" | |
3960 | ;; Does the optimizer eliminate common subexpressions?-sk | |
3961 | (length callers) | |
3962 | (length calls) | |
3963 | (+ (length callers) (length calls))) | |
3964 | "\n") | |
3965 | (if callers | |
3966 | (progn | |
3967 | (insert " called by:\n") | |
3968 | (setq p (point)) | |
3969 | (insert " " (if (car callers) | |
3970 | (mapconcat 'symbol-name callers ", ") | |
3971 | "<top level>")) | |
3972 | (let ((fill-prefix " ")) | |
78bba1c8 TTN |
3973 | (fill-region-as-paragraph p (point))) |
3974 | (unless (= 0 (current-column)) | |
3975 | (insert "\n")))) | |
1c393159 JB |
3976 | (if calls |
3977 | (progn | |
3978 | (insert " calls:\n") | |
3979 | (setq p (point)) | |
3980 | (insert " " (mapconcat 'symbol-name calls ", ")) | |
3981 | (let ((fill-prefix " ")) | |
78bba1c8 TTN |
3982 | (fill-region-as-paragraph p (point))) |
3983 | (unless (= 0 (current-column)) | |
3984 | (insert "\n")))) | |
1c393159 JB |
3985 | (setq rest (cdr rest))) |
3986 | ||
3987 | (message "Generating call tree...(finding uncalled functions...)") | |
3988 | (setq rest byte-compile-call-tree) | |
3989 | (let ((uncalled nil)) | |
3990 | (while rest | |
3991 | (or (nth 1 (car rest)) | |
3992 | (null (setq f (car (car rest)))) | |
a7a7ddf1 | 3993 | (functionp (byte-compile-fdefinition f t)) |
1c393159 JB |
3994 | (commandp (byte-compile-fdefinition f nil)) |
3995 | (setq uncalled (cons f uncalled))) | |
3996 | (setq rest (cdr rest))) | |
3997 | (if uncalled | |
3998 | (let ((fill-prefix " ")) | |
3999 | (insert "Noninteractive functions not known to be called:\n ") | |
4000 | (setq p (point)) | |
4001 | (insert (mapconcat 'symbol-name (nreverse uncalled) ", ")) | |
4002 | (fill-region-as-paragraph p (point))))) | |
4003 | ) | |
4004 | (message "Generating call tree...done.") | |
4005 | )) | |
4006 | ||
4007 | \f | |
814c447f | 4008 | ;;;###autoload |
7e7d0f8b RS |
4009 | (defun batch-byte-compile-if-not-done () |
4010 | "Like `byte-compile-file' but doesn't recompile if already up to date. | |
4011 | Use this from the command line, with `-batch'; | |
4012 | it won't work in an interactive Emacs." | |
4013 | (batch-byte-compile t)) | |
4014 | ||
1c393159 JB |
4015 | ;;; by crl@newton.purdue.edu |
4016 | ;;; Only works noninteractively. | |
fd5285f3 | 4017 | ;;;###autoload |
7e7d0f8b | 4018 | (defun batch-byte-compile (&optional noforce) |
52799cb8 RS |
4019 | "Run `byte-compile-file' on the files remaining on the command line. |
4020 | Use this from the command line, with `-batch'; | |
4021 | it won't work in an interactive Emacs. | |
4022 | Each file is processed even if an error occurred previously. | |
7e7d0f8b RS |
4023 | For example, invoke \"emacs -batch -f batch-byte-compile $emacs/ ~/*.el\". |
4024 | If NOFORCE is non-nil, don't recompile a file that seems to be | |
4025 | already up-to-date." | |
1c393159 JB |
4026 | ;; command-line-args-left is what is left of the command line (from startup.el) |
4027 | (defvar command-line-args-left) ;Avoid 'free variable' warning | |
4028 | (if (not noninteractive) | |
52799cb8 | 4029 | (error "`batch-byte-compile' is to be used only with -batch")) |
1c393159 JB |
4030 | (let ((error nil)) |
4031 | (while command-line-args-left | |
4032 | (if (file-directory-p (expand-file-name (car command-line-args-left))) | |
7e7d0f8b | 4033 | ;; Directory as argument. |
1c393159 JB |
4034 | (let ((files (directory-files (car command-line-args-left))) |
4035 | source dest) | |
d90a41e8 SS |
4036 | (dolist (file files) |
4037 | (if (and (string-match emacs-lisp-file-regexp file) | |
4038 | (not (auto-save-file-name-p file)) | |
4039 | (setq source (expand-file-name file | |
1c393159 JB |
4040 | (car command-line-args-left))) |
4041 | (setq dest (byte-compile-dest-file source)) | |
4042 | (file-exists-p dest) | |
4043 | (file-newer-than-file-p source dest)) | |
4044 | (if (null (batch-byte-compile-file source)) | |
d90a41e8 | 4045 | (setq error t))))) |
7e7d0f8b RS |
4046 | ;; Specific file argument |
4047 | (if (or (not noforce) | |
4048 | (let* ((source (car command-line-args-left)) | |
4049 | (dest (byte-compile-dest-file source))) | |
4050 | (or (not (file-exists-p dest)) | |
4051 | (file-newer-than-file-p source dest)))) | |
4052 | (if (null (batch-byte-compile-file (car command-line-args-left))) | |
4053 | (setq error t)))) | |
1c393159 | 4054 | (setq command-line-args-left (cdr command-line-args-left))) |
1c393159 JB |
4055 | (kill-emacs (if error 1 0)))) |
4056 | ||
4057 | (defun batch-byte-compile-file (file) | |
a080ff23 | 4058 | (if debug-on-error |
1c57117e | 4059 | (byte-compile-file file) |
a080ff23 SM |
4060 | (condition-case err |
4061 | (byte-compile-file file) | |
4062 | (file-error | |
4063 | (message (if (cdr err) | |
4064 | ">>Error occurred processing %s: %s (%s)" | |
d09b1c02 | 4065 | ">>Error occurred processing %s: %s") |
a080ff23 SM |
4066 | file |
4067 | (get (car err) 'error-message) | |
4068 | (prin1-to-string (cdr err))) | |
4069 | (let ((destfile (byte-compile-dest-file file))) | |
4070 | (if (file-exists-p destfile) | |
4071 | (delete-file destfile))) | |
4072 | nil) | |
4073 | (error | |
4074 | (message (if (cdr err) | |
4075 | ">>Error occurred processing %s: %s (%s)" | |
1c393159 | 4076 | ">>Error occurred processing %s: %s") |
a080ff23 SM |
4077 | file |
4078 | (get (car err) 'error-message) | |
4079 | (prin1-to-string (cdr err))) | |
4080 | nil)))) | |
1c393159 | 4081 | |
e9681c45 | 4082 | ;;;###autoload |
6f8e3590 | 4083 | (defun batch-byte-recompile-directory (&optional arg) |
4f6d5bf0 | 4084 | "Run `byte-recompile-directory' on the dirs remaining on the command line. |
79c6071d RS |
4085 | Must be used only with `-batch', and kills Emacs on completion. |
4086 | For example, invoke `emacs -batch -f batch-byte-recompile-directory .'." | |
e27c3564 JB |
4087 | ;; command-line-args-left is what is left of the command line (startup.el) |
4088 | (defvar command-line-args-left) ;Avoid 'free variable' warning | |
4089 | (if (not noninteractive) | |
4090 | (error "batch-byte-recompile-directory is to be used only with -batch")) | |
4091 | (or command-line-args-left | |
4092 | (setq command-line-args-left '("."))) | |
4093 | (while command-line-args-left | |
6f8e3590 | 4094 | (byte-recompile-directory (car command-line-args-left) arg) |
e27c3564 JB |
4095 | (setq command-line-args-left (cdr command-line-args-left))) |
4096 | (kill-emacs 0)) | |
4097 | ||
1c393159 | 4098 | (provide 'byte-compile) |
200503bb | 4099 | (provide 'bytecomp) |
1c393159 JB |
4100 | |
4101 | \f | |
4102 | ;;; report metering (see the hacks in bytecode.c) | |
4103 | ||
08d21785 | 4104 | (defvar byte-code-meter) |
52799cb8 | 4105 | (defun byte-compile-report-ops () |
52799cb8 RS |
4106 | (with-output-to-temp-buffer "*Meter*" |
4107 | (set-buffer "*Meter*") | |
4108 | (let ((i 0) n op off) | |
4109 | (while (< i 256) | |
4110 | (setq n (aref (aref byte-code-meter 0) i) | |
4111 | off nil) | |
4112 | (if t ;(not (zerop n)) | |
4113 | (progn | |
4114 | (setq op i) | |
4115 | (setq off nil) | |
4116 | (cond ((< op byte-nth) | |
4117 | (setq off (logand op 7)) | |
4118 | (setq op (logand op 248))) | |
4119 | ((>= op byte-constant) | |
4120 | (setq off (- op byte-constant) | |
4121 | op byte-constant))) | |
4122 | (setq op (aref byte-code-vector op)) | |
4123 | (insert (format "%-4d" i)) | |
4124 | (insert (symbol-name op)) | |
4125 | (if off (insert " [" (int-to-string off) "]")) | |
4126 | (indent-to 40) | |
4127 | (insert (int-to-string n) "\n"))) | |
4128 | (setq i (1+ i)))))) | |
1c393159 JB |
4129 | \f |
4130 | ;; To avoid "lisp nesting exceeds max-lisp-eval-depth" when bytecomp compiles | |
4131 | ;; itself, compile some of its most used recursive functions (at load time). | |
4132 | ;; | |
4133 | (eval-when-compile | |
591655c7 SM |
4134 | (or (byte-code-function-p (symbol-function 'byte-compile-form)) |
4135 | (assq 'byte-code (symbol-function 'byte-compile-form)) | |
4136 | (let ((byte-optimize nil) ; do it fast | |
4137 | (byte-compile-warnings nil)) | |
d686d354 SM |
4138 | (mapcar (lambda (x) |
4139 | (or noninteractive (message "compiling %s..." x)) | |
4140 | (byte-compile x) | |
4141 | (or noninteractive (message "compiling %s...done" x))) | |
591655c7 SM |
4142 | '(byte-compile-normal-call |
4143 | byte-compile-form | |
4144 | byte-compile-body | |
4145 | ;; Inserted some more than necessary, to speed it up. | |
4146 | byte-compile-top-level | |
4147 | byte-compile-out-toplevel | |
4148 | byte-compile-constant | |
4149 | byte-compile-variable-ref)))) | |
4150 | nil) | |
fd5285f3 | 4151 | |
3433c43f DL |
4152 | (run-hooks 'bytecomp-load-hook) |
4153 | ||
977b50fb | 4154 | ;; arch-tag: 9c97b0f0-8745-4571-bfc3-8dceb677292a |
fd5285f3 | 4155 | ;;; bytecomp.el ends here |