JohnBeckett (talk | contribs) (Rework, with simple advice first.) |
(Change <tt> to <code>, perhaps also minor tweak.) |
||
Line 16: | Line 16: | ||
==Basic commands== |
==Basic commands== |
||
− | In normal mode, type < |
+ | In normal mode, type <code>>></code> to indent the current line, or <code><<</code> to unindent. Each command can be used with a count. The operators <code>></code> and <code><</code> do the same for motions, text objects and visual selections. For all commands, pressing <code>.</code> repeats the operation. |
− | For example, typing < |
+ | For example, typing <code>5>>..</code> shifts five lines to the right, and then repeats the operation twice so that the five lines are shifted three times. |
− | In insert mode, < |
+ | In insert mode, <code>Ctrl-T</code> indents the current line, and <code>Ctrl-D</code> unindents. |
− | When indenting or unindenting, lines are shifted one < |
+ | When indenting or unindenting, lines are shifted one <code>'shiftwidth'</code> to the right or left. |
===Basic examples=== |
===Basic examples=== |
||
To adjust the indent on three lines: |
To adjust the indent on three lines: |
||
*Put the cursor anywhere in the first line. |
*Put the cursor anywhere in the first line. |
||
− | *Press < |
+ | *Press <code>V</code> then <code>jj</code> to visually select the three lines. |
− | *Press < |
+ | *Press <code>></code> to indent (shift text one '<code>shiftwidth</code>' to the right), or press <code><</code> to shift left. |
− | *Press < |
+ | *Press <code>.</code> to repeat the indent, or <code>u</code> to undo if you have shifted too far. |
− | *Type < |
+ | *Type <code>gv</code> if you want to reselect the lines (not needed). |
Alternatively, if you know that you want to adjust three lines, you can simply: |
Alternatively, if you know that you want to adjust three lines, you can simply: |
||
− | *Type < |
+ | *Type <code>3>></code> to shift right or <code>3<<</code> to shift left. |
Or: |
Or: |
||
− | *Type < |
+ | *Type <code>>2j</code> to shift right or <code><2j</code> to shift left. |
==More commands== |
==More commands== |
||
− | In normal mode, type < |
+ | In normal mode, type <code>==</code> to automatically indent the current line according to your [[VimTip83|indentation settings]]. This command can be used with a count. The <code>=</code> command does the same, but for motions, text objects and visual selections. |
− | To reindent an entire buffer, use < |
+ | To reindent an entire buffer, use <code>gg=G</code>. |
To reindent many files, the argument list can be used: |
To reindent many files, the argument list can be used: |
||
Line 55: | Line 55: | ||
</pre> |
</pre> |
||
− | In insert mode, < |
+ | In insert mode, <code>0 Ctrl-D</code> removes all indentation on the current line, and <code>^ Ctrl-D</code> does the same, but restores the original level of indentation for this line on the next line. When using <code>'cindent'</code> or file type based indentation, <code>Ctrl-F</code> reindents the current line, like <code>==</code> in normal mode. |
− | The < |
+ | The <code>:></code> and <code>:<</code> commands take a range, and additional <code>></code> or <code><</code> can be used. For example, <code>:12,20>>></code> indents lines 12 to 20 inclusive three times (adding three times <code>'shiftwidth'</code> of indentation to the specified lines). |
===More examples=== |
===More examples=== |
||
− | To set the indent on three lines to 12 spaces (or an equivalent mixture of tabs/spaces, depending on '< |
+ | To set the indent on three lines to 12 spaces (or an equivalent mixture of tabs/spaces, depending on '<code>expandtab</code>'): |
*Put the cursor anywhere in the first line. |
*Put the cursor anywhere in the first line. |
||
− | *Press < |
+ | *Press <code>V</code> then <code>jj</code> to visually select the three lines. |
− | *Type < |
+ | *Type <code>:le 12</code> then press Enter (abbreviation for <code>:left 12</code>). |
− | To remove all indents in a selected region, type < |
+ | To remove all indents in a selected region, type <code>:le</code> then press Enter. |
To apply automatic indentation (this requires suitable indent rules for your file type): |
To apply automatic indentation (this requires suitable indent rules for your file type): |
||
− | *Type < |
+ | *Type <code>==</code> to indent the current line. |
− | *Type a number then < |
+ | *Type a number then <code>==</code> to indent that many lines, starting from the cursor. |
− | *Press < |
+ | *Press <code>V</code> then move the cursor to select a range of lines, then press <code>=</code> to indent the selection. |
==Mappings== |
==Mappings== |
||
− | If you select some lines then press < |
+ | If you select some lines then press <code>></code> to indent the lines, the selection is removed. The indentation can be repeated on the same range using <code>.</code>, but if you still want to retain the visual selection after having pressed <code>></code> or <code><</code>, you can use these mappings |
<pre> |
<pre> |
||
vnoremap > >gv |
vnoremap > >gv |
||
Line 88: | Line 88: | ||
</pre> |
</pre> |
||
− | An alternative for anyone using < |
+ | An alternative for anyone using <code>:behave mswin</code>, is to select lines by holding down Shift and pressing the cursor down or up arrow keys. However, in select mode, if you press <code>></code>, the selected text will be replaced with '<code>></code>'. Instead, you can use Tab to increase the indent, and Shift-Tab to decrease it, with these mappings: |
<pre> |
<pre> |
||
vnoremap <Tab> > |
vnoremap <Tab> > |
||
Line 101: | Line 101: | ||
==See also== |
==See also== |
||
− | *[[VimTip597|597 Indent a code block]] indenting a code block (< |
+ | *[[VimTip597|597 Indent a code block]] indenting a code block (<code>{...}</code>) |
==References== |
==References== |
||
Line 110: | Line 110: | ||
==Comments== |
==Comments== |
||
− | Where < |
+ | Where <code>:wall</code> is used, should mention <code>:set hidden</code>. We should have a tip on that so we can just link to it. [[User:JohnBeckett|JohnBeckett]] 04:33, June 28, 2012 (UTC) |
Revision as of 07:49, 11 July 2012
Programmers often need to adjust indents (the amount of whitespace before the text on a line). This tip shows how it's done.
See Indenting source code for related information, including settings that affect indentation.
Basic commands
In normal mode, type >>
to indent the current line, or <<
to unindent. Each command can be used with a count. The operators >
and <
do the same for motions, text objects and visual selections. For all commands, pressing .
repeats the operation.
For example, typing 5>>..
shifts five lines to the right, and then repeats the operation twice so that the five lines are shifted three times.
In insert mode, Ctrl-T
indents the current line, and Ctrl-D
unindents.
When indenting or unindenting, lines are shifted one 'shiftwidth'
to the right or left.
Basic examples
To adjust the indent on three lines:
- Put the cursor anywhere in the first line.
- Press
V
thenjj
to visually select the three lines. - Press
>
to indent (shift text one 'shiftwidth
' to the right), or press<
to shift left. - Press
.
to repeat the indent, oru
to undo if you have shifted too far. - Type
gv
if you want to reselect the lines (not needed).
Alternatively, if you know that you want to adjust three lines, you can simply:
- Type
3>>
to shift right or3<<
to shift left.
Or:
- Type
>2j
to shift right or<2j
to shift left.
More commands
In normal mode, type ==
to automatically indent the current line according to your indentation settings. This command can be used with a count. The =
command does the same, but for motions, text objects and visual selections.
To reindent an entire buffer, use gg=G
.
To reindent many files, the argument list can be used:
:args *.c :argdo normal gg=G :wall
Or use the buffer list (caution, every buffer will be affected):
:bufdo normal gg=G :wall
In insert mode, 0 Ctrl-D
removes all indentation on the current line, and ^ Ctrl-D
does the same, but restores the original level of indentation for this line on the next line. When using 'cindent'
or file type based indentation, Ctrl-F
reindents the current line, like ==
in normal mode.
The :>
and :<
commands take a range, and additional >
or <
can be used. For example, :12,20>>>
indents lines 12 to 20 inclusive three times (adding three times 'shiftwidth'
of indentation to the specified lines).
More examples
To set the indent on three lines to 12 spaces (or an equivalent mixture of tabs/spaces, depending on 'expandtab
'):
- Put the cursor anywhere in the first line.
- Press
V
thenjj
to visually select the three lines. - Type
:le 12
then press Enter (abbreviation for:left 12
).
To remove all indents in a selected region, type :le
then press Enter.
To apply automatic indentation (this requires suitable indent rules for your file type):
- Type
==
to indent the current line. - Type a number then
==
to indent that many lines, starting from the cursor. - Press
V
then move the cursor to select a range of lines, then press=
to indent the selection.
Mappings
If you select some lines then press >
to indent the lines, the selection is removed. The indentation can be repeated on the same range using .
, but if you still want to retain the visual selection after having pressed >
or <
, you can use these mappings
vnoremap > >gv vnoremap < <gv
Following is a more elaborate set of mappings (mapping Shift-Tab will probably only work on gvim). In normal mode, press Tab or Shift-Tab to adjust the indent on the current line and position the cursor on the first nonblank character; in insert mode, press Shift-Tab to unindent; in visual mode, press Tab or Shift-Tab to adjust the indent on selected lines.
nnoremap <Tab> >>_ nnoremap <S-Tab> <<_ inoremap <S-Tab> <C-D> vnoremap <Tab> >gv vnoremap <S-Tab> <gv
An alternative for anyone using :behave mswin
, is to select lines by holding down Shift and pressing the cursor down or up arrow keys. However, in select mode, if you press >
, the selected text will be replaced with '>
'. Instead, you can use Tab to increase the indent, and Shift-Tab to decrease it, with these mappings:
vnoremap <Tab> > vnoremap <S-Tab> <
In select mode, visual-mode mappings temporarily set visual mode (:help Select-mode-mapping).Also, the select mode will be retained. You could use the following alternative if you want to exit from select mode after pressing Tab or Shift-Tab:
vnoremap <Tab> >gV vnoremap <S-Tab> <gV
See also
- 597 Indent a code block indenting a code block (
{...}
)
References
Comments
Where :wall
is used, should mention :set hidden
. We should have a tip on that so we can just link to it. JohnBeckett 04:33, June 28, 2012 (UTC)