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