Commit aec3bf9f authored by Glenn Morris's avatar Glenn Morris
Browse files

Some documenting of load-prefer-newer

* doc/lispref/loading.texi (How Programs Do Loading, Load Suffixes):
Mention `load-prefer-newer'.

* src/lread.c (Fload): Mention load-prefer-newer in doc.
parent bb962da2
2013-12-23 Glenn Morris <>
* loading.texi (How Programs Do Loading, Load Suffixes):
Mention `load-prefer-newer'.
2013-12-22 Xue Fuqiao <>
* hash.texi (Other Hash): Document `hash-table-keys and `hash-table-values'.
* hash.texi (Other Hash): Document `hash-table-keys'
and `hash-table-values'.
2013-12-22 Eli Zaretskii <>
......@@ -15,11 +21,11 @@
* text.texi (Examining Properties): Document `get-pos-property'.
* variables.texi (Directory Local Variables): Document
* variables.texi (Directory Local Variables):
Document `enable-dir-local-variables'.
* debugging.texi (Debugger Commands): Document
* debugging.texi (Debugger Commands):
Document `debugger-toggle-locals'.
2013-12-21 Chong Yidong <>
......@@ -93,6 +93,10 @@ If the optional argument @var{must-suffix} is non-@code{nil}, then
@samp{.el} or @samp{.elc} (possibly extended with a compression
suffix), unless it contains an explicit directory name.
If the option @code{load-prefer-newer} is non-@code{nil}, then when
searching suffixes, @code{load} selects whichever version of a file
(@samp{.elc}, @samp{.el}, etc.) has been modified most recently.
If @var{filename} is a relative file name, such as @file{foo} or
@file{baz/}, @code{load} searches for the file using the variable
@code{load-path}. It appends @var{filename} to each of the directories
......@@ -246,6 +250,12 @@ value of @code{(get-load-suffixes)} and then those in
it skips the former group, and if @var{must-suffix} is non-@code{nil},
it skips the latter group.
@defopt load-prefer-newer
If this option is non-@code{nil}, then rather than stopping at the
first suffix that exists, @code{load} tests them all, and uses
whichever file is the newest.
@end defopt
@node Library Search
@section Library Search
@cindex library search
2013-12-23 Glenn Morris <>
* lread.c (Fload): Mention load-prefer-newer in doc.
2013-12-22 Martin Rudalics <>
Handle Bug#16207 by being more restrictive when running hooks.
......@@ -1029,6 +1029,10 @@ in `load-file-rep-suffixes'. If MUST-SUFFIX is non-nil, only the
return value of `get-load-suffixes' is used, i.e. the file name is
required to have a non-empty suffix.
When searching suffixes, this function normally stops at the first
one that exists. If the option `load-prefer-newer' is non-nil,
however, it tries all suffixes, and uses whichever file is the newest.
Loading a file records its definitions, and its `provide' and
`require' calls, in an element of `load-history' whose
car is the file name loaded. See `load-history'.
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment