[Emacs-diffs] trunk r115701: Some documenting of load-prefer-newer

[Glenn Morris]

------------------------------------------------------------
revno: 115701
revision-id: address@hidden
parent: address@hidden
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Sun 2013-12-22 18:54:28 -0800
message:
  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.
modified:
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/loading.texi       
loading.texi-20091113204419-o5vbwnq5f7feedwu-6193
  src/ChangeLog                  changelog-20091113204419-o5vbwnq5f7feedwu-1438
  src/lread.c                    lread.c-20091113204419-o5vbwnq5f7feedwu-266

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2013-12-22 23:19:42 +0000
+++ b/doc/lispref/ChangeLog     2013-12-23 02:54:28 +0000
@@ -1,6 +1,12 @@
+2013-12-23  Glenn Morris  <address@hidden>
+
+       * loading.texi (How Programs Do Loading, Load Suffixes):
+       Mention `load-prefer-newer'.
+
 2013-12-22  Xue Fuqiao  <address@hidden>
 
-       * 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  <address@hidden>
 
@@ -15,11 +21,11 @@
 
        * text.texi (Examining Properties): Document `get-pos-property'.
 
-       * variables.texi (Directory Local Variables): Document
-       `enable-dir-local-variables'.
+       * variables.texi (Directory Local Variables):
+       Document `enable-dir-local-variables'.
 
-       * debugging.texi (Debugger Commands): Document
-       `debugger-toggle-locals'.
+       * debugging.texi (Debugger Commands):
+       Document `debugger-toggle-locals'.
 
 2013-12-21  Chong Yidong  <address@hidden>
 

=== modified file 'doc/lispref/loading.texi'
--- a/doc/lispref/loading.texi  2013-12-13 18:25:30 +0000
+++ b/doc/lispref/loading.texi  2013-12-23 02:54:28 +0000
@@ -93,6 +93,10 @@
 @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 address@hidden, 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/foo.bar}, @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 @@
 it skips the former group, and if @var{must-suffix} is address@hidden,
 it skips the latter group.
 
address@hidden load-prefer-newer
+If this option is address@hidden, then rather than stopping at the
+first suffix that exists, @code{load} tests them all, and uses
+whichever file is the newest.
address@hidden defopt
+
 @node Library Search
 @section Library Search
 @cindex library search

=== modified file 'src/ChangeLog'
--- a/src/ChangeLog     2013-12-22 15:19:09 +0000
+++ b/src/ChangeLog     2013-12-23 02:54:28 +0000
@@ -1,3 +1,7 @@
+2013-12-23  Glenn Morris  <address@hidden>
+
+       * lread.c (Fload): Mention load-prefer-newer in doc.
+
 2013-12-22  Martin Rudalics  <address@hidden>
 
        Handle Bug#16207 by being more restrictive when running hooks.

=== modified file 'src/lread.c'
--- a/src/lread.c       2013-12-22 00:52:26 +0000
+++ b/src/lread.c       2013-12-23 02:54:28 +0000
@@ -1029,6 +1029,10 @@
 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'.