Go to the previous, next section.

Major Modes

Emacs has many different major modes, each of which customizes Emacs for editing text of a particular sort. The major modes are mutually exclusive, and each buffer has one major mode at any time. The mode line normally contains the name of the current major mode, in parentheses. See section The Mode Line.

The least specialized major mode is called Fundamental mode. This mode has no mode-specific redefinitions or variable settings, so that each Emacs command behaves in its most general manner, and each option is in its default state. For editing any specific type of text, such as Lisp code or English text, you should switch to the appropriate major mode, such as Lisp mode or Text mode.

Selecting a major mode changes the meanings of a few keys to become more specifically adapted to the language being edited. The ones which are changed frequently are TAB, DEL, and LFD. In addition, the commands which handle comments use the mode to determine how comments are to be delimited. Many major modes redefine the syntactical properties of characters appearing in the buffer. See section The Syntax Table.

The major modes fall into three major groups. Lisp mode (which has several variants), C mode and Muddle mode are for specific programming languages. Text mode, Nroff mode, TeX mode and Outline mode are for editing English text. 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 (see section Dired, the Directory Editor), and Mail mode for buffers made by C-x m (see section Sending Mail), and Shell mode for buffers used for communicating with an inferior shell process (see section Interactive Inferior Shell).

Most programming language major modes specify that only blank lines separate paragraphs. This is so that the paragraph commands remain useful. See section Paragraphs. They also cause Auto Fill mode to use the definition of TAB to indent the new lines it creates. This is because most lines in a program are usually indented. See section Indentation.

How Major Modes are Chosen

You can select a major mode explicitly for the current buffer, but most of the time Emacs determines which mode to use based on the file name or some text in the file.

Explicit selection of a new major mode is done with a M-x command. From the name of a major mode, add -mode to get the name of a command to select that mode. Thus, you can enter Lisp mode by executing M-x lisp-mode.

When you visit a file, Emacs usually chooses the right major mode based on the file's name. For example, files whose names end in .c are edited in C mode. The correspondence between file names and major mode is controlled by the variable auto-mode-alist. Its value is a list in which each element has the form

(regexp . mode-function)

For example, one element normally found in the list has the form ("\\.c$" . c-mode), and it is responsible for selecting C mode for files whose names end in `.c'. (Note that `\\' is needed in Lisp syntax to include a `\' in the string, which is needed to suppress the special meaning of `.' in regexps.) The only practical way to change this variable is with Lisp code.

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 mode name should appear in this line both preceded and followed by `-*-'. Other text may appear on the line as well. For example,

;-*-Lisp-*-

tells Emacs to use Lisp mode. Note how the semicolon is used to make Lisp treat this line as a comment. Such an explicit specification overrides any defaulting based on the file name.

Another format of mode specification is

-*-Mode: modename;-*-

which allows other things besides the major mode name to be specified. However, Emacs does not look for anything except the mode name.

The major mode can also be specified in a local variables list. See section Local Variables in Files.

When a file is visited that does not specify a major mode to use, or when a new buffer is created with C-x b, the major mode used is that specified by the variable default-major-mode. Normally this value is the symbol fundamental-mode, which specifies Fundamental mode. If default-major-mode is nil, the major mode is taken from the previously selected buffer.

The command M-x normal-mode recalculates the major mode from the visited file name and the contents of the buffer.

Go to the previous, next section.