diff options
| author | Chong Yidong <cyd@stupidchicken.com> | 2009-07-28 15:27:44 +0000 |
|---|---|---|
| committer | Chong Yidong <cyd@stupidchicken.com> | 2009-07-28 15:27:44 +0000 |
| commit | e8d2d3fb19902626992a00b09f56cadb880ff1e0 (patch) | |
| tree | 575a625a599377d3b5e0027ff715d880b1632f31 | |
| parent | 6dd2819379e67525477f8fe1b53001edec57425c (diff) | |
| download | emacs-e8d2d3fb19902626992a00b09f56cadb880ff1e0.tar.gz | |
* building.texi (Lisp Libraries): Clarify meaning of autoloading.
| -rw-r--r-- | doc/emacs/ChangeLog | 4 | ||||
| -rw-r--r-- | doc/emacs/building.texi | 12 |
2 files changed, 11 insertions, 5 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog index 47bda92af44..4481d78e3aa 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-23 Glenn Morris <rgm@gnu.org> * programs.texi (Matching): Update blink-matching-paren-distance. diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi index ee5150ee9fb..2eb714b826d 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 +(@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 |