Next: , Previous: Erase, Up: Clip Commands


4.4.8 Shift

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

shifts the text on lines between the mark and the cursor either right (‘>’, the default) 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 default is 1. 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 the document's Tabs flag is set—in which case a ‘t’ appears in the status bar— and the ShiftTabs is also set—in which case the ‘t’ in the status bar will be upper case. If either of the ShiftTabs or Tabs flags are off (and therefore the ‘t’ in the status bar is lower case or missing, respectively) 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.