REVERT - Revert User Line to Ordinary Line
Syntax
REVERT |
[string] [ CHAR | WORD | PREFIX | SUFFIX ] [ C ] [ Q ] [ T ] [ start-column [ end-column ] ] [ line-control-range ] [ color-selection-criteria ] [ MX | DX ] [ X | NX ] [ ALL ] [ TOP ] |
Operands
string |
The string operand is optional. If provided, it requests a search, like FIND, to locate the lines to be un-marked as User lines. If not provided, then the line-control-range specification will be used to select lines. |
||
CHAR |
Locates search-string regardless of what precedes or follows it. |
||
WORD |
Locates search-string when it is delimited on both sides by blanks or other non-Word characters. |
||
PREFIX |
Locates search-string at the beginning of a word. |
||
SUFFIX |
Locates search-string at the end of a word |
||
|
|
||
start-column |
Left column of a range (with end-column) within which the search-string value must be found. If no end-column operand, then the search-string operand must be found starting in start-col. |
||
end-column |
Right column of a range (with start-column) within which the search-string value must be found. |
||
line-control-range |
The range of lines which are to be processed by the command. Line control ranges provide a powerful tool to customize the range of lines to be processed. The full syntax and allowable operands which make up a line control range are discussed in "Line Control Range Specification". Refer to that section of the documentation for details. |
||
color-selection-criteria |
A request for selection based on the highlight color of the search-string. Color requests provide another powerful tool to control search selection. The full syntax and allowable operands which make up a color-selection-criteria are discussed in "Color Selection Criteria Specification". Refer to that section of the documentation for details. |
||
ALL |
All lines in the line range are processed. |
||
X | NX |
Specifies a subset of the line range to be processed. X requests only excluded lines are to be processed, NX requests only non-excluded lines are to be processed. If neither X or NX are specified, all lines in the range will be eligible to be processed. |
||
MX |
MX requests that all lines which DO contain search-string be excluded from the display following command processing. MX = Make Excluded. |
||
DX |
DX requests that lines which DO contain search-string, which, if excluded, would normally be made visible, be left in their excluded status. DX = Don't change Excluded status |
||
TOP |
|
Abbreviations and Aliases
REVERT can also be spelled as VV
PREFIX can also be spelled as PRE or PFX
SUFFIX can also be spelled as SUF or SFX
WORDS can also be spelled as WORD
CHARS can also be spelled as CHAR
Description
REVERT will remove ("revert") the User Line status from all lines which meet the specified criteria. This is an alternative method to using the V / VV line commands to remove the User Line status of selected lines.
When a U line reverts to an ordinary V line, the | vertical bar that marks the "gap column" will disappear.
Example uses of the REVERT command
To revert all User Lines from label .FROM to label .TO back to "ordinary" V lines:
REVERT ALL .FROM .TO
To revert all User Lines containing the string TWO back to "ordinary" V lines:
REVERT ALL "TWO"
To revert all User Lines containing the word TEST between columns 5 and 10, and which are not highlighted in BLUE, back to "ordinary" V lines:
REVERT "TEST" WORD 5 10 -BLUE ALL
For more information on User lines see "Working with User lines"
Created with the Personal Edition of HelpNDoc: Import and export Markdown documents