(syms_of_buffer) <default-major-mode>: Doc fix.

diff --git a/src/ChangeLog b/src/ChangeLog
index 3d8cfd612002e5ed8f155c23119e366b7c24c251..9cd8931ff8a615d4d99bcb97e8fedf37883ac2d8 100644 (file)
--- a/src/ChangeLog
+++ b/src/ChangeLog
@@ -1,5 +1,7 @@
 2004-09-18  Richard M. Stallman  <rms@gnu.org>
 
+       * buffer.c (syms_of_buffer) <default-major-mode>: Doc fix.
+
        * xdisp.c (try_window_reusing_current_matrix):
        Handle the case where we reach the old displayed text,
        out of sync with the old line boundary.

diff --git a/src/buffer.c b/src/buffer.c
index c70831e155f602902aa88647fd76f2c4ad578fb1..b1c453816cedf2e787b73ddde11b0685727e9b57 100644 (file)
--- a/src/buffer.c
+++ b/src/buffer.c
@@ -5430,7 +5430,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),