DROP - Delete Specified Lines in a Tag Group

Syntax


DROP

line-tag

[ FIRST | LAST | ALL ]


Operands


line-tag

The specific line tag identifying the line tag blocks which are to be processed by the command.  Line tags are a method of marking possibly noncontiguous lines as belonging to a related 'group'.  A full discussion of line tags and how to use them is in "Working with Line Tags" .


FIRST

only the first line in each tag block is deleted; all other lines in each tag block are kept


LAST

only the last line in each tag block is deleted; all other lines in each tag block are kept


ALL

all lines in each tag block are deleted; all other lines tagged with line-tag which are not part of a tag group (2 or more adjacent lines) will remain.


Description


The DROP command only pertains to "proper" tag-blocks, which are contiguous groups of 2 or more lines having the same line tag.  When such a block is ‘dropped', one or more lines are deleted from the block.  When multiple tag blocks having the same tag exist, each tag block is processed independently.  The DROP command applies its processing to every tag block in the entire edit file having the specified line tag.


A lone line having a tag which is not adjacent to another line having the same tag is not considered a proper tag-block, and will be ignored by the DROP command.


Created with the Personal Edition of HelpNDoc: Free EPub producer