[Emacs-diffs] Changes to emacs/lispref/loading.texi

[Richard M. Stallman]

Index: emacs/lispref/loading.texi
diff -c emacs/lispref/loading.texi:1.32 emacs/lispref/loading.texi:1.33
*** emacs/lispref/loading.texi:1.32     Thu Sep  6 15:49:45 2001
--- emacs/lispref/loading.texi  Tue Jan 15 21:47:15 2002
***************
*** 478,483 ****
--- 478,495 ----
  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