################# # EDIT MANUAL # ################# PER BRINCH HANSEN 14 AUGUST 1975 PURPOSE: EDITS AN ASCII FILE INPUT FROM A SOURCE MEDIUM AND OUTPUTS IT ON A DESTINATION MEDIUM. EDITING COMMANDS ARE INPUT FROM THE CONSOLE. THERE ARE ONLY TWO KINDS OF COMMANDS: DELETE ONE OR MORE LINES, AND COMPLETE THE COPYING OF THE SOURCE FILE. ANYTHING ELSE INPUT FROM THE CONSOLE IS APPENDED TO THE DESTINATION FILE AT ITS CURRENT POSITION. INITIALLY, THE DESTINATION FILE IS EMPTY. THE EDITOR IS ONLY ABLE TO DELETE AND INSERT COMPLETE LINES IDENTIFIED BY LINE NUMBERS. CALL: EDIT(FILE: IDENTIFIER) EDIT(SOURCE, DESTINATION: IDENTIFIER) THE COMMAND: EDIT(F) IS EQUIVALENT TO: EDIT(F, F). THE SOURCE CAN EITHER BE AN ASCII DISK FILE OR A SEQUENTIAL PROGRAM THAT INPUTS AN ASCII FILE. THE DESTINATION FILE CAN BE AN ASCII DISK FILE, A SEQUENTIAL PROGRAM THAT OUTPUTS AN ASCII FILE, OR A NON-EXISTING FILE. IN THE FIRST CASE, THE EXISTING FILE (WHICH MUST BE UNPROTECTED) IS REPLACED BY A NEW ONE OF THE SAME NAME. IN THE LAST CASE, A NEW FILE IS CREATED AND STORED ON DISK. IN BOTH CASES, THE RESULTING DISK FILE WILL BE AN UNPROTECTED ASCII FILE. DELETE COMMAND: DEL(LINENO: INTEGER) DEL(FIRSTLINE, LASTLINE: INTEGER) DEL(L) IS EQUIVALENT TO DEL(L, L). COPIES THE SOURCE FILE FROM THE CURRENT LINE NUMBER UP TO THE FIRST LINE - 1, AND DELETES THE FIRST LINE THROUGH THE LAST LINE INCLUSIVE. THE SOURCE LINES ARE NUMBERED 1, 2, 3, ... COMPLETE COMMAND: # COPIES THE SOURCE FILE FROM THE CURRENT LINE UP TO AND INCLUDING THE FINAL EM CHARACTER. INSERT COMMAND: ANY CONSOLE LINE THAT IS NEITHER A DELETE NOR A COMPLETE COMMAND IS IS APPENDED TO THE LAST LINE OUTPUT TO THE DESTINATION FILE. REPLACE COMMAND: SOURCE LINES CAN BE REPLACED BY DELETION FOLLOWED BY INSERTION. ERROR MESSAGES: LINE ALREADY PASSED THE FIRST LINE OF A DELETE COMMAND HAS ALREADY BEEN PASSED IN THE SOURCE FILE. LINE NUMBERS ILLEGAL THE FIRST LINE NUMBER IN A DELETE COMMAND IS GREATER THAN THE LAST LINE NUMBER. DESTINATION FILE LOST THE FILE PROGRAM CALLED BY EDIT FAILED TO CREATE OR REPLACE THE DESTINATION FILE DUE TO RUN-TIME ERRORS. E COMMAND IS IS APPENDED TO THE LAST LINE OUTPUT TO THE DESTINATION FILE. REPLACE COMMAND: SOURCE LINES CAN BE REPLACED BY DELETION FOLLOWED BY INSERTION. ERROR MESSAGES: LINE ALREADY PASSED THE FIRST LINE OF A DELETE COMMAND HAS ALREADY BEEN PASSED IN THE SOURCE FILE. LINE NUMBERS ILLEGAL THE FIRST LINE NUMBER IN A DELETE COMMAND IS GREATER THAN THE LAST LINE NUMBER. DESTINATION FILE L