Text Editor User`s Manual
Contents
1. Brief mode can be entered in two ways The first way is via the BRief command and will affect all commands until Brief mode is exited via the Verbose command Brief suppression can also be obtained for a single command by issuing a dot immediately after the command i e F LOOP1 When a is entered during the execution of the Change or Print commands execution will stop until another is entered If an ESC is entered the command will abort and the editor will return to Edit mode The commands check for a or ESC after processing each line After an ESC is recognized the pointer is left at the last line processed Note this feature does not apply to the ZDS system The following notation is used in the command definitions in section 3 Portions of a modifier that are optional are enclosed in brackets The symbol for logical or is used if either option can be used i e DE n stringl can be expanded as DE n or DE string Parameters which can be repeated more than once are followed by an asterisk i e J amp command amp command RIO EDITOR COMMAND SUMMARY COMMAND ABBREVIATION A B BR DE GE PU PUTD COMMAND NAME Again Bottom Brief Change Delete Find Get Goto Input Join Lineno Locate Macro Next Print Put Put and Delete Quit Replace Top Up Verify Window Xecute COMMAND PARAMETERS of times old string new string of2. 1 line sgo to the bottom of the file WW J E NM UW why sinsert contents of the temporary file 0 NUI TFU MN 17 gt P 3 line 1 line 2 line 3 gt GET EXTRP ILE TEXT external line 5 gt T ToP line 1 line 2 line 3 external external external external external EOF gt line line line line line JI E Uw MN gt sprint 3 lines sinsert the contents of file sgo to the top of the file sprint all of the file 18 3 8 Goto n Function Moves the current line pointer to point to the line with the specified decimal line number n Examples gt P 5 sprint 5 lines line line line line line gt T go to the top of the file gt G 3 sgo to the third line in the file line gt UI Why WW 19 3 9 Input text line Function Inputs text into the file after the current line If a line of text is given it will be inserted Note that the text line must be separated from the command I by one blank Any additional blanks will be treated as part of the text line i e I line 1A will cause line 1A to be inserted whereas I line 1A will cause line 1A to be inserted If no line is specified the Editor will enter Input mode In this mode all text that is entered from the console is inserted after the current line Input mode is terminated when a null line is entered by typing just a carriage return Upon termination of the Input command the current line pointer points t
3. the PUt command the current line pointer is left at the line following the last line written Examples gt T sgo to the top of the file DP 5 sprint 5 lines line 1 line 2 line 3 line 4 line 5 gt T sgo back to the top T gt PUTD 3 sput and delete 3 lines into temporary file gt B sgo to bottom of file gt GE sinsert temporary file gt T sgo to the top of the file T gt P sprint all of the file Es pa 5 0 WN U1 E 28 3 18 QUIT Function Updates and closes the user file and returns control to the RIO executive Examples EDIT MYFILE EDIT gt sedit session gt QUIT supdate and close MYFILE return to RIO Executive 29 3 19 Replace text line Function Replaces the current line with the specified text If a line of text is given it will replace the line Note that the text line must be separated from the command R by one blank Any additional blanks will be treated as part of the text line i e R line 4A will cause line 4H4A to be inserted whereas R line 4A will cause line 4A to be inserted If no line is specified the Editor will enter Input mode In this mode all text that is entered from the console is inserted replacing the current line Input mode is terminated when a null line is entered by typing just a carriage return The current line pointer is left pointing to the last line input Examples gt P 2 sprint 2 lines line 4 line 5 gt r line HA replac
4. 280 RIO J Text Editor User s Manual nu asp pa pi 03 0074 00 Revision B Copyright O 1978 by Zilog Inc All rights reserved No part of this publication may be reproduced stored in a retrieval system or transmitted in any form or by any means electronic mechanical photocopying recording or otherwise without the prior written permission of Zilog Zilog assumes no responsibility for the use of any circuitry other than circuitry embodied in a Zilog product No other circuit patent licenses are implied Z80 RIO Text Editor Users Manual TABLE OF CONTENTS INTRODUCTION EDITING COMMANDS RIO EDITOR COMMAND SUMMARY COMMAND DEFINITIONS Sad Again 3 2 Bottom 33 Brief 3 4 Change 325 Delete 3 6 Find 367 Get 3 8 Goto 3 9 Input 3 10 Join 3 11 Lineno 3 12 Locate 3 13 Macro 3 14 Next 3415 Print 3 16 Put 3 17 Putd 3 18 Quit 3 19 Replace 3 20 Top Seek UD w gt 3 22 Verify 3 23 Window 3 24 Xecute 10 ra Ie sal 12 13 14 aks 16 17 19 20 pel 22 se 24 25 26 27 28 29 30 Aas pl 32 33 34 30 Other pertinent documentation with which the reader may want to become familiar include RIO Operating System User s Manual 1 INTRODUCTION The RIO Text Editor is a line oriented editor with string handling capability and automatic interface to the disk It uses a memory paging technique which allows any size text file to be edited The Editor a
5. Company and Address Your Position Department BUSINESS REPLY MAIL FIRST CLASS PERMIT NO 475 CUPERTINO CA POSTAGE WILL BE PAID BY Zilog Systems Publications Department 10411 Bubb Road Cupertino California 95014 NO POSTAGE NECESSARY IF MAILED UNITED STATES 3 rD tzi PAP E IEE EE APE E EE SPSRASHSSKRERSHSSHSSKRSSASSSTCATSS SASS AI AIUTA IRA SEAL PALA CUAD IA UDALA a Zilog Inc 10460 Bubb Road Cupertino California 95014 Telephone 408 446 4666 TWX 910 338 7621 Printed in USA
6. ate Next and Up command is suppressed Examples gt P sprint 1 line This is line 10 gt C 4 10 11 schange 10 to 11 This is line 11 sin Verbose mode line is printed after change gt BR senter Brief mode gt C 11 10 change 11 to 10 in Brief mode change does not print line gt P sprint 1 line This is line 10 gt 13 3 4 Change old string new string n1 n2 Function Locates old string within the range specified by n1 and n2 and replaces it with new string n1 specifies the number of lines in which old string should be looked for and changed n2 specifies the number of occurrences per line to be changed The Change command begins its search in the current line unlike the Find and Locate commands which begin the search in the next line If n1 and or n2 is not specified the default is one A can be used for n1 specifying that all lines from the current line on be changed or for n2 specifying that all occurrences in the specified lines be changed When in Verbose mode the line will be printed after the change has been made This is suppressed in Brief mode If new string is not given i e C old string old string will be deleted If old string is not found the message NO CHANGE will be output to the console and the command will terminate Upon termination of the Change command the current line pointer is left on the last line in which old string was looked for The ex
7. begins This file is a duplicate of the user file thus if the user file should get damaged during editing the user still has a copy of the original file This backup file is created with the same name as the user file but with an extension of OLD This extension will be in upper or lower case depending on the first letter of the user file name i e editing a file called MYFILE would cause the creation of a backup file MYFILE OLD whereas editing myfile would cause the creation of a backup file myfile old One of two options may be used when invoking the editor to either override the default name for the backup file or to suppress its creation entirely These options are called the OLD option O and No backup option N respectively The Editor is invoked from the RIO executive via the command EDIT filename options where filename is a standard RIO file name which may be fully or partially qualified where option is one of the following O filenamel specifying a name for the backup file N Specifying that no backup file should be created RL record length Specifying that the new file in hex should be created with the given record length If no filename is given the Editor will respond with NAME In this case the user should name a file to edit or enter a carriage return to return to the RIO executive If the specified file is not of type ASCII 20H the message INVALID ATTRIBUTES filename will be
8. between the second string delimiter and the file name Upon termination of the PUt command the current line pointer is left at the line following the last line written Examples gt PU 3 puts 3 lines into the temporary PUt GEt disk file gt PU A B sputs all lines until string A B is located into the temporary Put Get disk file gt PU 6 PUT FILE puts 6 lines into a file called PUT FILE which is created with a record length equal to 128 gt PU 6 PUT FILE RL 200 puts 6 lines into a file called PUT FILE which is created with a record length equal to 512 27 3 17 PUTD n string filename Function Writes onto a disk file starting with the current line n lines or lines up to the first occurrence of the specified string and deletes those lines from the user file If a file name is specified the PUt will be made to a file of this name If one already exists it will be erased and replaced by the new file If the file exists it must have a record length of less than or equal to 512 If it does not exist it will be created with a record length of 128 unless otherwise specified via the RL option Note m is specified in hex If the RL option is used m must be less than or equal to 200 hex If no name is specified the PUt will be made to the temporary Put Get file thus overwriting any text previously PUt there Note that there must be a space between the second string delimiter and the file name Upon termination of
9. command is a special case of the Locate command and is useful in locating labels in assembly language source Examples gt 5 print 5 lines LD A B ADD A C JR Z LOOP1 INC A LOOP1 LD D A gt U 4 sup 4 lines LD A B gt F LOOP1 find LOOP1 beginning in column 1 LOOP1 LD D A gt U 4 sup 4 lines LD A B L LOOP1 slocate LOOP1 in any column JR Z LOOP1 gt 16 3 7 GEt filename Function Reads a disk file and inserts its contents into the user file after the current line If no filename is specified the temporary PUT GET file created by a PUT or PUTD command is inserted If a filename is specified the entire contents of this file will be inserted The current line pointer is moved to the last line of the inserted file Note that it is not possible to insert just a part of a file with the GEt command This can be done however by PUT ting the desired portion onto a separate file and then Get ting this new file If a file name is specified the file must be of type ASCII with a record length of less than or equal to 512 If it is not the message INVALID ATTRIBUTES filename will be output to the console Examples gt P 5 sprint 5 lines line line line line line gt U 3 line gt PUT gt P line gt B line gt GET line gt T sgo to the top of the file T gt P sprint all of the file line line line line line line line EOF gt sgo up 3 lines put 2 lines into temporary file sprint
10. de and resumes the normal printing of the line of text following the Bottom Change Find Get Locate Next and Up commands Examples gt BR senter Brief mode gt N 3 sgo down 3 lines gt V sexit Brief mode gt N 3 go down 3 lines line 20 gt 33 3 23 Window Function Displays on the console the line numbers of the top and bottom lines of the current window This is useful because it allows the user to complete all editing in this window before editing lines that are not yet in memory thus reducing the need for unnecessary disk I O and therefore speeding up the editing function Examples gt W 1 0001 0500 gt 34 3 24 Xecute Function Causes the commands in the macro buffer to be executed Examples gt M amp U 3 amp P 6 amp initialize macro buffer gt P sprint 1 line line 30 gt X sexecute the commands in the macro buffer line 27 sup 3 line 27 sprint 6 line 28 line 29 line 30 line 31 line 32 gt 35 Y READER COMMENTS Y Your comments concerning this publication are important to us Please take the time to complete this questionnaire and return it to Zilog Zilog Title of Publicatieeenn Document Number Your Hardware Model and Memory Size Describe your likes dislikes concerning this document Technical Information Supporting Diagrams Ease of Use Your Name
11. e In this case the user may wish to DELETE the damaged user file create a new file with the Editor and then GEt the backup file EDIT MYFILE sinvoke Editor EDIT gt sedit session I O ERROR CH ON UNIT 04 sdisk error C4 on user file DELETE MYFILE DELETE 2 MYFILE Y N A Q Y sdelete user file EDIT MYFILE screate new file with Editor NEW FILE INPUT snull line EDIT gt GE MYFILE OLD sinsert contents of backup file last line gt sedit session gt QUIT supdate and close user file 2 EDITING COMMANDS The Editor currently offers 24 commands which are executed via a one or more letter code The commands may be issued in either upper case or lower case characters In the following summary the capital letter or letters indicates the minimum call for each command Again Find LIneno PUt Up Bottom GEt Locate PUTD Verify BRief Goto Macro QUIT Window Change Input Next Replace Xecute DElete Join Print Top There are two general forms of command modifiers which are used with many of the edit commands a number n or a string The first form a decimal number n indicates the number of times the command operation is to be repeated For example Print 15 would output 15 lines to the console The symbol can be used to indicate that the operation should be repeated over the entire range of the file beginning with the current line The second form is a string of characters between delimiters This form indicat
12. e current line with string line 4HA gt U sgo up 1 line line 4 gt P 2 sprint 2 lines line Y line 4A gt R sreplace the current line with what follows INPUT line YAA line YAB line Y4AC null line gt U 4 sgo up 4 lines line 3 gt P 5 sprint 5 lines line 3 line Y line Y4AA line YAB line HAC gt 30 3 20 Top Function Moves the current line pointer to the null line just above the first line of the user file Examples gt P 3 sprint 3 lines line 1 line 2 line 3 gt sgo to the top of the file T gt I line O sinsert string at top gt P 4 sprint 4 lines line line line line gt UN 0 31 3 21 Up ni string Function Moves the current line pointer to the line that is up n lines from the current line or the first line moving up which contains the specified string Note that Up will only work within the current window when using a string parameter If a line containing that string is not found the message STRING NOT IN BLOCK will be output to the console and the command will terminate leaving the pointer at the first line of the current window Examples gt P sprint 1 line line 10 gt U Y sup 4 lines line 6 gt U 3 sup to line containing 3 line 3 gt B sgo to bottom of file line 900 7 wU line 3 sup to line containing line 3 STRING NOT IN BLOCK sstring not found gt P sprint 1 line line 504 gt 32 3 22 Verify Function Exits Brief mo
13. ecution of the Change command may be temporarily or permanently halted on MCZ Systems via the or ESC mechanism described in section 2 Examples gt P sprint 1 line ADD A B gt C A B HL DE schange string A B to HL DE ADD HL DE gt P 4 sprint 4 lines line 110 line 111 line 112 line 113 gt U 3 sup 3 lines line 110 gt C 1 2 3 2 Change first 2 occurrences of 1 to 2 in next 3 lines line 220 line 221 note only 2 occurrences changed line 222 gt T g0 to top of file T gt C IX IY change every occurrence of IX to IY 14 3 5 DElete ni string Function Deletes lines from the file beginning with the current line If n is specified n lines will be deleted If a String is specified all lines up to but not including the line containing the specified string will be deleted After deleting the current line pointer is left on the line after the last line deleted Examples gt P 5 sprint 5 lines line line line line line gt U 4 sup 4 lines line gt DE 2 sdelete 2 lines gt P sprint 1 line line 3 gt UU NN gt P 5 sprint 5 lines line line line line line gt U 4 sup 4 lines line 1 gt DE 2 sdeletes up to first line containing 2 gt P sprint 1 line line 2 UE OU N 15 3 6 Find string Function Moves the current line pointer to the first line following the current line which contains the specified string beginning in column one This
14. es that the command should repeat until the string is found For example Print LD A B would print the current line and each following line until it printed the line containing the first occurrence of the string LD A B A delimiter is defined as the first nonblank nonnumeric character in the modifier The string may contain any character except for the delimiter The second delimiter is optional In the following discussion the character is used to represent any valid delimiter If the string is not found in the current window the message STRING NOT IN BLOCK PROCEED will be output to the console If a Y is entered the command will execute on the current window and the next block will be brought in from the disk Otherwise the command will terminate leaving the pointer pointing to the current line When using the string modifier with the Up command only the first message will be output and the option to proceed will not be given The pointer will be left on the current line These modifiers are used with the following commands Delete Next Print PUt PUTD Up In general commands and modifiers must be separated by at least one or more blanks The Editor has two modes Brief and Verbose which affect the Bottom Change Find Goto Get Locate Next and Up commands When in Verbose mode the default mode a line of text is output following each of these commands When in Brief mode this printing is suppressed
15. go down 5 lines line 8 gt T sgo to top of file 1 gt P 2 sprint 2 lines line O line 1 gt N 3 sgo down to line containing 3 line 3 gt 25 3 15 Print En string Function Prints beginning at the current line the next n lines or until the first occurrence of the specified string Upon termination of the command the current line pointer is left on the last printed line The Print command can be temporarily or permanently halted via the and ESC mechanism described in section 2 Examples gt P 3 sprint 3 lines line 1 line 2 line 3 gt P T sprint until the string 7 is found line line line line line gt N OV OT FW 26 3 16 PUt n stringl filenamel RL m Function Writes onto a disk file starting with the current line n lines or lines up to but not including the first occurrence of the specified string If a file name is specified the PUt will be made to a file of this name If one already exists it will be erased and replaced by the new file If the file exists it must have a record length of less than or equal to 512 If it does not exist it will be created with a record length of 128 unless otherwise specified via the RL option Note m is specified in hex If the RL option is used m must be less than or equal to 200H If no name is specified the PUt will be made to the temporary Put Get file thus overwritting any text previously PUt there Note that there must be a space
16. line which contains the specified string Examples gt L 200 slocate string 200 LD HL 200H gt A locate it again STRING NOT IN BLOCK PROCEED gt Y slook in next block LD DE 200H gt A sand again STRING NOT IN BLOCK PROCEED gt N sterminate command ADD HL DE slast line of block gt 23 3 13 Macro amp command amp command Function Causes the specified sequence of commands to be loaded into the macro buffer to be executed each time the Xecute command is issued Any number of commands can be concatenated as long as they fit on a single line 512 characters Note that spaces are not allowed between commands and the delimiting character Any character may be used as a delimiter however it may not occur in any of the commands When the editor is first initialized the macro buffer contains the commands U 6 P 12 Thus issuing the Xecute command before a Macro command will cause these commands to be executed Examples gt M amp T amp L A B amp C A B A C sinitialize macro buffer gt P 5 sprint 5 lines LOOP LD A HL ADD A B INC HL DEC B gt U 10 sup 10 lines JR NZ LOOP gt X xecute contents of macro buffer T Top command ADD A B sLocate command ADD A C Change command gt 24 3 14 Next Cni string Function Causes the current line pointer to be moved down n lines or to the first line which contains the specified string Examples gt P sprint 1 line line 3 gt N 5 s
17. lines of times per line of lines i string string filename line text line amp command amp command amp string amp command amp command amp line i string of lines string of lines i string filename record length of lines stringl filename record length text line of lines string 10 3 COMMAND DEFINITIONS 3 1 Again n Function Repeats the previous command n times If n is not specified the previous command is repeated once When the Again command is issued after a Join or Xecute command only the last specifed single command will be repeated Examples gt P 3 sprint 3 lines line line line gt A line line line gt J amp U H amp P 48 s join command up 4 print 4 line sup Y lines line sprint Y lines line line line gt A line line line line gt sprint another 3 lines JI EU UD MN repeat last command print 4 Ou E HU MN 11 3 2 Bottom Funetion Moves the current line pointer to the last line of the file and prints the line on the console If Brief mode has been set the printing of the last line will be suppressed Examples gt B move pointer to bottom of file last line gt N snext line EOF gt 12 3 3 Brief Function Causes the editor to enter Brief mode in which the normal printing of the line of text following the Bottom Change Find Goto Get Loc
18. o the last line input Examples gt p sprint 1 line line 1 gt I line 1A sinsert line 1A into text gt P sprint 1 line gt I senter Input mode line 1C line 1D null line EDIT gt T sgo to top of file T gt P sprint all of file line 1 7 line 14 line 1B line 1C line 1D EOF gt 20 3 10 Join amp command amp command Function Causes the specified sequence of commands to be executed as soon as the carriage return is received Join is similar to the Macro command immediately followed by an Xecute command Any number of commands can be concatenated as long as they fit on a single line 512 characters Spaces are not allowed between the commands and delimiters Any delimiter may be used however it must not occur in any of the commands Examples gt J T L LOOP1 C 1 2 U 3 P 5 T Top command LOOP 1 sLocate command LOOP 2 sChange command LD A B sUp command LD A B s Print command DEC B JR Z LOOP3 LOOP2 DEC BC gt A srepeat last command DEC BC Print command LD A HL CP ASCICR JR NZ LOOP2 JR END gt 21 3 11 Lineno Function Prints the line number of the current line This command can be used with the Goto command to operate the editor on a line number concept Examples gt P sprint 1 line line number 10 gt LI determine line number 10 gt 22 3 12 Locate string Function Moves the current line pointer to the first line following the current
19. output to the console This message is also output if a file specified in the GEt command has an invalid type or record length If the named file does not exist it will be created and the Editor will output the message NEW FILE INPUT and enter Input mode If the file already exists the Editor will create the backup file and then output the message EDIT EXAMPLES Creating a new file with the Editor ZEDIT MYFILE RL 400 sMYFILE does not exist and is created with a record length of 400 hex NEW FILE INPUT sinput text snull line EDIT edit mode gt QUIT supdate and close user file Editing an already existing file with a default backup file ZEDIT MYFILE sMYFILE exists EDIT backup MYFILE OLD created gt edit session gt QUIT supdate and close user file Editing an already existing file using the Old option EDIT MYFILE O YDOS 2 BACKUP MYFILE exists EDIT backup file BACKUP is created under file system YDOS on drive 2 sedit session gt QUIT supdate and close user file Editing an already existing file using the No backup option EDIT MYFILE N sMYFILE exists EDIT sno backup file created gt sedit session gt QUIT supdate and close MYFILE If a disk error occurs during an operation on either the user file or backup file the Editor closes the files and returns to the RIO Executive At this time a message I O ERROR xx ON UNIT yy will be output to the console where x
20. utomatically determines the work space available and brings blocks of text into its memory buffer as required by the command issued The portion of the user s file which is contained within this memory buffer is called the window If a command is issued that operates on text which is not in the window the Editor will write out the memory buffer onto disk and read the next sequential block of text into the window This action is referred to as rolling The Editor rolls blocks of text in and out of the window until the required one is found The Editor maintains a current line pointer which points to the line last referenced At the beginning of the editing session this pointer points to a null line at the top of the file After executing each command the Editor will respond with a prompt gt to indicate that a new command should be issued Note that in Input mode no prompt is output The Editor can handle lines up to a maximum length of 512 characters The Editor can be used to create a new text file or to modify an already existing one If the Editor is given a file name which does not exist in the disk directory it will create a new file with the specified name and then automatically enter Input mode see Input command definition This file will be created with a record length of 128 bytes unless otherwise specified in the RL option If the specified file already exists a backup file is created before the editing session
21. x is the error return code see RIO Software User s Manual and yy is the logical unit number 04 for the user file 05 for the backup file The editor environment is exited via the QUIT command This command will cause the user file to be updated and closed and will then return to the RIO Executive If the user file was damaged during the editing session via disk errors or misuse of editing commands the user may wish to QUIT and begin again This can be done in several ways Following is a description of three methods with an example for each One method is to QUIT from the Editor environment DELETE the user file and then RENAME the backup file EDIT MYFILE sinvoke Editor EDIT gt sedit session gt QUIT quit edit environment DELETE MYFILE delete the user file DELETE 2 MYFILE Y N A Q 27Y RENAME MYFILE OLD MYFILE srename backup file MYFILE OLD gt MYFILE Another method is to remain in the Editor environment DElete all of the lines in the user file backup file EDIT MYFILE EDIT gt gt T T gt DE gt GE MYFILE OLD last line gt SQUIT 7 sinvoke and then GEt the Editor sedit session sgo to the top of the file delete in the insert backup all of the lines file contents of the file scontinue edit session sclose and update user file If a disk error occurs while operating on the user file the Editor will automatically return to the RIO Executiv
Download Pdf Manuals
Related Search