SPFLite - V3.0.24069 2024-03-09

[

  { .start-label  | .start-line-number } 

  [ {.end-label   | .end-line-number } ]

]

[

  :tag 

]

Alternative Line Command Specification - CC and MM Blocks

In addition to the line number ranges being specified on the command line, all Primary commands which accept line-range-operand format will also accept the line range via line commands. The C/CC and M/MM line commands can be used to mark the lines to be used and then the primary command entered without a line range specification.

Single character text selection operands

An optional shortcut method is available for entering the line range operands if suitable. When a text area is selected via a mouse-drag operation of via keyboard Shift-arrow keys, the line and column range of the selected text is remembered for future re-use. If you enter the single character # in the command line, it will be substituted with the start/end line numbers of the select block. e.g  # could end up as .20 .30 if that were the previous selected line range.

start-line-number

This should specify the starting line number of a range. This will be either a simple numeric value, or, for those primary commands like FIND and CHANGE that also support column range operands, the value should be a dotted numeric to distinguish it from the column operand(s). e.g. .123 would describe line 000123.

start-label

This should be a valid label of an existing line to use as the start of range. e.g. .from.

end-line-number

This should specify the ending line number of a range. This will be either a simple numeric value, or, for those primary commands like FIND and CHANGE that also support column range operands, the value should be a dotted numeric to distinguish it from the column operand(s). e.g. .456 would describe line 000456.

end-label

This should be a valid label of an existing line to use as end of range. e.g. .to.

NOTE: If no end-line-number or end-label are provided, the starting line number is treated as a one line range.

:tag

This should be a valid tagname in the file. The 'range' of lines processed will be ALL lines which are currently tagged with the specified tagname. e.g. :XXX would refer to all lines which are marked with the :XXX tagname.