Info Catalog elisp: Unloading elisp: Loading elisp: Dynamic Modules

elisp: Hooks for Loading

 
 15.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 "edebug" (def-edebug-spec c-point t))
 
      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’ (Named Features).
 

Info Catalog elisp: Unloading elisp: Loading elisp: Dynamic Modules