Avoid name conflicts with outline.el. Use 3 installments to keep

[gnu-emacs] / man / indent.texi

diff --git a/man/indent.texi b/man/indent.texi
index d4591bd4edeea1abb5e7f78dd30b16a9a695e2e1..1a7310f8c8023914a5f4b472ccd0db67c0f7787c 100644 (file)
--- a/man/indent.texi
+++ b/man/indent.texi
@@ -9,25 +9,25 @@
   This chapter describes the Emacs commands that add, remove, or
 adjust indentation.
 
-@c WideCommands
 @table @kbd
 @item @key{TAB}
-Indent current line ``appropriately'' in a mode-dependent fashion.
+Indent the current line ``appropriately'' in a mode-dependent fashion.
 @item @kbd{C-j}
 Perform @key{RET} followed by @key{TAB} (@code{newline-and-indent}).
 @item M-^
-Merge two lines (@code{delete-indentation}).  This would cancel out
-the effect of @kbd{C-j}.
+Merge the previous and the current line (@code{delete-indentation}).
+This would cancel out the effect of @kbd{C-j}.
 @item C-M-o
-Split line at point; text on the line after point becomes a new line
-indented to the same column that it now starts in (@code{split-line}).
+Split the current line at point; text on the line after point becomes a
+new line indented to the same column where point is located
+(@code{split-line}).
 @item M-m
 Move (forward or back) to the first nonblank character on the current
 line (@code{back-to-indentation}).
 @item C-M-\
-Indent several lines to same column (@code{indent-region}).
+Indent several lines to the same column (@code{indent-region}).
 @item C-x @key{TAB}
-Shift block of lines rigidly right or left (@code{indent-rigidly}).
+Shift a block of lines rigidly right or left (@code{indent-rigidly}).
 @item M-i
 Indent from point to the next prespecified tab stop column
 (@code{tab-to-tab-stop}).
@@ -52,8 +52,9 @@ knows about many aspects of C syntax.
 indents to the next tab stop column.  You can set the tab stops with
 @kbd{M-x edit-tab-stops}.
 
-  Normally, @key{TAB} inserts a mix of tabs and spaces to indent lines.
-@xref{Just Spaces}, for how to override that.
+  Normally, @key{TAB} inserts an optimal mix of tabs and spaces for
+the intended indentation.  @xref{Just Spaces}, for how to prevent use
+of tabs.
 
 @menu
 * Indentation Commands::  Various commands and techniques for indentation.
@@ -118,6 +119,11 @@ lines in the region right by its argument (left, for negative
 arguments).  The whole group of lines moves rigidly sideways, which is
 how the command gets its name.@refill
 
+@cindex remove indentation
+  If you want to remove all indentation from all of the line in the
+region, invoke @kbd{C-x @key{TAB}} with a large negative argument,
+such as -1000.
+
 @findex indent-relative
   @kbd{M-x indent-relative} indents at point based on the previous line
 (actually, the last nonempty line).  It inserts whitespace at point, moving
@@ -128,11 +134,13 @@ previous line, the whitespace before point is deleted and the first
 indentation point then applicable is used.  If no indentation point is
 applicable even then, @code{indent-relative} runs @code{tab-to-tab-stop}
 @ifinfo
-(@pxref{Tab Stops}).
+(@pxref{Tab Stops}),
 @end ifinfo
 @iftex
-(see next section).
+(see next section),
 @end iftex
+unless it is called with a numeric argument, in which case it does
+nothing.
 
   @code{indent-relative} is the definition of @key{TAB} in Indented Text
 mode.  @xref{Text}.