diff options
| author | Luc Teirlinck | 2004-08-30 22:03:18 +0000 |
|---|---|---|
| committer | Luc Teirlinck | 2004-08-30 22:03:18 +0000 |
| commit | 2aa2f8b8c979787390f8ebf6ebe22fa81bbe7c06 (patch) | |
| tree | 58c638f90cddc96e489e8c6a6bf86e97ea1f1305 | |
| parent | 16ceacc222529b8cdfd6fa7b2031940a926717f0 (diff) | |
| download | emacs-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/ChangeLog | 9 | ||||
| -rw-r--r-- | man/indent.texi | 48 |
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 @@ | |||
| 1 | 2004-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 | |||
| 1 | 2004-08-28 Eli Zaretskii <eliz@gnu.org> | 10 | 2004-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 |
| 76 | spaces to align to the desired column. @xref{Just Spaces}, for how to | 76 | spaces to align to the desired column. @xref{Just Spaces}, for how to |
| 77 | disable use of tabs. However, @kbd{C-q @key{TAB}} always inserts a | 77 | disable use of tabs. However, @kbd{C-q @key{TAB}} always inserts a |
| 78 | tab, even they are disabled for the indentation commands. | 78 | tab, 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, |
| 98 | positions point at the first nonblank character on the line. | 98 | positions point at the first nonblank character on the line, if any, |
| 99 | or 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 |
| 137 | at once. @kbd{C-M-\} (@code{indent-region}) applies to all the lines | 138 | at once. They apply to all the lines that begin in the region. |
| 138 | that 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'' |
| 139 | if you had typed @key{TAB} at the beginning of the line. A numeric | 140 | way, as if you had typed @key{TAB} at the beginning of the line. A |
| 140 | argument specifies the column to indent to, and each line is shifted | 141 | numeric argument specifies the column to indent to, and each line is |
| 141 | left or right so that its first nonblank character appears in that | 142 | shifted left or right so that its first nonblank character appears in |
| 142 | column. @kbd{C-x @key{TAB}} (@code{indent-rigidly}) moves all of the | 143 | that column. @kbd{C-x @key{TAB}} (@code{indent-rigidly}) moves all of |
| 143 | lines in the region right by its argument (left, for negative | 144 | the lines in the region right by its argument (left, for negative |
| 144 | arguments). The whole group of lines moves rigidly sideways, which is | 145 | arguments). The whole group of lines moves rigidly sideways, which is |
| 145 | how the command gets its name.@refill | 146 | how 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 |
| 155 | point, until it is underneath an indentation point in the previous line. | 156 | point, until it is underneath the next indentation point in the previous line. |
| 156 | An indentation point is the end of a sequence of whitespace or the end of | 157 | An indentation point is the end of a sequence of whitespace or the end of |
| 157 | the line. If point is farther right than any indentation point in the | 158 | the line. If point is farther right than any indentation point in the |
| 158 | previous line, the whitespace before point is deleted and the first | 159 | previous line, @code{indent-relative} runs @code{tab-to-tab-stop} |
| 159 | indentation point then applicable is used. If no indentation point is | ||
| 160 | applicable 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} | |||
| 167 | unless it is called with a numeric argument, in which case it does | 166 | unless it is called with a numeric argument, in which case it does |
| 168 | nothing. | 167 | nothing. |
| 169 | 168 | ||
| 170 | @code{indent-relative} is the definition of @key{TAB} in Indented Text | ||
| 171 | mode. @xref{Text}. | ||
| 172 | |||
| 173 | @xref{Format Indentation}, for another way of specifying the | 169 | @xref{Format Indentation}, for another way of specifying the |
| 174 | indentation for part of your text. | 170 | indentation 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, | 181 | This command inserts indentation before point, enough to reach the |
| 186 | enough to reach the next tab stop column. If you are not in Text mode, | 182 | next tab stop column. |
| 187 | this 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. | |||
| 198 | edit-tab-stops}, which creates and selects a buffer containing a | 193 | edit-tab-stops}, which creates and selects a buffer containing a |
| 199 | description of the tab stop settings. You can edit this buffer to | 194 | description of the tab stop settings. You can edit this buffer to |
| 200 | specify different tab stops, and then type @kbd{C-c C-c} to make those | 195 | specify different tab stops, and then type @kbd{C-c C-c} to make those |
| 201 | new tab stops take effect. @code{edit-tab-stops} records which buffer | 196 | new tab stops take effect. The buffer uses Overwrite mode |
| 202 | was 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 |
| 203 | buffer; normally all buffers share the same tab stops and changing them | 198 | current when you invoked it, and stores the tab stops back in that |
| 204 | in one buffer affects all, but if you happen to make | 199 | buffer; normally all buffers share the same tab stops and changing |
| 200 | them 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 |
| 206 | that buffer will edit the local settings. | 202 | that 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 |
| 244 | preserving the columns of all nonblank text. @kbd{M-x tabify} scans the | 240 | preserving the columns of all nonblank text. @kbd{M-x tabify} scans the |
| 245 | region for sequences of spaces, and converts sequences of at least three | 241 | region for sequences of spaces, and converts sequences of at least two |
| 246 | spaces to tabs if that can be done without changing indentation. @kbd{M-x | 242 | spaces to tabs if that can be done without changing indentation. @kbd{M-x |
| 247 | untabify} changes all tabs in the region to appropriate numbers of spaces. | 243 | untabify} changes all tabs in the region to appropriate numbers of spaces. |
| 248 | 244 | ||