File: shadow.el.html
The functions in this file detect (load-path-shadows-find)
and display (list-load-path-shadows) potential load-path
problems that arise when Emacs Lisp files "shadow" each other.
For example, a file XXX.el early in one's load-path will shadow a file with the same name in a later load-path directory. When this is unintentional, it may result in problems that could have been easily avoided. This occurs often (to me) when installing a new version of Emacs and something in the site-lisp directory has been updated and added to the Emacs distribution. The old version, now outdated, shadows the new one. This is obviously undesirable.
The list-load-path-shadows function was run when you installed
this version of Emacs. To run it by hand in emacs:
M-x list-load-path-shadows
or run it non-interactively via:
emacs -batch -f list-load-path-shadows
Thanks to Francesco Potortì <pot@cnuce.cnr.it> for suggestions, rewritings & speedups.
Defined variables (6)
load-path-shadows-compare-text | If non-nil, then shadowing files are reported only if their text differs. |
load-path-shadows-font-lock-keywords | Keywords to highlight in ‘load-path-shadows-mode’. |
load-path-shadows-mode-abbrev-table | Abbrev table for ‘load-path-shadows-mode’. |
load-path-shadows-mode-hook | Hook run after entering ‘load-path-shadows-mode’. |
load-path-shadows-mode-map | Keymap for ‘load-path-shadows-mode’. |
load-path-shadows-mode-syntax-table | Syntax table for ‘load-path-shadows-mode’. |
Defined functions (4)
list-load-path-shadows | (&optional STRINGP) |
load-path-shadows-find | (&optional PATH) |
load-path-shadows-mode | () |
load-path-shadows-same-file-or-nonexistent | (F1 F2) |