16.10 Hooks for Loading

You can ask for code to be executed each time Emacs loads a library, by using the variable after-load-functions:

Variable: after-load-functions

This abnormal hook is run after loading a file. Each function in the hook is called with a single argument, the absolute filename of the file that was just loaded.

If you want code to be executed when a particular library is loaded, use the macro with-eval-after-load:

Macro: with-eval-after-load library body…

This macro arranges to evaluate body at the end of loading the file library, each time library is loaded. If library is already loaded, it evaluates body right away.

You don’t need to give a directory or extension in the file name library. Normally, you just give a bare file name, like this:

(with-eval-after-load "js" (keymap-set js-mode-map "C-c C-c" 'js-eval))

To restrict which files can trigger the evaluation, include a directory or an extension or both in library. Only a file whose absolute true name (i.e., the name with all symbolic links chased out) matches all the given name components will match. In the following example, my_inst.elc or my_inst.elc.gz in some directory ..../foo/bar will trigger the evaluation, but not my_inst.el:

(with-eval-after-load "foo/bar/my_inst.elc" …)

library can also be a feature (i.e., a symbol), in which case body is evaluated at the end of any file where (provide library) is called.

An error in body does not undo the load, but does prevent execution of the rest of body.

Normally, well-designed Lisp programs should not use with-eval-after-load. If you need to examine and set the variables defined in another library (those meant for outside use), you can do it immediately—there is no need to wait until the library is loaded. If you need to call functions defined by that library, you should load the library, preferably with require (see Features).