* building.texi (Lisp Libraries): Clarify meaning of autoloading.

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index c4140d9ded332d6cd97be9c8d2a8768e4339e0fe..df54ae0c73c842d230e3602d77080b5fb85af4ed 100644 (file)
--- 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 ee5150ee9fbda5abd3932d82ed30129292d5c242..24e97a971fc7fc45de9a7193171543527a3c174c 100644 (file)
--- 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