[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] /srv/bzr/emacs/trunk r105470: Improve documentation of `sp
From: |
Eli Zaretskii |
Subject: |
[Emacs-diffs] /srv/bzr/emacs/trunk r105470: Improve documentation of `special' modes. |
Date: |
Tue, 16 Aug 2011 11:40:31 +0300 |
User-agent: |
Bazaar (2.3.1) |
------------------------------------------------------------
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] /srv/bzr/emacs/trunk r105470: Improve documentation of `special' modes.,
Eli Zaretskii <=