[Emacs-diffs] trunk r115938: Document `load-prefer-newer'.

[Rüdiger Sonderfeld]

------------------------------------------------------------
revno: 115938
revision-id: address@hidden
parent: address@hidden
committer: Rüdiger Sonderfeld <address@hidden>
branch nick: trunk
timestamp: Thu 2014-01-09 18:25:48 +0100
message:
  Document `load-prefer-newer'.
  
  * doc/emacs/building.texi (Lisp Libraries): Document
    `load-prefer-newer'.
  
  It is already documented in lispref.
modified:
  doc/emacs/ChangeLog            changelog-20091113204419-o5vbwnq5f7feedwu-6227
  doc/emacs/building.texi        
building.texi-20091113204419-o5vbwnq5f7feedwu-6235
  etc/NEWS                       news-20100311060928-aoit31wvzf25yr1z-1

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2014-01-09 13:34:36 +0000
+++ b/doc/emacs/ChangeLog       2014-01-09 17:25:48 +0000
@@ -1,5 +1,7 @@
 2014-01-09  Rüdiger Sonderfeld  <address@hidden>
 
+       * building.texi (Lisp Libraries): Document `load-prefer-newer'.
+
        * files.texi (File Conveniences): Document `image-next-frame',
        `image-previous-frame', `image-goto-frame',
        `image-increase-speed', `image-decrease-speed',

=== modified file 'doc/emacs/building.texi'
--- a/doc/emacs/building.texi   2014-01-01 07:43:34 +0000
+++ b/doc/emacs/building.texi   2014-01-09 17:25:48 +0000
@@ -1348,6 +1348,7 @@
 
 @findex load
 @findex load-library
address@hidden load-prefer-newer
 @cindex load path for Emacs Lisp
   If an Emacs Lisp file is installed in the Emacs Lisp @dfn{load path}
 (defined below), you can load it by typing @kbd{M-x load-library},
@@ -1356,15 +1357,17 @@
 searches through each directory in the Emacs Lisp load path, trying to
 find a file matching that library name.  If the library name is
 @address@hidden, it tries looking for files named
address@hidden@var{foo}.elc}, @address@hidden, and lastly just
address@hidden@var{foo}}; the first one found is loaded.  This command prefers
address@hidden files over @file{.el} files because compiled files load
-and run faster.  If it finds that @address@hidden is newer than
address@hidden@var{lib}.elc}, it issues a warning, in case someone made
address@hidden@var{foo}.elc}, @address@hidden, and @address@hidden  The
+default behaviour is to load the first file found.  This command
+prefers @file{.elc} files over @file{.el} files because compiled files
+load and run faster.  If it finds that @address@hidden is newer
+than @address@hidden, it issues a warning, in case someone made
 changes to the @file{.el} file and forgot to recompile it, but loads
 the @file{.elc} file anyway.  (Due to this behavior, you can save
 unfinished edits to Emacs Lisp source files, and not recompile until
-your changes are ready for use.)
+your changes are ready for use.)  However setting
address@hidden to a address@hidden value will Emacs load the
+newest version of the file found.
 
   Emacs Lisp programs usually load Emacs Lisp files using the
 @code{load} function.  This is similar to @code{load-library}, but is

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2014-01-09 16:54:54 +0000
+++ b/etc/NEWS  2014-01-09 17:25:48 +0000
@@ -242,6 +242,7 @@
 default value from the regexp last history element, or from the symbol
 found at point.
 
++++
 *** `load-prefer-newer', affects how the `load' function chooses the
 file to load.  If this is non-nil, then when both .el and .elc
 versions of a file exist, and the caller did not explicitly specify