aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorLuc Teirlinck2004-08-30 22:03:18 +0000
committerLuc Teirlinck2004-08-30 22:03:18 +0000
commit2aa2f8b8c979787390f8ebf6ebe22fa81bbe7c06 (patch)
tree58c638f90cddc96e489e8c6a6bf86e97ea1f1305
parent16ceacc222529b8cdfd6fa7b2031940a926717f0 (diff)
downloademacs-2aa2f8b8c979787390f8ebf6ebe22fa81bbe7c06.tar.gz
emacs-2aa2f8b8c979787390f8ebf6ebe22fa81bbe7c06.zip
Various minor changes in addition to:
(Indentation Commands): Correct description of `indent-relative'. (Tab Stops): <TAB> is no longer bound to `tab-to-tab-stop' in Text mode. The *Tab Stops* buffer uses Overwrite Mode. (Just Spaces): `untabify' converts sequences of at least two spaces to tabs.
-rw-r--r--man/ChangeLog9
-rw-r--r--man/indent.texi48
2 files changed, 31 insertions, 26 deletions
diff --git a/man/ChangeLog b/man/ChangeLog
index d859a3b2fe0..8af5062c7e7 100644
--- a/man/ChangeLog
+++ b/man/ChangeLog
@@ -1,3 +1,12 @@
12004-08-30 Luc Teirlinck <teirllm@auburn.edu>
2
3 * indent.texi: Various minor changes in addition to:
4 (Indentation Commands): Correct description of `indent-relative'.
5 (Tab Stops): <TAB> is no longer bound to `tab-to-tab-stop' in Text
6 mode. The *Tab Stops* buffer uses Overwrite Mode.
7 (Just Spaces): `untabify' converts sequences of at least two
8 spaces to tabs.
9
12004-08-28 Eli Zaretskii <eliz@gnu.org> 102004-08-28 Eli Zaretskii <eliz@gnu.org>
2 11
3 * faq.texi (Emacs for MS-DOS): Update URLs for the MS-DOS port of 12 * faq.texi (Emacs for MS-DOS): Update URLs for the MS-DOS port of
diff --git a/man/indent.texi b/man/indent.texi
index d2134103240..ab640e76462 100644
--- a/man/indent.texi
+++ b/man/indent.texi
@@ -1,5 +1,5 @@
1@c This is part of the Emacs manual. 1@c This is part of the Emacs manual.
2@c Copyright (C) 1985, 86, 87, 93, 94, 95, 1997 Free Software Foundation, Inc. 2@c Copyright (C) 1985, 86, 87, 93, 94, 95, 1997, 2004 Free Software Foundation, Inc.
3@c See file emacs.texi for copying conditions. 3@c See file emacs.texi for copying conditions.
4@node Indentation, Text, Major Modes, Top 4@node Indentation, Text, Major Modes, Top
5@chapter Indentation 5@chapter Indentation
@@ -75,7 +75,7 @@ type @key{TAB}, it aligns the line as a whole.
75 Normally, all of the above methods insert an optimal mix of tabs and 75 Normally, all of the above methods insert an optimal mix of tabs and
76spaces to align to the desired column. @xref{Just Spaces}, for how to 76spaces to align to the desired column. @xref{Just Spaces}, for how to
77disable use of tabs. However, @kbd{C-q @key{TAB}} always inserts a 77disable use of tabs. However, @kbd{C-q @key{TAB}} always inserts a
78tab, even they are disabled for the indentation commands. 78tab, even when tabs are disabled for the indentation commands.
79 79
80@c In Text mode, @key{TAB} runs the command @code{tab-to-tab-stop}, which 80@c In Text mode, @key{TAB} runs the command @code{tab-to-tab-stop}, which
81@c indents to the next tab stop column. You can set the tab stops with 81@c indents to the next tab stop column. You can set the tab stops with
@@ -95,7 +95,8 @@ tab, even they are disabled for the indentation commands.
95@findex back-to-indentation 95@findex back-to-indentation
96 To move over the indentation on a line, do @kbd{M-m} 96 To move over the indentation on a line, do @kbd{M-m}
97(@code{back-to-indentation}). This command, given anywhere on a line, 97(@code{back-to-indentation}). This command, given anywhere on a line,
98positions point at the first nonblank character on the line. 98positions point at the first nonblank character on the line, if any,
99or else at the end of the line.
99 100
100 To insert an indented line before the current line, do @kbd{C-a C-o 101 To insert an indented line before the current line, do @kbd{C-a C-o
101@key{TAB}}. To make an indented line after the current line, use 102@key{TAB}}. To make an indented line after the current line, use
@@ -134,13 +135,13 @@ appears after the newline that is deleted. @xref{Fill Prefix}.
134@findex indent-region 135@findex indent-region
135@findex indent-rigidly 136@findex indent-rigidly
136 There are also commands for changing the indentation of several lines 137 There are also commands for changing the indentation of several lines
137at once. @kbd{C-M-\} (@code{indent-region}) applies to all the lines 138at once. They apply to all the lines that begin in the region.
138that begin in the region; it indents each line in the ``usual'' way, as 139@kbd{C-M-\} (@code{indent-region}) indents each line in the ``usual''
139if you had typed @key{TAB} at the beginning of the line. A numeric 140way, as if you had typed @key{TAB} at the beginning of the line. A
140argument specifies the column to indent to, and each line is shifted 141numeric argument specifies the column to indent to, and each line is
141left or right so that its first nonblank character appears in that 142shifted left or right so that its first nonblank character appears in
142column. @kbd{C-x @key{TAB}} (@code{indent-rigidly}) moves all of the 143that column. @kbd{C-x @key{TAB}} (@code{indent-rigidly}) moves all of
143lines in the region right by its argument (left, for negative 144the lines in the region right by its argument (left, for negative
144arguments). The whole group of lines moves rigidly sideways, which is 145arguments). The whole group of lines moves rigidly sideways, which is
145how the command gets its name.@refill 146how the command gets its name.@refill
146 147
@@ -152,12 +153,10 @@ such as -1000.
152@findex indent-relative 153@findex indent-relative
153 @kbd{M-x indent-relative} indents at point based on the previous line 154 @kbd{M-x indent-relative} indents at point based on the previous line
154(actually, the last nonempty line). It inserts whitespace at point, moving 155(actually, the last nonempty line). It inserts whitespace at point, moving
155point, until it is underneath an indentation point in the previous line. 156point, until it is underneath the next indentation point in the previous line.
156An indentation point is the end of a sequence of whitespace or the end of 157An indentation point is the end of a sequence of whitespace or the end of
157the line. If point is farther right than any indentation point in the 158the line. If point is farther right than any indentation point in the
158previous line, the whitespace before point is deleted and the first 159previous line, @code{indent-relative} runs @code{tab-to-tab-stop}
159indentation point then applicable is used. If no indentation point is
160applicable even then, @code{indent-relative} runs @code{tab-to-tab-stop}
161@ifinfo 160@ifinfo
162(@pxref{Tab Stops}), 161(@pxref{Tab Stops}),
163@end ifinfo 162@end ifinfo
@@ -167,9 +166,6 @@ applicable even then, @code{indent-relative} runs @code{tab-to-tab-stop}
167unless it is called with a numeric argument, in which case it does 166unless it is called with a numeric argument, in which case it does
168nothing. 167nothing.
169 168
170 @code{indent-relative} is the definition of @key{TAB} in Indented Text
171mode. @xref{Text}.
172
173 @xref{Format Indentation}, for another way of specifying the 169 @xref{Format Indentation}, for another way of specifying the
174indentation for part of your text. 170indentation for part of your text.
175 171
@@ -181,10 +177,9 @@ indentation for part of your text.
181@cindex tables, indentation for 177@cindex tables, indentation for
182@kindex M-i 178@kindex M-i
183@findex tab-to-tab-stop 179@findex tab-to-tab-stop
184 For typing in tables, you can use Text mode's definition of @key{TAB}, 180 For typing in tables, you can use @kbd{M-i} (@code{tab-to-tab-stop}).
185@code{tab-to-tab-stop}. This command inserts indentation before point, 181This command inserts indentation before point, enough to reach the
186enough to reach the next tab stop column. If you are not in Text mode, 182next tab stop column.
187this command can be found on the key @kbd{M-i}.
188 183
189@findex edit-tab-stops 184@findex edit-tab-stops
190@findex edit-tab-stops-note-changes 185@findex edit-tab-stops-note-changes
@@ -198,10 +193,11 @@ increasing order.
198edit-tab-stops}, which creates and selects a buffer containing a 193edit-tab-stops}, which creates and selects a buffer containing a
199description of the tab stop settings. You can edit this buffer to 194description of the tab stop settings. You can edit this buffer to
200specify different tab stops, and then type @kbd{C-c C-c} to make those 195specify different tab stops, and then type @kbd{C-c C-c} to make those
201new tab stops take effect. @code{edit-tab-stops} records which buffer 196new tab stops take effect. The buffer uses Overwrite mode
202was current when you invoked it, and stores the tab stops back in that 197(@pxref{Minor Modes}). @code{edit-tab-stops} records which buffer was
203buffer; normally all buffers share the same tab stops and changing them 198current when you invoked it, and stores the tab stops back in that
204in one buffer affects all, but if you happen to make 199buffer; normally all buffers share the same tab stops and changing
200them in one buffer affects all, but if you happen to make
205@code{tab-stop-list} local in one buffer then @code{edit-tab-stops} in 201@code{tab-stop-list} local in one buffer then @code{edit-tab-stops} in
206that buffer will edit the local settings. 202that buffer will edit the local settings.
207 203
@@ -242,7 +238,7 @@ that your file looks the same regardless of the tab width setting.
242@findex untabify 238@findex untabify
243 There are also commands to convert tabs to spaces or vice versa, always 239 There are also commands to convert tabs to spaces or vice versa, always
244preserving the columns of all nonblank text. @kbd{M-x tabify} scans the 240preserving the columns of all nonblank text. @kbd{M-x tabify} scans the
245region for sequences of spaces, and converts sequences of at least three 241region for sequences of spaces, and converts sequences of at least two
246spaces to tabs if that can be done without changing indentation. @kbd{M-x 242spaces to tabs if that can be done without changing indentation. @kbd{M-x
247untabify} changes all tabs in the region to appropriate numbers of spaces. 243untabify} changes all tabs in the region to appropriate numbers of spaces.
248 244