# HG changeset patch
# User Chong Yidong <cyd@stupidchicken.com>
# Date 1248794864 0
# Node ID ffb9ddb9ba16b117050ab499bed32d5385a1ff85
# Parent  5b0ac40cc7c1347a554c53478389aa88bd0f9468
* building.texi (Lisp Libraries): Clarify meaning of autoloading.

diff -r 5b0ac40cc7c1 -r ffb9ddb9ba16 doc/emacs/ChangeLog
--- a/doc/emacs/ChangeLog	Tue Jul 28 15:08:17 2009 +0000
+++ b/doc/emacs/ChangeLog	Tue Jul 28 15:27:44 2009 +0000
@@ -1,3 +1,7 @@
+2009-07-28  Chong Yidong  <cyd@stupidchicken.com>
+
+	* building.texi (Lisp Libraries): Clarify meaning of autoloading.
+
 2009-07-23  Glenn Morris  <rgm@gnu.org>
 
 	* programs.texi (Matching): Update blink-matching-paren-distance.
diff -r 5b0ac40cc7c1 -r ffb9ddb9ba16 doc/emacs/building.texi
--- a/doc/emacs/building.texi	Tue Jul 28 15:08:17 2009 +0000
+++ b/doc/emacs/building.texi	Tue Jul 28 15:27:44 2009 +0000
@@ -1270,11 +1270,13 @@
 @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
+(@pxref{Compilation}) are autoloaded; if you call either command,
+Emacs automatically loads the @code{compile} library.  In contrast,
+the command @code{recompile} is not autoloaded, so it is unavailable
+until you load the @code{compile} library.
 
 @vindex load-dangerous-libraries
 @cindex Lisp files byte-compiled by XEmacs