[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs/doc/lispref loading.texi
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] emacs/doc/lispref loading.texi |
Date: |
Sat, 27 Dec 2008 13:58:21 +0000 |
CVSROOT: /cvsroot/emacs
Module name: emacs
Changes by: Eli Zaretskii <eliz> 08/12/27 13:58:21
Modified files:
doc/lispref : loading.texi
Log message:
(Autoload): Document `generate-autoload-cookie' and
`generated-autoload-file'.
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/loading.texi?cvsroot=emacs&r1=1.7&r2=1.8
Patches:
Index: loading.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/loading.texi,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -b -r1.7 -r1.8
--- loading.texi 9 Sep 2008 08:02:00 -0000 1.7
+++ loading.texi 27 Dec 2008 13:58:21 -0000 1.8
@@ -501,6 +501,9 @@
just before the real definition of the function in its
autoloadable source file. The command @kbd{M-x update-file-autoloads}
writes a corresponding @code{autoload} call into @file{loaddefs.el}.
+(The string that serves as the autoload cookie and the name of the
+file generated by @code{update-file-autoloads} can be changed from the
+above defaults, see below.)
Building Emacs loads @file{loaddefs.el} and thus calls @code{autoload}.
@kbd{M-x update-directory-autoloads} is even more powerful; it updates
autoloads for all files in the current directory.
@@ -567,6 +570,26 @@
...)
@end smallexample
+ You can use a non-default string as the autoload cookie and have the
+corresponding autoload calls written into a file whose name is
+different from the default @file{loaddefs.el}. Emacs provides two
+variables to control this:
+
address@hidden generate-autoload-cookie
+The value of this variable should be a string whose syntax is a Lisp
+comment. @kbd{M-x update-file-autoloads} copies the Lisp form that
+follows the cookie into the autoload file it generates. The default
+value of this variable is @code{";;;###autoload"}.
address@hidden defvar
+
address@hidden generated-autoload-file
+The value of this variable names an Emacs Lisp file where the autoload
+calls should go. The default value is @file{loaddefs.el}, but you can
+override that, e.g., in the ``Local Variables'' section of a
address@hidden file (@pxref{File Local Variables}). The autoload file is
+assumed to contain a trailer starting with a formfeed character.
address@hidden defvar
+
@node Repeated Loading
@section Repeated Loading
@cindex repeated loading
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] emacs/doc/lispref loading.texi,
Eli Zaretskii <=