[Emacs-diffs] emacs/doc/emacs ChangeLog building.texi [EMACS_23_1_RC]

[Chong Yidong]

CVSROOT:        /sources/emacs
Module name:    emacs
Branch:         EMACS_23_1_RC
Changes by:     Chong Yidong <cyd>      09/07/28 15:23:52

Modified files:
        doc/emacs      : ChangeLog building.texi 

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

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/ChangeLog?cvsroot=emacs&only_with_tag=EMACS_23_1_RC&r1=1.332.2.12&r2=1.332.2.13
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/building.texi?cvsroot=emacs&only_with_tag=EMACS_23_1_RC&r1=1.21&r2=1.21.2.1

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/ChangeLog,v
retrieving revision 1.332.2.12
retrieving revision 1.332.2.13
diff -u -b -r1.332.2.12 -r1.332.2.13
--- ChangeLog   22 Jul 2009 02:37:28 -0000      1.332.2.12
+++ ChangeLog   28 Jul 2009 15:23:52 -0000      1.332.2.13
@@ -1,3 +1,7 @@
+2009-07-28  Chong Yidong  <address@hidden>
+
+       * building.texi (Lisp Libraries): Clarify meaning of autoloading.
+
 2009-07-22  Richard Stallman  <address@hidden>
 
        * glossary.texi (GNU, Daemon): Update information.

Index: building.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/building.texi,v
retrieving revision 1.21
retrieving revision 1.21.2.1
diff -u -b -r1.21 -r1.21.2.1
--- building.texi       4 Jun 2009 03:07:17 -0000       1.21
+++ building.texi       28 Jul 2009 15:23:52 -0000      1.21.2.1
@@ -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
address@hidden 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