[Emacs-diffs] /srv/bzr/emacs/trunk r105470: Improve documentation of `special' modes.

[Eli Zaretskii]

------------------------------------------------------------
revno: 105470
committer: Eli Zaretskii <address@hidden>
branch nick: trunk
timestamp: Tue 2011-08-16 11:40:31 +0300
message:
  Improve documentation of `special' modes.
  
   doc/lispref/modes.texi (Major Mode Conventions): Improve the documentation
   of `mode-class' `special' modes.
modified:
  doc/lispref/ChangeLog
  doc/lispref/modes.texi

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2011-08-16 08:26:46 +0000
+++ b/doc/lispref/ChangeLog     2011-08-16 08:40:31 +0000
@@ -1,5 +1,8 @@
 2011-08-16  Eli Zaretskii  <address@hidden>
 
+       * modes.texi (Major Mode Conventions): Improve the documentation
+       of `mode-class' `special' modes.
+
        * nonascii.texi (Character Properties): Document the `mirroring'
        property.  Add index entries.
 

=== modified file 'doc/lispref/modes.texi'
--- a/doc/lispref/modes.texi    2011-07-13 21:42:54 +0000
+++ b/doc/lispref/modes.texi    2011-08-16 08:40:31 +0000
@@ -505,21 +505,26 @@
 value for @code{change-major-mode-hook} (@pxref{Creating Buffer-Local}).
 
 @item
-If this mode is appropriate only for specially-prepared text, then the
-major mode command symbol should have a property named @code{mode-class}
-with value @code{special}, put on as follows:
+If this mode is appropriate only for specially-prepared text produced by
+the mode itself (rather than by the user typing at the keyboard or by an
+external file), then the major mode command symbol should have a
+property named @code{mode-class} with value @code{special}, put on as
+follows:
 
 @kindex mode-class @r{(property)}
address@hidden @code{special}
address@hidden @code{special} modes
 @example
 (put 'funny-mode 'mode-class 'special)
 @end example
 
 @noindent
-This tells Emacs that new buffers created while the current buffer is
-in Funny mode should not inherit Funny mode, in case the default value
-of @code{major-mode} is @code{nil}.  Modes such as Dired, Rmail,
-and Buffer List use this feature.
+This tells Emacs that new buffers created while the current buffer is in
+Funny mode should not be put in Funny mode, even though the default
+value of @code{major-mode} is @code{nil}.  By default, the value of
address@hidden for @code{major-mode} means to use the current buffer's major
+mode when creating new buffers (@pxref{Auto Major Mode}), but with such
address@hidden modes, Fundamental mode is used instead.  Modes such as
+Dired, Rmail, and Buffer List use this feature.
 
 The @code{define-derived-mode} macro automatically marks the derived
 mode as special if the parent mode is special.  The special mode