I didn't know byte compiled emacs files (.elc) were actually version-specific until Malabarba pointed that to me.

So this made me ask what do those files actually contain and how does their execution compare to the execution of normal .el files? What is the benefit of compiling an emacs file and how does emacs takes advantage of this?

  • 2
    In short, a byte-compiled file contains valid elisp, and is interpreted by the elisp interpreter. You could write byte-compiled code if you wanted to (though you really shouldn't, as that can crash emacs).
    – Malabarba
    Commented Nov 7, 2014 at 12:48
  • 1
    Actually, it did not use to be the case that .elc files were very version-specific. Emacs Dev had the explicit policy that you could use a .elc byte-compiled with an older Emacs version with a new version. It's a bit unfortunate that this policy was abandoned (IMO).
    – Drew
    Commented Nov 7, 2014 at 16:01

1 Answer 1


The Emacs manual node on byte compilation explains that elisp

... has a compiler that translates functions written in Lisp into a special representation called byte-code that can be executed more efficiently. The compiler replaces Lisp function definitions with byte-code.

These byte-codes are basically numeric codes that are not human readable (byte-car, for example, is 64, and byte-forward-char is 123). There is, however, a disassembler provided to "satisfy a cat-like curiosity" if you want to see how the sausage gets made.

Here's what the all-knowing Wikipedia page on Bytecode has to say:

Bytecode... is a form of instruction set designed for efficient execution by a software interpreter. Unlike human-readable source code, bytecodes are compact numeric codes, constants, and references... which encode the result of parsing and semantic analysis of things like type, scope, and nesting depths of program objects. They therefore allow much better performance than direct interpretation of source code.

The manual gives a simple example of the speedup from using a byte-compiled versus interpreted function -- 2 to 3 times in their looping example.

New bytecodes get added to Emacs as new versions are released -- hence, new versions know about the old versions' bytecodes, but not the other way around. To see some of this in action, you can browse through the bytecomp library (or M-x find-library RET bytecomp) to take a look at what's in it. Note that, at various points in the code, it defines new bytecodes for newer versions of Emacs (look for comments around byte-defop lines).

For an example of someone digging into the byte-code to understand why he couldn't seem to advise the narrowing/widening functions, see limits of advice.

NOTE: as @Malabarba's comment points out, there's a great post over at Null Program on Emacs Byte-Code Internals.

  • 3
    null program has a great post on this. nullprogram.com/blog/2014/01/04
    – Malabarba
    Commented Nov 7, 2014 at 12:46
  • 1
    @Malabarba: nice find -- I'd forgotten about that post. I've now put the link directly in the answer.
    – Dan
    Commented Nov 7, 2014 at 12:50

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.