Syntax


U[n]

UU / UU



Operands


n

The number of lines to be marked as User lines. If specified as 0 or omitted, 1 is assumed.


Description


User lines are a way to specially identify lines for further processing. They provide a selection technique for other commands to identify which lines are (or are not) to be processed. 


Conceptually, all data lines exist in one of two states:  Either they are "U lines" or they are "V lines", where U lines ("User lines") are a set of one or more lines of special interest at some particular time, and V lines are everything else. User lines are marked with a | vertical bar in the "gap column", and V lines are unmarked. The unmarked V lines are the same, ordinary data lines you have always worked with.

   

A file will ordinarily consist entirely of V lines, which is the default state of a file. Other that having one or the other of these U/V states, there is no difference between U and V lines and the data lines you have always worked with.


Just as you can use the X and NX keywords on primary commands to select between excluded or non-excluded lines, you can use the U and NU keywords on primary commands to select between User or non-User lines. 


Any primary command that accepts the X|NX option will accept the U|NU option.


The User line status is independent of other line characteristics. That means that any of these attributes may be applied to a line independently of each other:


    • a line can be excluded, or not excluded
    • a line can have a label, or not
    • a line can have a tag, or not
    • a line can be designated as a User line, or not


If you have set STATE ON for the file type you are editing, the User Line state of a file is persistent, so that the User/non-User state of the edit lines is retained when you close SPFLite and restart it later.


It is not an error to attempt to make a line into a User Line when it already is one. The request will be processed, and the state of the line will simply be unchanged.


To mark one or more lines as User lines:

1.

Type U in the line command area of the source code line that you wish to be marked as a User line. To mark lines following this one, type a number greater than 1 after the U command.  


2.

Press Enter.  


3.

The specified lines will be marked as User lines.  



To mark a block of lines as User lines:

1.

Type UU in the line command area of both the first and last source code lines that contain the lines that are to be marked. You can scroll (or use FIND or LOCATE) between typing the first UU and the second UU, if necessary.


2.

Press Enter.


3.

The specified lines that contain the two UU commands and in all of the lines between them are marked as User lines.



Example


(before):


000010 line ten

UU     line eleven

UU     line twelve

000013 line thirteen


After UU processing:


000010 line ten

000011|line eleven

000012|line twelve

000013 line thirteen


Note that the selected lines now contain a | vertical bar in the "gap column", the space between the line number and the data area.


This is your visual indication that these lines are marked as User lines.


See Working with User lines for more information.


Created with the Personal Edition of HelpNDoc: Make Documentation Review a Breeze with HelpNDoc's Advanced Project Analyzer