|
1 |
| -*change.txt* For Vim version 9.1. Last change: 2025 Jun 26 |
| 1 | +*change.txt* For Vim version 9.1. Last change: 2025 Jul 15 |
2 | 2 |
|
3 | 3 |
|
4 | 4 | VIM REFERENCE MANUAL by Bram Moolenaar
|
@@ -991,22 +991,26 @@ This replaces each 'E' character with a euro sign. Read more in |<Char->|.
|
991 | 991 |
|
992 | 992 | 4.4 Changing tabs *change-tabs*
|
993 | 993 | *:ret* *:retab* *:retab!*
|
994 |
| -:[range]ret[ab][!] [new_tabstop] |
| 994 | +:[range]ret[ab][!] [-indentonly] [{new-tabstop}] |
995 | 995 | Replace all sequences of white-space containing a
|
996 |
| - <Tab> with new strings of white-space using the new |
997 |
| - tabstop value given. If you do not specify a new |
998 |
| - tabstop size or it is zero, Vim uses the current value |
999 |
| - of 'tabstop'. |
| 996 | + <Tab> with new strings of white-space using |
| 997 | + {new-tabstop}. If you do not specify {new-tabstop} or |
| 998 | + it is zero, Vim uses the current value of 'tabstop'. |
1000 | 999 | The current value of 'tabstop' is always used to
|
1001 | 1000 | compute the width of existing tabs.
|
1002 | 1001 | With !, Vim also replaces strings of only normal
|
1003 | 1002 | spaces with tabs where appropriate.
|
1004 | 1003 | With 'expandtab' on, Vim replaces all tabs with the
|
1005 | 1004 | appropriate number of spaces.
|
1006 |
| - This command sets 'tabstop' to the new value given, |
1007 |
| - and if performed on the whole file, which is default, |
1008 |
| - should not make any visible change. |
1009 |
| - Careful: This command modifies any <Tab> characters |
| 1005 | + This command sets 'tabstop' to {new-tabstop} and if |
| 1006 | + performed on the whole file, which is default, should |
| 1007 | + not make any visible change. |
| 1008 | + |
| 1009 | + When [-indentonly] is specified, only the leading |
| 1010 | + white-space will be targeted. Any other consecutive |
| 1011 | + white-space will not be changed. |
| 1012 | + |
| 1013 | + Warning: This command modifies any <Tab> characters |
1010 | 1014 | inside of strings in a C program. Use "\t" to avoid
|
1011 | 1015 | this (that's a good habit anyway).
|
1012 | 1016 | `:retab!` may also change a sequence of spaces by
|
|
0 commit comments