# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 1095535234 0
# Node ID 5358b2582e78f85197773c5adb1b32b91cf239eb
# Parent  646750cbd594ccb72f91bb121f6e797e49a6e42d
(syms_of_buffer) <default-major-mode>: Doc fix.

diff -r 646750cbd594 -r 5358b2582e78 src/buffer.c
--- a/src/buffer.c	Sat Sep 18 19:18:58 2004 +0000
+++ b/src/buffer.c	Sat Sep 18 19:20:34 2004 +0000
@@ -5430,7 +5430,14 @@
 
   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),