]> code.delx.au - gnu-emacs/blobdiff - man/major.texi
(X Resources): Fix From link.
[gnu-emacs] / man / major.texi
index 35b95d06bab9cf0e0339e2e5051638ca4ae20717..4c933b13db0e5733069f7eff7446e41d3ed39a87 100644 (file)
@@ -31,14 +31,16 @@ how comments are to be delimited.  Many major modes redefine the
 syntactical properties of characters appearing in the buffer.
 @xref{Syntax}.
 
-  The major modes fall into three major groups.  Lisp mode (which has
-several variants), C mode, Fortran mode and others are for specific
-programming languages.  Text mode, Nroff mode, SGML mode, @TeX{} mode
-and Outline mode are for normal text, plain or marked up.  The remaining
-major modes are not intended for use on users' files; they are used in
-buffers created for specific purposes by Emacs, such as Dired mode for
-buffers made by Dired (@pxref{Dired}), Mail mode for buffers made by
-@kbd{C-x m} (@pxref{Sending Mail}), and Shell mode for buffers used for
+  The major modes fall into three major groups.  The first group
+contains modes for normal text, either plain or with mark-up.  It
+includes Text mode, HTML mode, SGML mode, @TeX{} mode and Outline
+mode.  The second group contains modes for specific programming
+languages.  These include Lisp mode (which has several variants), C
+mode, Fortran mode, and others.  The remaining major modes are not
+intended for use on users' files; they are used in buffers created for
+specific purposes by Emacs, such as Dired mode for buffers made by
+Dired (@pxref{Dired}), Mail mode for buffers made by @kbd{C-x m}
+(@pxref{Sending Mail}), and Shell mode for buffers used for
 communicating with an inferior shell process (@pxref{Interactive
 Shell}).
 
@@ -88,12 +90,12 @@ or this form,
 For example, one element normally found in the list has the form
 @code{(@t{"\\.c\\'"} . c-mode)}, and it is responsible for selecting C
 mode for files whose names end in @file{.c}.  (Note that @samp{\\} is
-needed in Lisp syntax to include a @samp{\} in the string, which is
-needed to suppress the special meaning of @samp{.} in regexps.)  If the
+needed in Lisp syntax to include a @samp{\} in the string, which must
+be used to suppress the special meaning of @samp{.} in regexps.)  If the
 element has the form @code{(@var{regexp} @var{mode-function}
 @var{flag})} and @var{flag} is non-@code{nil}, then after calling
-@var{function}, the suffix that matched @var{regexp} is discarded and
-the list is searched again for another match.
+@var{mode-function}, the suffix that matched @var{regexp} is discarded
+and the list is searched again for another match.
 
   You can specify which major mode should be used for editing a certain
 file by a special sort of text in the first nonblank line of the file.  The
@@ -106,7 +108,7 @@ mode name should appear in this line both preceded and followed by
 
 @noindent
 tells Emacs to use Lisp mode.  Such an explicit specification overrides
-any defaulting based on the file name.  Note how the semicolon is used
+any defaults based on the file name.  Note how the semicolon is used
 to make Lisp treat this line as a comment.
 
   Another format of mode specification is
@@ -151,14 +153,14 @@ when you create a new buffer with @kbd{C-x b}, the variable
 @code{default-major-mode} specifies which major mode to use.  Normally
 its value is the symbol @code{fundamental-mode}, which specifies
 Fundamental mode.  If @code{default-major-mode} is @code{nil}, the major
-mode is taken from the previously selected buffer.
+mode is taken from the previously current buffer.
 
 @findex normal-mode
   If you change the major mode of a buffer, you can go back to the major
 mode Emacs would choose automatically: use the command @kbd{M-x
 normal-mode} to do this.  This is the same function that
 @code{find-file} calls to choose the major mode.  It also processes
-the file's local variables list if any.
+the file's local variables list (if any).
 
 @vindex change-major-mode-with-file-name
   The commands @kbd{C-x C-w} and @code{set-visited-file-name} change to
@@ -167,3 +169,7 @@ However, this does not happen if the buffer contents specify a major
 mode, and certain ``special'' major modes do not allow the mode to
 change.  You can turn off this mode-changing feature by setting
 @code{change-major-mode-with-file-name} to @code{nil}.
+
+@ignore
+   arch-tag: f2558800-cf32-4839-8acb-7d3b4df2a155
+@end ignore