summaryrefslogtreecommitdiff
path: root/src/lread.c
diff options
context:
space:
mode:
authorGlenn Morris <rgm@gnu.org>2013-12-22 18:54:28 -0800
committerGlenn Morris <rgm@gnu.org>2013-12-22 18:54:28 -0800
commitaec3bf9f49c8c0d0356a0e57f362bd0e23206e7d (patch)
tree1968eb7f765b2b67cfe72ab250fabbcb3ebc9413 /src/lread.c
parentbb962da29aed412d70ac4b0b02bb343eb133dc88 (diff)
downloademacs-aec3bf9f49c8c0d0356a0e57f362bd0e23206e7d.tar.gz
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.
Diffstat (limited to 'src/lread.c')
-rw-r--r--src/lread.c4
1 files changed, 4 insertions, 0 deletions
diff --git a/src/lread.c b/src/lread.c
index 1db3a47ef0a..a6181b0cb85 100644
--- a/src/lread.c
+++ b/src/lread.c
@@ -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'.