[Emacs-diffs] /srv/bzr/emacs/trunk r107546: * loading.texi (Autoload): Explicitly state which forms are processed specially.

[Chong Yidong]

------------------------------------------------------------
revno: 107546
fixes bug(s): http://debbugs.gnu.org/7783
committer: Chong Yidong <address@hidden>
branch nick: trunk
timestamp: Sat 2012-03-10 12:00:13 +0800
message:
  * loading.texi (Autoload): Explicitly state which forms are processed 
specially.
modified:
  doc/lispref/ChangeLog
  doc/lispref/loading.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2012-03-10 03:27:10 +0000
+++ b/doc/lispref/ChangeLog     2012-03-10 04:00:13 +0000
@@ -1,5 +1,8 @@
 2012-03-10  Chong Yidong  <address@hidden>
 
+       * loading.texi (Autoload): Explicitly state which forms are
+       processed specially (Bug#7783).
+
        * keymaps.texi (Mouse Menus): Describe non-toolkit behavior as the
        non-default situation.  Describe one-submenu exception (Bug#7695).
 

=== modified file 'doc/lispref/loading.texi'
--- a/doc/lispref/loading.texi  2012-02-10 07:57:21 +0000
+++ b/doc/lispref/loading.texi  2012-03-10 04:00:13 +0000
@@ -500,14 +500,31 @@
 autoloads for all files in the current directory.
 
   The same magic comment can copy any kind of form into
address@hidden  If the form following the magic comment is not a
-function-defining form or a @code{defcustom} form, it is copied
-verbatim.  ``Function-defining forms'' include @code{define-skeleton},
address@hidden, @code{define-generic-mode} and
address@hidden as well as @code{defun} and
address@hidden  To save space, a @code{defcustom} form is converted to
-a @code{defvar} in @file{loaddefs.el}, with some additional information
-if it uses @code{:require}.
address@hidden  The form following the magic comment is copied
+verbatim, @emph{except} if it is one of the forms which the autoload
+facility handles specially (e.g.@: by conversion into an
address@hidden call).  The forms which are not copied verbatim are
+the following:
+
address@hidden @asis
address@hidden Definitions for function or function-like objects:
address@hidden and @code{defmacro}; also @code{defun*} and
address@hidden (@pxref{Argument Lists,,,cl,CL Manual}), and
address@hidden (see the commentary in
address@hidden).
+
address@hidden Definitions for major or minor modes:
address@hidden, @code{define-minor-mode},
address@hidden, @code{define-generic-mode},
address@hidden, @code{define-global-minor-mode},
address@hidden, and
address@hidden
+
address@hidden Other definition types:
address@hidden, @code{defgroup}, @code{defclass}
+(@pxref{Top,EIEIO,,eieio,EIEIO}), and @code{define-skeleton} (see the
+commentary in @file{skeleton.el}).
address@hidden table
 
   You can also use a magic comment to execute a form at build time
 @emph{without} executing it when the file itself is loaded.  To do this,