1000#COMMENT THIS IS USERMAN3 1020\ %1040
1080[(Note to users: This section provides a summary of the >1100commands we have explained throughout this document. It =1120uses sutstitute words that programmers call PARAMETERS. ;1140The parameters are ¬& to be taken literally. They ?1160should be replaced by real values and words that apply to <1180the work that you are doing. Each paragraph explaines :1200what kinds of parameters the command is expecting.)] 1220 1240 -1260APPEND FILENAME(,OPTIONAL DRIVE NUMBER) 1280>5 @1300[This command will load a file named "FILENAME" from disk. :1320The optional disk drive number is used when the file 11340resides on a disk drive other than drive 1. 51360The FREE command will automatically be executed D1380to show the amount of storage used. The file will be APPENDed A1400to the end of the current file in memory. The line numbers =1420of the APPENDed file do not have to follow those of the <1440existing file, but a RENUMBER will have to be done to %1460edit the file correctly later.] 1480> #1500AUTO LN1(,OPTIONAL INCREMENT) 1520>5 @1540[Automatic line numbers will be generated until a carriage )1560return is entered without any text. >1580LN1 is the starting line number. The increment for each C1600succeeding line is optional and will default to 5 if missing. ?1620Caution! If it generates a line number for a line already ?1640in the file, the line in the file will be replaced. This =1660command is terminated when no text is added to the line ;1680and a null line is entered, or control-C is entered.] 1700> 1720BLOAD BASIC-PROGRAM-NAME 1740>5 B1760[This command will load a North Star BASIC program from disk K1780while converting it to SECRETARY format and place it in the data area N1800to be edited with SECRETARY. The line numbers in the program should not 1820exceed 9999.] 1840> 1860BSAVE BASIC-PROGRAM-NAME 1880>5 N1900[This command will take a SECRETARY formatted file in memory, convert it M1920to North Star BASIC format, and write it to disk in BASIC-PROGRAM-NAME. P1940Be sure that the disk file is already created, it is a type 2 file, and it M1960is large enough to hold any changes that you may have added. Since the N1980conversion requires scanning a large token table, the program may take a -2000minute or two to perform this command.] 2020> 2040\ 2060CALL ADDR1 HEX1 2080>5 F2100[This command will allow the user to process a print line during H2120PRINT command execution before it is passed to the output routine. %2140This command could be used for A2160justifying for special printers such as QUME. ADDR1 is the K2180hexidecimal address of the user's routine which will be CALLed. HEX1 K2200is the hexidecimal value, which if it appears in the line, will cause H2220the user's routine to be executed. If all lines are to be passed, J2240HEX1 should be 0D. If no lines are to be passed, HEX1 should be 00. H2260When the user's routine is called, HL contains the address of the A2280print line buffer. The line ends with 0D. When the user's K2300routine returns, DE should contain the address of the new print line. E2320Registers B, C, and A need not be saved. A sample test routine .2340is contained within SECRETARY at 2D33H.] 2360> 2380CHAIN FILENAME 2400>5 G2420[This command will load and automatically begin printing the file G2440named FILENAME. It is useful to imbed this command at the end of Q2460a data file to load and print files continuously as if they were one file.] 2480> 2500CHNG TEXT1^TEXT2 2520>5, 32540[This command will scan the data area for the D2560string TEXT1, replace it with the string TEXT2, print the line E2580and wait for a reply. The only replies accepted are a carriage @2600return to accept the changed line and replace that line in =2620the file, control-A to not replace the changed line, or B2640control-C to cancel the command. The up-arrow is required, B2660but if no data follows the arrow, optional TEXT2, the string >2680TEXT1 will be deleted. The entire file will be scanned @2700for all occurrences of the string TEXT1. TEXT1 should not 2720be a substring of TEXT2.] 2740> 2760CHALL TEXT1^TEXT2 2780>5 B2800[This command will replace TEXT1 with TEXT2 similar to CHNG, H2820but will not print the line and wait for a reply. All occurrences :2840of TEXT1 will be changed automatically in the file.] 2860> 2880CONFIGURE 2900>5, F2920[This command initiates the series of questions which customizes F2940the program for your system. For a list of the questions asked, 2960see Section 1 Part 1.] 2980> 3000COPY LN1,LN2,LN3 3020>5 B3040[Copy the text lines starting with LN1 thru LN2. The copied >3060line numbers will begin with line number LN3 and will be 3080incremented by 1.] 3100> 3120DELETE LN1(,optional LN2) 3140DELT LN1(,optional LN2) 3160>5 F3180[Delete line LN1. If LN2 is present, delete lines LN1 thru LN2.] 3200> 3220DESTROY FILENAME 3240>5 E3260[This command will delete the file named FILENAME form the disk 3280directory.] 3300> '3320DIRECTORY (OPTIONAL DRIVE NUMBER) 3340>5, A3360[This causes DOS to list the disk directory. If the drive 83380number is not specified, drive 1 will be assumed.] 3400> 3420\ 3440DUMP ADDR1,ADDR2 3460>5 =3480[This command is not of much value to the average user, A3500but it is included here for diagnostic purposes and for the 13520more technical user. DUMP will display the 23540contents of memory in hexidecimal and ASCII. 83560ADDR1 is the beginning memory address and ADDR2 is Q3580the ending memory address to display. The unit number for the dump will be J3600requested and a 132 character print line is required. The data area >3620begins around 603BH. The addresses are in hexidecimal.] 3640> 3660EDIT LN1 3680>5 E3700[Edit line number LN1 according to specific control characters. @3720See the section on "EDITING A LINE OF TEXT" for a complete -3740description of the control characters.] 3760> 3780EXPAND 3800>5 K3820[The BLOAD, BSAVE, and CONFIGURE commands have been put at the end of P3840SECRETARY. By entering the command EXPAND, you can destroy these commands M3860and expand the data area by about 2K. &CAUTION. Do not save a copy of O3880the program after entering EXPAND or you will permanently lose the BSAVE, O3900BLOAD, and CONFIGURE commands. BE SURE TO SAVE ANY TEXT IN THE DATA AREA N3920BEFORE ENTERING EXPAND. ANY TEXT IN THE DATA AREA AFTER ENTERING EXPAND "3940WILL BE PERMANENTLY LOST.& ] 3960> 3980FIND TEXT1 4000>5 E4020[This command will scan the entire data area and search for any C4040occurrences of the string TEXT1. The character string begins >4060with the first non-blank character following the command ?4080"FIND" and ends with the character preceding the carriage A4100return. All lines containing the text will be printed, but B4120the file will not be changed. This command can be cancelled )4140at any time by entering control-C.] 4160> 4180FREE 4200>5 *4220[This command will cause the message >4240USED: N1 AVAILABLE: N2 LAST LINE: N3 BLOCKS: N4 to be A4260printed. N1 is the number of characters in use in the data @4280area (in decimal). N2 is the number of characters free or A4300remaining unused in the data area (in decimal). N3 is the =4320last line number in the data area. N4 is the number of 54340blocks required to save this file on the disk.] 4360> 4380HELP 4400>5 >4420[This command will list the first four characters of all ?4440of the valid commands. This is done automatically if you 4460enter an invalid command.] 4480> 4500JUSTIFY 4520JUSTIFY ON 4540JUSTIFY OFF 4560>5 ?4580[JUSTIFY with nothing following, or with an illegal value =4600following, will print the status of the justify switch. 24620JUSTIFY ON will set the justify switch on. ?4640JUSTIFY OFF will set the justify switch off. The justify B4660switch determines whether or not the text will be justified ;4680in addition to line filled during the PRINT command.] 4700> 4720\ 4740LINE P1 4760>5 B4780[This command specifies the length of the output line during A4800the PRINT command. The initial value is 70 and the maximum ;4820length, the value of P1, is 132 characters per line.] 4840> (4860LIST (OPTIONAL LN1)(,OPTIONAL LN2) 4880>5 @4900[This command will cause the entire data area to be listed E4920with line numbers. If the optional line number LN1 is entered, B4940the listing will begin at that line. If LN2 is entered, the 94960listing will end with line LN2. The listing can be >4980cancelled with a control-C. The unit and space features <5000are used with this command (see their descriptions for 5020details).] 5040> +5060LOAD FILENAME(,OPTIONAL DRIVE NUMBER) 5080>5 B5100[This command will load a file named "FILENAME" from disk. :5120The optional disk drive number is used when the file 15140resides on a disk drive other than drive 1. 55160The FREE command will automatically be executed *5180to show the amount of storage used.] 5200> 5220MARGIN P1,P2 5240>5 ;5260[This command sets the beginning and ending positions @5280of the text on the page. P1 is the starting column of the 15300first character and P2 is the ending column )5320of the last character on the line.] 5340> ,5360MERGE FILENAME(,OPTIONAL DRIVE NUMBER) 5380>5, ;5400[This command will load the BASIC data file FILENAME, C5420read the first sector, and prepare to merge the data into the 5440text file.] 5460> 5480MOVE LN1,LN2,LN3 5500>5 A5520[This command is similar to the COPY command. Line numbers B5540LN1 thru LN2 will be copied beginning at LN3 and incremented =5560by 1. Then line numbers LN1 thru LN2 will be deleted.] 5580> C5600NSAVE FILENAME(,OPTIONAL DRIVE NUMBER) (OPTIONAL # OF BLOCKS) 5620>5 >5640[This command will save a file named "FILENAME" on disk. :5660The optional disk drive number is used when the file 15680resides on a disk drive other than drive 1. <5700The file size should not be greater than the data area ?5720or SECRETARY may not be able to load the file back later. ;5740This command both creates a file and saves the data.] 5760> 5780NULL P1 5800>5 =5820[P1 is the number of null characters (00H) that will be 05840generated following each carriage return.] 5860> 5880OFFSET P1 5900>5 C5920[P1 is the number of characters that the entire page is moved 5940to the right.] 5960> '5980OPEN LN1,LN2(,OPTIONAL INCREMENT) 6000>5 >6020[This command "opens up" line numbers so that additional @6040lines can be added without destroying lines already there. B6060It effectively renumbers all of the lines beginning with LN1 H6080and using LN2 as the first line number. If the optional increment D6100is present, it will be used to increment each succeeding line, 46120otherwise each line will be incremented by 1.] 6140> 6160\ 6180PAGE P1,P2,P3 6200>5 D6220[This command defines a page for the PRINT command. P1 is the ;6240maximum lines per page and defaults to 66. P2 is the :6260number of printed lines per page and defaults to 54. B6280P3 is the line number of the first line of text and defaults 6300to 7.] 6320> 6340PNUM P1 6360>5 J6380[P1 is the starting page number of the printed text. If P1 is zero, L6400the pages will be numbered starting with page 1 but the page numbers G6420and title will be first printed on page 2. If P1 is 1, the pages E6440will be numbered starting with page 1, and the page numbers and F6460title will be first printed on page 1. If P1 is greater than 1, <6480P1 will be the page number used on the first page etc. 76500If P1 is greater than 250 and less than 255, omit 6520all page numbers.] 6540> 6560PRINT (OPTIONAL LN1) 6580>5 @6600[This command causes the data area to be printed using the ?6620word processing features and eliminating line numbers and A6640control characters. Titles, page numbers, page formatting, A6660line fill, and justification are handled with this command. >6680See the section on "WORD PROCESSING FEATURES" for a full H6700description. If LN1 is present, printing will begin at line LN1.] 6720> 6740QUIT 86760 This terminates the editor and returns to DOS. 6780RECOVER 6800>5 D6820[Try to salvage the data area destroyed by SCRATCH, CONFIGURE, 16840JP 2D00, or disk or memory hardware error.] 6860> '6880RENUMBER LN1(,OPTIONAL INCREMENT) 6900>5 D6920[Renumber the data area starting with line number LN1. If the B6940optional increment is present, each line will be incremented D6960by that value; otherwise, each line will be incremented by 5.] 6980> 7000REPEAT P1 7020>5 C7040[During the PRINT command operation, print the entire text P1 ;7060times. This command is used to get multiple copies.] 7080> +7100SAVE FILENAME(,OPTIONAL DRIVE NUMBER) 7120>5 57140[This command will save a file named "FILENAME" "7160on an existing file on disk. :7180The optional disk drive number is used when the file 17200resides on a disk drive other than drive 1. >7220Should the text now be larger than will fit in the file, :7240a "FILE TOO SMALL" message will appear. The easiest <7260procedure is to NSAVE the text under a new file name.] 7280> 7300SCRATCH 7320>5 C7340[Delete the existing text and reset the system in preparation 7360to enter a new text.] 7380> 7400\ 7420SPACE P1 7440>5 C7460[Set the line spacing for the LIST and PRINT command. Single <7480space if P1 is zero or one; otherwise space P1 lines.] 7500> 7520TABSET N1,N2,N3...N10 7540>5 M7560[This command sets from 1 to 10 tabs where N1... is the column location C7580of each tab. The tabs must be in ascending order and must be D7600separated by a comma. Use of this command supercedes any tabs E7620previously set. The tabs can be cleared by entering TABSET 0.] 7640> 7660TITLE TEXT1 7680>5 "7700[Set the title to be printed <7720during the print operation. The title begins with the D7740first non-blank character following the command TITLE and ends ,7760with the carriage return. The maximum ,7780length of the title is 50 characters.] 7800> 7820UNIT P1 7840>5 ?7860[Since many installations have a printer in addition to a ?7880terminal, the LIST and PRINT commands may need the output A7900directed to the faster printer. The UNIT command sets up a @7920unit number P1 which will be placed in the accumulator and D7940passed to the DOS output routine for routing the character to B7960the proper printer. If the unit is zero, the LIST and PRINT @7980commands will come on the CRT and display only a few lines :8000at a time depending on the screen size. If the unit 18020is nonzero, the LIST or PRINT will be typed 8040uninterrupted.] 8060> 8080 8100#CHAIN USERMAN4