From: Richard M. Stallman <rms@gnu.org>
Date: Wed, 16 Jan 2002 02:47:15 +0000 (+0000)
Subject: (Autoload): Explain how to autoload function definitions that use
X-Git-Tag: ttn-vms-21-2-B4~17127
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=7f551e47f1f757e94d5b9c4a87b2284029267e73;p=emacs.git

(Autoload): Explain how to autoload function definitions that use
unusual macros.
---

diff --git a/lispref/loading.texi b/lispref/loading.texi
index 837da4c79a4..bee4aca587f 100644
--- a/lispref/loading.texi
+++ b/lispref/loading.texi
@@ -478,6 +478,18 @@ convention used only in the preloaded uncompiled Lisp files such as
 documentation string in the @file{etc/DOC} file.  @xref{Building Emacs}.
 See also the commentary in @file{lib-src/make-docfile.c}.
 
+  If you write a function definition with an unusual macro that is not
+one of the known and recognized function definition methods, use of an
+ordinary magic autoload comment would copy the whole definition into
+@code{loaddefs.el}.  That is not desirable.  You can put the desired
+@code{autoload} call into @code{loaddefs.el} instead by writing this:
+
+@smallexample
+;;;###autoload (autoload 'foo "myfile")
+(mydefunmacro foo
+  ...)
+@end smallexample
+
 @node Repeated Loading
 @section Repeated Loading
 @cindex repeated loading