[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] trunk r115938: Document `load-prefer-newer'.
From: |
Rüdiger Sonderfeld |
Subject: |
[Emacs-diffs] trunk r115938: Document `load-prefer-newer'. |
Date: |
Thu, 09 Jan 2014 17:27:12 +0000 |
User-agent: |
Bazaar (2.6b2) |
------------------------------------------------------------
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] trunk r115938: Document `load-prefer-newer'.,
Rüdiger Sonderfeld <=