The basic indentation command is @key{TAB}, which gives the current line
the correct indentation as determined from the previous lines. The
function that @key{TAB} runs depends on the major mode; it is
-@code{indent-for-tab-command}
+@code{lisp-indent-line}
in Lisp mode, @code{c-indent-command} in C mode, etc. These functions
understand the syntax and conventions of different languages, but they all do
conceptually the same job: @key{TAB} in any programming-language major mode
@table @kbd
@item C-M-q
-Reindent all the lines within one parenthetical grouping(@code{indent-sexp}).
+Reindent all the lines within one parenthetical grouping(@code{indent-sexp}) .
@item C-M-\
Reindent all lines in the region (@code{indent-region}).
@item C-u @key{TAB}
@findex indent-sexp
You can reindent the contents of a single parenthetical grouping by
positioning point before the beginning of it and typing @kbd{C-M-q}
-(@code{indent-sexp} in Lisp mode, @code{c-indent-exp} in C mode; also
+(@code{indent-pp-sexp} in Lisp mode, @code{c-indent-exp} in C mode; also
bound to other suitable commands in other modes). The indentation of
the line where the grouping starts is not changed; therefore it
changes only the relative indentation within the grouping, not its
region sideways, like @code{indent-rigidly} does (@pxref{Indentation
Commands}). It doesn't alter the indentation of lines that start
inside a string, unless the region also starts inside that string.
+The prefix arg specifies the number of columns to indent.
@node Lisp Indent
@subsection Customizing Lisp Indentation
@vindex blink-matching-paren
@vindex blink-matching-paren-distance
@vindex blink-matching-delay
- Three variables control parenthesis match display.
-@code{blink-matching-paren} turns the feature on or off: @code{nil}
+ Three variables control parenthesis match display:
+
+ @code{blink-matching-paren} turns the feature on or off: @code{nil}
disables it, but the default is @code{t} to enable match display.
@code{blink-matching-delay} says how many seconds to leave the
mode constantly displays in the echo area the argument list for the
function being called at point. (In other words, it finds the
function call that point is contained in, and displays the argument
-list of that function.) Eldoc mode applies in Emacs Lisp and Lisp
-Interaction modes only. Use the command @kbd{M-x eldoc-mode} to
+list of that function.) If point is over a documented variable, it
+shows the variable's docstring. Eldoc mode applies in Emacs Lisp and
+Lisp Interaction modes only. Use the command @kbd{M-x eldoc-mode} to
enable or disable this feature.
@node Hideshow
@findex c-show-syntactic-information
@kindex C-c C-s @r{(C mode)}
Display the syntactic information about the current source line
-(@code{c-show-syntactic-information}). This is the information that
-directs how the line is indented.
+(@code{c-show-syntactic-information}). This information directs how
+the line is indented.
@item M-x cwarn-mode
@itemx M-x global-cwarn-mode
@table @kbd
@item M-;
-Align comment or insert new comment (@code{fortran-comment-indent}).
+Align comment or insert new comment (@code{fortran-indent-comment}).
@item C-x ;
Applies to nonstandard @samp{!} comments only.
@end table
@kbd{M-;} in Fortran mode is redefined as the command
-@code{fortran-comment-indent}. Like the usual @kbd{M-;} command, this
+@code{fortran-indent-comment}. Like the usual @kbd{M-;} command, this
recognizes any kind of existing comment and aligns its text appropriately;
if there is no existing comment, a comment is inserted and aligned. But
inserting and aligning comments are not the same in Fortran mode as in