Revision: miles@gnu.org--gnu-2004/emacs--unicode--0--patch-43

Merge from emacs--cvs-trunk--0

Patches applied:

 * miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-553
 - miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-557
   Update from CVS

 * miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-558
   Merge from gnus--rel--5.10

 * miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-559
 - miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-561
   Update from CVS

 * miles@gnu.org--gnu-2004/gnus--rel--5.10--patch-30
   Update from CVS

1 files changed, 8 insertions, 1 deletions

diff --git a/src/buffer.c b/src/buffer.c
index 2084d80049a..75339c4fc85 100644
--- a/src/buffer.c
+++ b/src/buffer.c
@@ -5446,7 +5446,14 @@ Decimal digits after the % specify field width to which to pad.  */);
 
   DEFVAR_LISP_NOPRO ("default-major-mode", &buffer_defaults.major_mode,
                      doc: /* *Major mode for new buffers.  Defaults to `fundamental-mode'.
-nil here means use current buffer's major mode.  */);
+nil here means use current buffer's major mode, provided it is not
+marked as "special".
+
+When a mode is used by default, `find-file' switches to it
+before it reads the contents into the buffer and before
+it finishes setting up the buffer.  Thus, the mode and
+its hooks should not expect certain variables such as
+`buffer-read-only' and `buffer-file-coding-system' to be set up.  */);
 
   DEFVAR_PER_BUFFER ("major-mode", &current_buffer->major_mode,
                      make_number (Lisp_Symbol),