4.4.8 Shift

Syntax: Shift [<|>][n][t|s]
Abbreviation: SH

shifts the text on lines between the mark and the cursor either right (‘>’) or left (‘<’) by adding or removing white space on each line. The adjustment size, specified as an unsigned integer ‘n’, is in units of the current tab size (‘t’) or spaces (‘s’). The defaults are ‘>’, ‘1’, and ‘t’. Adjustments start at the left edge of a vertical mark, or column 1 otherwise. If the mark is not currently set, only the current line is affected.

Shift will insert tab characters only if ‘s’ is not used, and both of the document’s Tabs and ShiftTabs flags are set—in which case an upper case ‘T’ will appear in the status bar. If either of the Tabs or ShiftTabs flags is unset (i.e there is no upper case ‘T’ in the status bar) Shift will only insert spaces.

In the case of left shifts, if any indicated line has insufficient leading white space for the requested adjustment to be made, then Shift reports an error and makes no changes.