created 2002 · complexity basic · author niboan · version 6.0
Programmers often need to adjust indents (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.
Indenting examples
To adjust the indent on three lines:
- Put the cursor anywhere in the first line.
- Press V then jj 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, or u to undo if you have shifted too far.
- Type gv if you want to reselect the lines (not needed).
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 then jj 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.
TO DO
- Need info on commands like vaB, viB, >aB, >iB.
- 597 Indent a code block Perhaps merge 597 to here, or use in "see also".
Mappings
If you select some lines then press > to indent the lines, the selection is removed. It's best to use the techniques shown in the previous section, but if you want, you can use some mappings.
To retain the visual selection after pressing > or < (press these keys again to repeat the indent, or press Esc to cancel):
:vnoremap > >gv :vnoremap < <gv " Alternative using Tab/Shift-Tab (for gvim). :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