File: bytecomp.el.html

The Emacs Lisp byte compiler. This crunches Lisp source into a sort of p-code (lapcode) which takes up less space and can be interpreted faster. [LAP == Lisp Assembly Program.] The user entry points are byte-compile-file and byte-recompile-directory.

Defined variables (89)

byte+native-compileNon-nil while producing at the same time byte and native code.
byte-callByte code opcode for calling a function.
byte-catch-OBSOLETEByte code opcode for catch. Takes, on stack, the tag and an expression for
byte-code-vectorAn array containing byte-code names indexed by byte-code values.
byte-compile--docstringsTable of already compiled docstrings.
byte-compile--emacs-build-warning-typesList of warning types that are only enabled during Emacs builds.
byte-compile--known-dynamic-varsVariables known to be declared as dynamic, for warning purposes.
byte-compile--lexical-environmentThe current lexical environment.
byte-compile--seen-defvarsAll dynamic variable declarations seen so far.
byte-compile--suppressed-warningsDynamically bound by ‘with-suppressed-warnings’ to suppress warnings.
byte-compile-bound-variablesList of dynamic variables bound in the context of the current form.
byte-compile-call-treeAlist of functions and their call tree.
byte-compile-call-tree-sortIf non-nil, sort the call tree.
byte-compile-cond-use-jump-tableCompile ‘cond’ clauses to a jump table implementation (using a hash-table).
byte-compile-const-variablesList of variables declared as constants during compilation of this file.
byte-compile-constantsList of all constants encountered during compilation of this form.
byte-compile-debugIf non-nil, byte compile errors will be raised as signals instead of logged.
byte-compile-delete-errorsIf non-nil, the optimizer may delete forms that may signal an error.
byte-compile-depthCurrent depth of execution stack.
byte-compile-dest-file-functionFunction for the function ‘byte-compile-dest-file’ to call.
byte-compile-docstring-max-columnRecommended maximum width of doc string lines.
byte-compile-dynamicFormerly used to compile function bodies so they load lazily.
byte-compile-dynamic-docstringsIf non-nil, compile doc strings for lazy access.
byte-compile-error-on-warnIf true, the byte-compiler reports warnings with ‘error’.
byte-compile-function-environmentAlist of functions defined in the file being compiled.
byte-compile-generate-call-treeNon-nil means collect call-graph information when compiling.
byte-compile-global-not-obsolete-varsGlobal list of variables that shouldn’t be reported as obsolete.
byte-compile-ignore-filesList of regexps for files to ignore during byte compilation.
byte-compile-initial-macro-environmentThe default macro-environment passed to macroexpand by the compiler.
byte-compile-interactive-only-functionsList of commands that are not meant to be called from Lisp.
byte-compile-jump-tablesList of all jump tables used during compilation of this form.
byte-compile-levelDepth of a recursive byte compilation.
byte-compile-lexical-variablesList of variables that have been treated as lexical.
byte-compile-log-bufferName of the byte-compiler’s log buffer.
byte-compile-log-warning-functionFunction called when encountering a warning or error.
byte-compile-macro-environmentAlist of macros defined in the file being compiled.
byte-compile-maxdepthMaximum depth of execution stack.
byte-compile-new-defunsList of (runtime) functions defined in this compilation run.
byte-compile-noruntime-functionsAlist of functions called that may not be defined when the compiled code is run.
byte-compile-not-obsolete-funcsList of functions that shouldn’t be reported as obsolete.
byte-compile-not-obsolete-varsList of variables that shouldn’t be reported as obsolete.
byte-compile-outputAlist describing contents to put in byte code string.
byte-compile-root-dirDirectory relative to which file names in error messages are written.
byte-compile-unresolved-functionsAlist of undefined functions to which calls have been compiled.
byte-compile-variablesList of all variables encountered during compilation of this form.
byte-compile-verboseNon-nil means print messages describing progress of byte-compiler.
byte-compile-warning-typesThe list of warning types used when ‘byte-compile-warnings’ is t.
byte-compile-warningsList of warnings that the byte-compiler should issue (t for almost all).
byte-constantByte code opcode for reference to a constant.
byte-constant-limitExclusive maximum index usable in the ‘byte-constant’ opcode.
byte-constant2Byte code opcode for reference to a constant with vector
byte-discardByte code opcode to discard one value from stack.
byte-dupByte code opcode to duplicate the top of the stack.
byte-gotoByte code opcode for unconditional jump.
byte-goto-if-nilByte code opcode to pop value and jump if it’s nil.
byte-goto-if-nil-else-popByte code opcode to examine top-of-stack, jump and don’t pop it if it’s nil,
byte-goto-if-not-nilByte code opcode to pop value and jump if it’s not nil.
byte-goto-if-not-nil-else-popByte code opcode to examine top-of-stack, jump and don’t pop it if it’s non nil,
byte-goto-opsList of byte-codes whose offset is a pc.
byte-native-compilingNon-nil while native compiling.
byte-native-qualitiesTo spill default qualities from the compiled file.
byte-optimizeEnable optimization in the byte compiler.
byte-optimize-logIf non-nil, the byte-compiler will log its optimizations.
byte-returnByte code opcode to pop a value and return it from ‘byte-code’.
byte-save-current-bufferByte code opcode to make a binding to record the current buffer.
byte-save-excursionByte code opcode to make a binding to record the buffer, point and mark.
byte-save-restrictionByte code opcode to make a binding to record the current buffer clipping
byte-save-window-excursion-OBSOLETEByte code opcode to make a binding to record entire window configuration.
byte-stack+-infoAn array with the stack adjustment for each byte-code.
byte-stack-refByte code opcode for stack reference.
byte-switchByte code opcode to take a hash table and a value from the stack, and jump to
byte-to-native-lambdas-hHash byte-code -> byte-to-native-lambda.
byte-to-native-output-buffer-filePair holding byte-compilation output buffer, elc filename.
byte-to-native-plist-environmentTo spill ‘overriding-plist-environment’.
byte-to-native-top-level-formsList of top level forms.
byte-unbindByte code opcode for unbinding special bindings.
byte-unwind-protectByte code opcode for unwind-protect. Takes, on stack, an expression for
byte-varbindByte code opcode for binding a variable.
byte-varrefByte code opcode for variable reference.
byte-varsetByte code opcode for setting a variable.
compilation-safetySafety level for generated compiled code.
emacs-lisp-compilation-mode-abbrev-tableAbbrev table for ‘emacs-lisp-compilation-mode’.
emacs-lisp-compilation-mode-hookHook run after entering ‘emacs-lisp-compilation-mode’.
emacs-lisp-compilation-mode-mapKeymap for ‘emacs-lisp-compilation-mode’.
emacs-lisp-compilation-mode-syntax-tableSyntax table for ‘emacs-lisp-compilation-mode’.
emacs-lisp-compilation-parse-errors-filename-functionThe value for ‘compilation-parse-errors-filename-function’ for when
emacs-lisp-compilation-search-pathDirectories to search for files named in byte-compile error messages.
emacs-lisp-file-regexpRegexp which matches Emacs Lisp source files.
no-byte-compileNon-nil to prevent byte-compiling of Emacs Lisp code.

Defined functions (236)

batch-byte-compile(&optional NOFORCE)
batch-byte-compile-file(FILE)
batch-byte-compile-if-not-done()
batch-byte-recompile-directory(&optional ARG)
byte-compile(FORM)
byte-compile--check-arity-bytecode(FORM BYTECODE)
byte-compile--check-prefixed-var(SYM)
byte-compile--common-test(TEST-1 TEST-2)
byte-compile--cond-switch-prefix(CLAUSES)
byte-compile--cond-vars(OBJ1 OBJ2)
byte-compile--custom-declare-face(FORM)
byte-compile--declare-var(SYM &optional NOT-TOPLEVEL)
byte-compile--default-dest-file(FILENAME)
byte-compile--docstring(DOC KIND NAME &optional IS-A-VALUE)
byte-compile--docstring-style-warn(DOCS KIND NAME)
byte-compile--first-symbol-with-pos(FORM)
byte-compile--function-signature(F)
byte-compile--list-with-n(LIST N ELEM)
byte-compile--load-dynvars(FILE)
byte-compile--log-warning-for-byte-compile(STRING POSITION &optional FILL LEVEL)
byte-compile--reify-function(FUN)
byte-compile--warn-lexical-dynamic(VAR CONTEXT)
byte-compile--warning-source-offset()
byte-compile--wide-docstring-p(DOCSTRING MAX-WIDTH)
byte-compile-abbreviate-file(FILE &optional DIR)
byte-compile-and(FORM)
byte-compile-and-recursion(REST FAILTAG)
byte-compile-annotate-call-tree(FORM)
byte-compile-arglist-signature(ARGLIST)
byte-compile-arglist-signature-string(SIGNATURE)
byte-compile-arglist-signatures-congruent-p(OLD NEW)
byte-compile-arglist-vars(ARGLIST)
byte-compile-arglist-warn(NAME ARGLIST MACROP)
byte-compile-autoload(FORM)
byte-compile-bind(VAR INIT-LEXENV)
byte-compile-body(BODY &optional FOR-EFFECT)
byte-compile-body-do-effect(BODY)
byte-compile-callargs-warn(FORM)
byte-compile-catch(FORM)
byte-compile-check-lambda-list(LIST)
byte-compile-check-variable(VAR ACCESS-TYPE)
byte-compile-close-variables(&rest BODY)
byte-compile-cmp(FORM)
byte-compile-concat(FORM)
byte-compile-cond(CLAUSES)
byte-compile-cond-jump-table(SWITCH DONETAG)
byte-compile-condition-case(FORM)
byte-compile-constant(CONST)
byte-compile-define-symbol-prop(FORM)
byte-compile-defvar(FORM &optional TOPLEVEL)
byte-compile-dest-file(FILENAME)
byte-compile-disable-warning(WARNING)
byte-compile-discard(&optional NUM PRESERVE-TOS)
byte-compile-dynamic-variable-bind(VAR)
byte-compile-dynamic-variable-op(BASE-OP VAR)
byte-compile-emit-callargs-warn(NAME ACTUAL-ARGS MIN-ARGS MAX-ARGS)
byte-compile-enable-warning(WARNING)
byte-compile-eval(FORM)
byte-compile-eval-before-compile(FORM)
byte-compile-fdefinition(NAME MACRO-P)
byte-compile-file(FILENAME)
byte-compile-file-form(FORM)
byte-compile-file-form-autoload(FORM)
byte-compile-file-form-defalias(FORM)
byte-compile-file-form-defmumble(NAME MACRO ARGLIST BODY REST)
byte-compile-file-form-defvar(FORM)
byte-compile-file-form-defvar-function(FORM)
byte-compile-file-form-make-obsolete(FORM)
byte-compile-file-form-progn(FORM)
byte-compile-file-form-require(FORM)
byte-compile-file-form-with-no-warnings(FORM)
byte-compile-file-form-with-suppressed-warnings(FORM)
byte-compile-find-bound-condition(CONDITION-PARAM PRED-LIST &optional ONLY-IF-NOT-PRESENT)
byte-compile-form(FORM &optional FOR-EFFECT)
byte-compile-form-do-effect(FORM)
byte-compile-form-make-variable-buffer-local(FORM)
byte-compile-format-warn(FORM)
byte-compile-free-vars-warn(ARG VAR &optional ASSIGNMENT)
byte-compile-from-buffer(INBUFFER)
byte-compile-funcall(FORM)
byte-compile-function-form(FORM)
byte-compile-function-warn(F NARGS DEF)
byte-compile-get-closed-var(FORM)
byte-compile-get-constant(CONST)
byte-compile-goto(OPCODE TAG)
byte-compile-goto-if(COND DISCARD TAG)
byte-compile-if(FORM)
byte-compile-ignore(FORM)
byte-compile-indent-to(FORM)
byte-compile-inline-lapcode(LAP END-DEPTH)
byte-compile-insert(FORM)
byte-compile-insert-header(FILENAME OUTBUFFER)
byte-compile-keep-pending(FORM &optional HANDLER)
byte-compile-lambda(FUN &optional RESERVED-CSTS)
byte-compile-lambda-form(FORM)
byte-compile-lapcode(LAP)
byte-compile-let(FORM)
byte-compile-list(FORM)
byte-compile-log(FORMAT-STRING &rest ARGS)
byte-compile-log-1(STRING)
byte-compile-log-warning(STRING &optional FILL LEVEL)
byte-compile-macroexpand-declare-function(FN FILE &optional ARGLIST FILEONLY)
byte-compile-make-args-desc(ARGLIST)
byte-compile-make-closure(FORM)
byte-compile-make-lambda-lexenv(ARGS)
byte-compile-make-local-variable(FORM)
byte-compile-make-obsolete-variable(FORM)
byte-compile-make-variable-buffer-local(FORM)
byte-compile-maybe-guarded(CONDITION &rest BODY)
byte-compile-min-max(FORM)
byte-compile-minus(FORM)
byte-compile-nconc(FORM)
byte-compile-negated(FORM)
byte-compile-negation-optimizer(FORM)
byte-compile-no-args(FORM)
byte-compile-no-warnings(FORM)
byte-compile-noop(FORM)
byte-compile-normal-call(FORM)
byte-compile-one-arg(FORM)
byte-compile-one-or-two-args(FORM)
byte-compile-one-to-three-args(FORM)
byte-compile-or(FORM)
byte-compile-or-recursion(REST WINTAG)
byte-compile-out(OP &optional OPERAND)
byte-compile-out-tag(TAG)
byte-compile-out-toplevel(&optional FOR-EFFECT OUTPUT-TYPE)
byte-compile-output-as-comment(EXP QUOTED)
byte-compile-output-file-form(FORM)
byte-compile-preprocess(FORM &optional FOR-EFFECT)
byte-compile-prog1(FORM)
byte-compile-progn(FORM)
byte-compile-push-binding-init(CLAUSE)
byte-compile-push-bytecode-const2(OPCODE CONST2 BYTES PC)
byte-compile-push-bytecodes(BYTE1 BYTE2 ... BYTEn BVAR CVAR)
byte-compile-push-constant(CONST)
byte-compile-quo(FORM)
byte-compile-quote(FORM)
byte-compile-recurse-toplevel(FORM NON-TOPLEVEL-CASE)
byte-compile-refresh-preloaded()
byte-compile-report-error(ERROR-INFO &optional FILL)
byte-compile-save-current-buffer(FORM)
byte-compile-save-excursion(FORM)
byte-compile-save-restriction(FORM)
byte-compile-set-default(FORM)
byte-compile-setq(FORM)
byte-compile-sexp(SEXP)
byte-compile-stack-adjustment(OP OPERAND)
byte-compile-stack-ref(STACK-POS)
byte-compile-stack-set(STACK-POS)
byte-compile-subr-wrong-args(FORM N)
byte-compile-suppressed-warnings(FORM)
byte-compile-three-args(FORM)
byte-compile-top-level(FORM &optional FOR-EFFECT OUTPUT-TYPE LEXENV RESERVED-CSTS)
byte-compile-top-level-body(BODY &optional FOR-EFFECT)
byte-compile-toplevel-file-form(TOP-LEVEL-FORM)
byte-compile-two-args(FORM)
byte-compile-two-or-three-args(FORM)
byte-compile-unbind(CLAUSES INIT-LEXENV PRESERVE-BODY-VALUE)
byte-compile-unfold-bcf(FORM)
byte-compile-unwind-protect(FORM)
byte-compile-variable-ref(VAR)
byte-compile-variable-set(VAR)
byte-compile-variadic-numeric(FORM)
byte-compile-warn(FORMAT &rest ARGS)
byte-compile-warn-obsolete(SYMBOL TYPE)
byte-compile-warn-x(ARG FORMAT &rest ARGS)
byte-compile-warning-enabled-p(WARNING &optional SYMBOL)
byte-compile-warning-prefix(LEVEL ENTRY)
byte-compile-warning-series(&rest IGNORE)
byte-compile-while(FORM)
byte-compile-zero-or-one-arg(FORM)
byte-compiler-base-file-name(FILENAME)
byte-defop(OPCODE STACK-ADJUST OPNAME &optional DOCSTRING)
byte-defop-compiler(FUNCTION &optional COMPILE-HANDLER)
byte-defop-compiler-1(FUNCTION &optional COMPILE-HANDLER)
byte-force-recompile(DIRECTORY)
byte-recompile-directory(DIRECTORY &optional ARG FORCE FOLLOW-SYMLINKS)
byte-recompile-file(FILENAME &optional FORCE ARG)
byte-to-native-func-def-byte-func(CL-X)
byte-to-native-func-def-byte-func--cmacro(CL-WHOLE-ARG CL-X)
byte-to-native-func-def-c-name(CL-X)
byte-to-native-func-def-c-name--cmacro(CL-WHOLE-ARG CL-X)
byte-to-native-func-def-name(CL-X)
byte-to-native-func-def-name--cmacro(CL-WHOLE-ARG CL-X)
byte-to-native-func-def-p(CL-X)
byte-to-native-func-def-p--cmacro(CL-WHOLE-ARG CL-X)
byte-to-native-lambda-byte-func(CL-X)
byte-to-native-lambda-byte-func--cmacro(CL-WHOLE-ARG CL-X)
byte-to-native-lambda-lap(CL-X)
byte-to-native-lambda-lap--cmacro(CL-WHOLE-ARG CL-X)
byte-to-native-lambda-p(CL-X)
byte-to-native-lambda-p--cmacro(CL-WHOLE-ARG CL-X)
byte-to-native-top-level-form(CL-X)
byte-to-native-top-level-form--cmacro(CL-WHOLE-ARG CL-X)
byte-to-native-top-level-lexical(CL-X)
byte-to-native-top-level-lexical--cmacro(CL-WHOLE-ARG CL-X)
byte-to-native-top-level-p(CL-X)
byte-to-native-top-level-p--cmacro(CL-WHOLE-ARG CL-X)
byte-write-target-file(BUFFER TARGET-FILE)
bytecomp--actually-important-return-value-p(FORM)
bytecomp--arg-type-description(X)
bytecomp--backward-char(FORM &optional ARG &rest JUNK-ARGS)
bytecomp--backward-word(FORM &optional ARG &rest JUNK-ARGS)
bytecomp--char-before(FORM &optional ARG &rest JUNK-ARGS)
bytecomp--check-cus-type(TYPE)
bytecomp--check-eq-args(FORM &optional A B &rest IGNORE)
bytecomp--check-keyword-args(FORM ARGLIST ALLOWED-KEYS REQUIRED-KEYS)
bytecomp--check-memq-args(FORM &optional ELEM LIST &rest IGNORE)
bytecomp--copy-tree(TREE)
bytecomp--copy-tree-1(TREE)
bytecomp--cus-warn(FORM FORMAT &rest ARGS)
bytecomp--custom-declare(FORM)
bytecomp--displaying-warnings(BODY-FN)
bytecomp--docstring-line-width(STR)
bytecomp--dodgy-eq-arg-p(X NUMBER-OK)
bytecomp--mutargs-nconc(FORM)
bytecomp--mutargs-sort(FORM)
bytecomp--report-comma(FORM &rest IGNORE)
bytecomp--sort-call-in-place-p(FORM)
bytecomp--value-type-description(X)
bytecomp--warn-dodgy-eq-arg(FORM TYPE PARENTHESIS)
compile-defun(&optional ARG)
copy-byte-to-native-func-def(ARG)
copy-byte-to-native-lambda(ARG)
copy-byte-to-native-top-level(ARG)
display-call-tree(&optional FILENAME)
displaying-byte-compile-warnings(&rest BODY)
emacs-lisp-compilation-file-name-or-buffer(STR)
emacs-lisp-compilation-mode()
emacs-lisp-compilation-recompile()
make-byte-to-native-func-def
make-byte-to-native-func-def--cmacro
make-byte-to-native-lambda
make-byte-to-native-lambda--cmacro
make-byte-to-native-top-level
make-byte-to-native-top-level--cmacro

Defined faces (0)