Radio Shack TRS-80 Model II Reference Manual page 42

Library Commands
Editing Existing BUILD-Files
When you specify an existing file in the BUILD command, TRSDOS assumes
you want to edit that file. Before starting the edit, it copies the file into a new
file with the same name but with the extension/OLD. That way, you will have a
backup copy of the file as it was before being edited.
Note: Editing an existing BUILD-file requires that you have write-access to
the file. That is, if the access password has a protection level which does not
allow writing, then you must supply the update password.
Example
Suppose the file STARTER already exists, and you type the command:
BUIL.D STARTER
TRSDOS will first copy STARTER into a new file STARTER/OLD (if
STARTER/OLD already exists, previous contents are lost). Then it will let you
begin editing the file. As you edit the file, the updated lines will be written
into STARTER.
BUILD will display the existing contents of the file, one line at a time. Beneath
the line is an option list:
h~f~P' D~':!l<.':~b'?, I:~~plac~, In~::.er·t or'
G!uit?
ENTER (h/D/R/I/Q) .. ?
Type the first letter of the desired option and press
IF1:U301 .
Keep Option: Copies the line as-is into the new file, and displays the next line
for editing.
Delete Option: Deletes the line by not copying it into the new file, and
displays the next line for editing.
Insert Option: Allows you to insert lines ahead of the line being displayed.
Using this option is like entering lines into a new file as described above.
After you press , TRSDOS will give you a chance to erase and re-
start the insert line, or to store the insert line. Press
1m
to erase. lij:Uiifil
to store it. You can then insert another line.
To stop inserting, press
13m#1;1
at the beginning of the line. TRSDOS will
then display the next line and the option list.
Replace Option: Deletes the displayed line and lets you insert replacement
lines. Entering replacement lines is like entering lines with the insert option.
Press at the beginning of a line to stop inserting. TRSDOS will
display the next line and the option list.
75