From: Chong Yidong Date: Tue, 28 Jul 2009 15:23:52 +0000 (+0000) Subject: * building.texi (Lisp Libraries): Clarify meaning of autoloading. X-Git-Tag: emacs-23.1~7 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=c6f3bd7758d0bc990a3183bfeef18acdcb763ad4;p=emacs.git * building.texi (Lisp Libraries): Clarify meaning of autoloading. --- 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 + + * building.texi (Lisp Libraries): Clarify meaning of autoloading. + 2009-07-22 Richard Stallman * 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