Mercurial > emacs

comparison lisp/emacs-lisp/shadow.el @ 73745:06fca0c59a88

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
(list-load-path-shadows): Fix typo in docstring.
author Juanma Barranquero <lekktu@gmail.com>
date Mon, 06 Nov 2006 02:35:42 +0000
parents 067115a6e738
children 1d4b1a32fd66 02cf29720f31
comparison
equal deleted inserted replaced
73744:84aef5a30c72 73745:06fca0c59a88
182 182
183 and that each of these directories contains a file called XXX.el. Then 183 and that each of these directories contains a file called XXX.el. Then
184 XXX.el in the site-lisp directory is referred to by all of: 184 XXX.el in the site-lisp directory is referred to by all of:
185 \(require 'XXX\), \(autoload .... \"XXX\"\), \(load-library \"XXX\"\) etc. 185 \(require 'XXX\), \(autoload .... \"XXX\"\), \(load-library \"XXX\"\) etc.
186 186
187 The first XXX.el file prevents emacs from seeing the second \(unless 187 The first XXX.el file prevents Emacs from seeing the second \(unless
188 the second is loaded explicitly via load-file\). 188 the second is loaded explicitly via `load-file'\).
189 189
190 When not intended, such shadowings can be the source of subtle 190 When not intended, such shadowings can be the source of subtle
191 problems. For example, the above situation may have arisen because the 191 problems. For example, the above situation may have arisen because the
192 XXX package was not distributed with versions of emacs prior to 192 XXX package was not distributed with versions of Emacs prior to
193 19.30. An emacs maintainer downloaded XXX from elsewhere and installed 193 19.30. An Emacs maintainer downloaded XXX from elsewhere and installed
194 it. Later, XXX was updated and included in the emacs distribution. 194 it. Later, XXX was updated and included in the Emacs distribution.
195 Unless the emacs maintainer checks for this, the new version of XXX 195 Unless the Emacs maintainer checks for this, the new version of XXX
196 will be hidden behind the old \(which may no longer work with the new 196 will be hidden behind the old \(which may no longer work with the new
197 emacs version\). 197 Emacs version\).
198 198
199 This function performs these checks and flags all possible 199 This function performs these checks and flags all possible
200 shadowings. Because a .el file may exist without a corresponding .elc 200 shadowings. Because a .el file may exist without a corresponding .elc
201 \(or vice-versa\), these suffixes are essentially ignored. A file 201 \(or vice-versa\), these suffixes are essentially ignored. A file
202 XXX.elc in an early directory \(that does not contain XXX.el\) is 202 XXX.elc in an early directory \(that does not contain XXX.el\) is