@c This is part of the Emacs manual.
-@c Copyright (C) 1985-1987, 1993-1995, 1997, 2001-2013 Free Software
+@c Copyright (C) 1985-1987, 1993-1995, 1997, 2001-2016 Free Software
@c Foundation, Inc.
@c See file emacs.texi for copying conditions.
@node Indentation
combination of space and tab characters to advance point to the next
tab stop (@pxref{Tab Stops}). For this purpose, the position of the
first non-whitespace character on the preceding line is treated as an
-additional tab stop, so you can use @key{TAB} to ``align'' point with
+additional tab stop, so you can use @key{TAB} to align point with
the preceding line. If the region is active (@pxref{Using Region}),
@key{TAB} acts specially: it indents each line in the region so that
its first non-whitespace character is aligned with the preceding line.
ways.
@table @kbd
-@item C-j
-@kindex C-j
-@findex newline-and-indent
-Perform @key{RET} followed by @key{TAB} (@code{newline-and-indent}).
-
@item C-M-o
@kindex C-M-o
@findex split-line
@kindex M-^
@findex delete-indentation
Merge the previous and the current line (@code{delete-indentation}).
-This ``joins'' the two lines cleanly, by replacing any indentation at
+This joins the two lines cleanly, by replacing any indentation at
the front of the current line, together with the line boundary, with a
single space.
@findex indent-rigidly
@cindex remove indentation
This command is used to change the indentation of all lines that begin
-in the region, moving the affected lines as a ``rigid'' unit.
+in the region, moving the affected lines as a rigid unit.
If called with no argument, the command activates a transient mode for
adjusting the indentation of the affected lines interactively. While
Emacs defines certain column numbers to be @dfn{tab stops}. These
are used as stopping points by @key{TAB} when inserting whitespace in
Text mode and related modes (@pxref{Indentation}), and by commands
-like @kbd{M-i} (@pxref{Indentation Commands}). By default, tab stops
-are located every 8 columns. These positions are stored in the
-variable @code{tab-stop-list}, whose value is a list of column numbers
-in increasing order.
+like @kbd{M-i} (@pxref{Indentation Commands}). The variable
+@code{tab-stop-list} controls these positions. The default value is
+@code{nil}, which means a tab stop every 8 columns. The value can
+also be a list of zero-based column numbers (in increasing order) at
+which to place tab stops. Emacs extends the list forever by repeating
+the difference between the last and next-to-last elements.
@findex edit-tab-stops
@kindex C-c C-c @r{(Edit Tab Stops)}
@noindent
The first line contains a colon at each tab stop. The numbers on the
-next two lines are present just to indicate where the colons are. It
-is implicitly extended to infinity by repeating the last step.
+next two lines are present just to indicate where the colons are.
+If the value of @code{tab-stop-list} is @code{nil}, as it is by default,
+no colons are displayed initially.
You can edit this buffer to specify different tab stops by placing
colons on the desired columns. The buffer uses Overwrite mode
-(@pxref{Minor Modes}). When you are done, type @kbd{C-c C-c} to make
+(@pxref{Minor Modes}). Remember that Emacs will extend the list of
+tab stops forever by repeating the difference between the last two
+explicit stops that you place. When you are done, type @kbd{C-c C-c} to make
the new tab stops take effect. Normally, the new tab stop settings
apply to all buffers. However, if you have made the
@code{tab-stop-list} variable local to the buffer where you called
@dfn{display tab stop}. @xref{Text Display}.
@node Just Spaces
-@section Tabs vs. Spaces
+@section Tabs vs.@: Spaces
@vindex tab-width
Normally, indentation commands insert (or remove) an optimal mix of
Electric Indent mode is a global minor mode that automatically
indents the line after every @key{RET} you type. This mode is enabled
by default. To toggle this minor mode, type @kbd{M-x
-electric-indent-mode}.
+electric-indent-mode}. To toggle the mode in a single buffer,
+use @kbd{M-x electric-indent-local-mode}.