summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChong Yidong <cyd@stupidchicken.com>2009-07-28 15:23:52 +0000
committerChong Yidong <cyd@stupidchicken.com>2009-07-28 15:23:52 +0000
commitc6f3bd7758d0bc990a3183bfeef18acdcb763ad4 (patch)
tree4f5a78a002518f6fd1ed8be4cf087ec6970fb924
parent82d659d83a2ad06b732ab7f8d8c59c2b6b0999f1 (diff)
downloademacs-c6f3bd7758d0bc990a3183bfeef18acdcb763ad4.tar.gz
* building.texi (Lisp Libraries): Clarify meaning of autoloading.
-rw-r--r--doc/emacs/ChangeLog4
-rw-r--r--doc/emacs/building.texi12
2 files changed, 11 insertions, 5 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index c4140d9ded3..df54ae0c73c 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,7 @@
+2009-07-28 Chong Yidong <cyd@stupidchicken.com>
+
+ * building.texi (Lisp Libraries): Clarify meaning of autoloading.
+
2009-07-22 Richard Stallman <rms@gnu.org>
* glossary.texi (GNU, Daemon): Update information.
diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi
index ee5150ee9fb..24e97a971fc 100644
--- a/doc/emacs/building.texi
+++ b/doc/emacs/building.texi
@@ -1270,11 +1270,13 @@ your own, put them in a single directory and add that directory to
@end example
@cindex autoload
- Often you do not have to give any command to load a library, because
-the commands defined in the library are set up to @dfn{autoload} that
-library. Trying to run any of those commands calls @code{load} to load
-the library; this replaces the autoload definitions with the real ones
-from the library.
+ Some commands are @dfn{autoloaded}: when you run them, Emacs will
+automatically load the associated library first. For instance, the
+@code{compile} and @code{compilation-mode} commands are autoloaded; if
+you call either command, Emacs automatically loads @file{compile.elc}
+or @file{compile.el}. (In contrast, the command @code{recompile} is
+not autoloaded, and thus unavailable until you load @file{compile.elc}
+or @file{compile.el}.)
@vindex load-dangerous-libraries
@cindex Lisp files byte-compiled by XEmacs