ftp.barnyard.co.uk/2015.02.ftp.barnyard.co.uk.tar/ftp.barnyard.co.uk/cpm/walnut-creek-CDROM/SIMTEL/CPMUG/CPMUG092.ARK/USERMAN2.TXT

Text File | 1986-10-18 | 19KB | 370 lines

1000#COMMENT THIS IS USERMAN2
1020\
)1040PART 4.  ADVANCED FILE MANIPULATION
1060
1080
1100A) THE FIND COMMAND
F1120[As you are entering the text, you noticed that you just spelled
@1140license LISENCE and you want to know how many other places
,1160you have spelled it like that.  Enter]
1180<FIND LISENCE
K1200[SECRETARY will search the file for the text beginning with the first
J1220nonblank character after the word FIND and ending with the character
:1240preceding the carriage return.  All lines containing
>1260that text string will be printed.  You can terminate the
>1280search by entering control-C.  If the text is not found,
1300SECRETARY will print
1320"CHAR NOT FOUND".]
1340
1360B) THE CHANGE COMMANDS
J1380[Now you want to replace all occurrences of the misspelled word with
#1400the correct spelling.  Enter]
0<CHAL LISENCE^LICENSE
?1440[SECRETARY will search for all occurrences of LISENCE and
P1460replace it with LICENSE.  The up arrow separates the text string that you
H1480are searching for from the text string that you are replacing.  If
N1500you want to delete a text string, enter the string to search for, the up
A1520arrow, and a carriage return without the replacing string.]
1540<CHAL DELETE THIS STRING^
P1560[If you do not want to change all occurrences, but you may want to replace
+1580some depending on the context, enter]
0<CHNG LISENCE^LICENSE
E1620[Each time LISENCE is found, it will be replaced by LICENSE and
L1640the line will be printed.  If you do want to have the new line replace
O1660the current line, enter a carriage return.  If you do not want the change
K1680to take effect, enter control-A.  If you want to terminate the change
J1700without replacing the line just printed, enter control-C.  All other
41720characters that you may enter will be ignored.
?1740After the first occurrence has been replaced, the line is
81760rescanned for any other occurrences of the string.
;1780Therefore do not replace a phrase with another phrase
<1800which contains the original pharse i.e. do not replace
=1820X with XY or the result will be an entire line of Y's.
H1840If you must change X to XY, do it in two steps.  First change X to
!1860something obscure like $+=.
1880Then change $+= to XY.]
1900
1920C) THE MOVE COMMAND
O1940[After reading over the text that you have entered, you decide that lines
R1960200 through 230 would sound better after line 450.  You can move these lines
1980by entering]
2000<MOVE 200,230,451
F2020[Lines 200 through 230 will be copied starting with line 451 and
P2040incremented by 1.  Then lines 200 through 230 will be deleted.  Note that
Q2060if there was a line 451 or 452, it would be replaced by the text of 200 and
72080230.  To move only a single line like 200, enter]
2100<MOVE 200,200,451
2120\
2140D) THE COPY COMMAND
J2160[If you want to copy the lines without deleting the old ones, enter]
2180<COPY 200,230,451
:2200[This is just like the MOVE but without the delete.]
2220
2240E) THE EDIT COMMAND
/2260     [SECRETARY provides the same control
=2280characters for making changes to lines that programmers
>2300use when they are writing a program in North Star BASIC.
>2320The process of making these changes is called "editing".
:2340The commands themselves are called the "Line Editor"
2360portion of the program.]
;2380    [To edit (make changes to) a line, you must FIRST
/2400specify which line to change as follows:]
2420<EDIT 230
@2440    [Notice that the computer will do a return to the left
@2460side of the page but does not print the usual prompt of #.
B2480This is because it now awaits one of the commands below or a
B2500carriage return only which says to cancel the edit operation
@2520while leaving line 230 as it was.  If you have edited part
>2540of the line and you wish to cancel the process and leave
*2560the line as it is, enter control-C.]
?2580    [After you have entered EDIT 230, and the printer has
82600positioned down to the beginning of the next line,
;2620hold down the CTRL button with one finger, then press
A2640the appropriate button with another finger for the command.
B2660Now release both fingers and follow any further instructions
2680below for that command.
0Once completed, enter
@2720carriage return to tell the computer to accept the line as
12740you have changed it.  To verify that it has
62760been changed, you can list the line by entering]
2780<LIST 230,230
(2800 The valid control characters are:
"2840CONTROL-A Copy one character
E2860CONTROL-G Copy the remaining portion of the old line to the end
 2880          of the new line.
H2900CONTROL-D Copy up to a specific character.  This control character
J2920          requires a second character to be entered.  SECRETARY will
I2940          scan the old line for this second character, and if it is
F2960          found, copy all the characters up to but not including
D2980          the second character to the new line.  If the second
C3000          occurrence of a character is to be found, control-A
?3020          must be used to copy the first character before
,3040          control-D can be used again.
G3060CONTROL-Z Delete one character from the old line.  A percent sign
H3080          is echoed back to indicate a character has been deleted.
'3100CONTROL-Q Backspace one character
J3120          You can also backspace with the character that you defined
+3140          as the backspace character.
I3160CONTROL-Y Toggle insert mode.  The first time control-Y is entered,
I3180          the new line is "opened up" and all subsequent characters
H3200          are added to the new line.  The second time control-Y is
I3220          entered, the new line is "closed" so  that characters are
#3240          no longer inserted.
!3260CONTROL-C Exit this command
$3280CONTROL-N Reedit the new line.
$3290CONTROL-P Reedit the old line.
3300
&3320PART 5. WORD PROCESSING COMMANDS
3340
N3360[Now that you have edited your file and listed it , you are now ready to
J3380print it.  Certain parameters need to be set before you can do this,
3400however.]
3420
3440A) THE SPACE COMMAND
A3460[To set the line spacing for other than single space, enter
/3480the number of lines that you want spaced]
#3500     SPACE 2   (double space)
'3520     SPACE 3   (triple space etc)
3540
3560B) THE LINE COMMAND
H3580[The length of the output line does not have to be the same as the
K3600input line.  The maximum length of the output line is 132 characters.
$3620To set the line length, enter]
3640     LINE 60
3660     LINE 132
3680
0C) THE OFFSET COMMAND
H3720[Sometimes the printer may print too close to the left edge of the
O3740paper and you may want to move the entire page to the right.  If you want
B3760to move the entire page to the right by 5 characters, enter]
3780<OFFSET 5
3800
0D) THE MARGIN COMMAND
@3840[This command sets the first and last columns of the page.
@3860To cause the line to be printed starting in position 5 and
#3880ending in position 75, enter]
3900<MARGIN 5,75
+3920[This could also be done by entering]
3940     OFFSET 4
3960     LINE 71
3980
4000E) THE JUSTIFY COMMAND
G4020[To cause the lines contained within brackets to justified to the
54040right margin in addition to line filled, enter]
4060<JUSTIFY ON
4080
4100F) COMMENTS
L4120[A comment may be entered into the text file as one of the first lines
I4140before the real text by entering a # and the word COMMENT after the
L4160line number.  Your comment may follow the word COMMENT.  The line will
J4180be listed during the LIST command, but it will be ignored during the
4200PRINT command.]
>4220   1000#COMMENT THIS LINE WILL BE LISTED BUT NOT PRINTED
4240\
4260G) THE TITLE COMMAND
74280[To set up a title of up to 50 characters, enter]
#4300<TITLE THIS TEXT IS THE TITLE
C4320[The title begins with the first nonblank character after the
84340word TITLE and ends with the carriage return.  The
94360title is printed on the first line of any page that
4380also gets a page number.]
4400
0H) THE TABSET COMMAND
J4440[Up to 10 tabs can be set.  To set tabs at columns 5, 10, 30 and 45,
4460enter]
4480<TABSET 5,10,30,45
4500
0I) THE REPEAT COMMAND
=4540[You can also get multiple copies printed.  To get five
4560copies, enter]
4580<REPEAT 5
4600
4620J) THE PAGE COMMAND
J4640[The dimensions of a page can also be changed.  A normal 8 1/2 by 11
O4660inch page contains 66 lines total.  With a one inch margin at the top and
K4680bottom, there are 54 print lines with the first line on line 7.  This
84700standard page is the default but could be entered]
4720<PAGE 66,54,7
4740
#4760K) THE PAGE NUMBERING COMMAND
@4780[Unless your text is very short, only a few pages will fit
@4800in memory at one time.  You may have pages 1 through 10 in
F4820one file and pages 11 through 20 in a second file.  To print the
B4840second file, it is necessary to tell SECRETARY to begin with
G4860page number 11.  This is done with the PNUM command.  Be sure not
A4880to confuse PNUM with PAGE.  The highest page number is 249.
#4900Note the three uses of PNUM:]
&4920     PNUM 5  (begin with page 5)
@4940     PNUM 0  (begin with page 1 but print it starting with
'4960                page 2 on page 2)
)4980     PNUM 251 (omit page numbering)
5000
5020L) THE UNIT COMMAND
N5040[To cause the print to come out on an additional printer rather than the
;5060CRT, enter the unit number  as described in  PART 2.]

5080<UNIT 1
5100\
5120M) IMBEDDED COMMANDS
E5140[Many of these commands will be the same every time you print a
G5160particular file and it is inconvenient to reenter them each time.
E5180To make this more automatic, all of the commands here in PART 5
5200except REPEAT
N5220may be entered in the text file preceded by a #.  They must be the first
K5240lines in the file.  Note how they appear in your listing of DEMOFILE.
@5260The imbedded commands MUST be the first lines in the file.
@5280The only exception to this rule is the COMMENT, SPACE, and
;5300CHAIN commands which can be imbedded within the file.
>5320An invalid command or a line without a # right after the
A5340line number will terminate the search for imbedded commands
>5360and treat the remaining commands as text to be printed.]
5380    10#LINE 70
(5400    20#TITLE SECRETARY USER MANUAL
5420
5440N) THE CHAIN COMMAND
K5460[This command will load the file and automatically begin printing it.
L5480If this command is imbedded as the last line in a file, multiple files
N5500can be printed as if they were one document.  Printing will begin on the
L5520next available line, so if you want the chained file to begin on a new
H5540page, insert a page eject back slash at the beginning of the file.
*5560To automatically chain FILE2, enter]
5580<CHAIN FILE2
5600
5620O) THE PRINT COMMAND
L5640[You are now ready to print your final copy.  Note that after you type
O5660the "T" of the word "PRINT" and before you enter the carriage retrun, you
M5680must position the paper to the line above the first line of print.  The
5700command is simply]
5720<PRINT
J5740[The print can be terminated by entering control-C.  If your printer
;5760does not print continuous forms, SECRETARY will pause
J5780after the last line on a page and wait for you to insert a new page.
R5800Position the paper on the first line and enter a carriage return to continue
K5820printing.  You can also begin printing at a line other than the first
P5840line by following the PRINT command with a starting line number.  Caution,
P5860however, since the imbedded commands will be ignored if you begin printing
B5880after those lines.  To begin printing with line 1234, enter]
5900<PRINT 1234
5920\
,5940PART 6. MERGING DATA FROM A BASIC FILE
5960
O5980[One of the powerful features of this program is the ability to take data
L6000from a North Star BASIC data file and insert it into the printed text.
L6020The obvious application is to insert names and addresses.  On the disk
O6040that you received, there were three additional files: BASICPGM, SAMPLTTR,
N6060and SAMPDATA.  BASICPGM is a sample BASIC program to create a data file,
J6080SAMPDATA, of names, addresses and data.  SAMPLTTR is a sample letter
16100which uses SAMPDATA as the data to insert.]
6120
N6140[The BASIC data file must be a type 3 file.  It must contain only string
K6160records of variable length but less than 256 characters.  Each string
N6180record contains all of the data necessary for one letter.  The record is
K6200divided into substrings by a + sign.  The data file for the editor, a
O6220letter for instance, must contain an up arrow at each place that you want
6240to insert a substring.]
6260
L6280[To use this facility, first LOAD the letter SAMPLTTR.  Then enter the
6300command ]
6320<MERGE SAMPDATA
L6340[The program will find SAMPDATA on disk, check for a type 3 file, load
P6360the first sector into a buffer at the top of the data area, and check that
L6380the first record is a string record less than 256 bytes long.  If your
O6400letter is so long that it approaches the top of the data area so there is
O6420no room for the BASIC data record, it will print the message "NO ROOM FOR
L6440BUFFER".  The available memory will be reduced by 513 bytes to provide
!6460for the BASIC file buffer.]
6480
K6500[Once you have LOADed the letter and MERGEd the BASIC data, enter the
Q6520PRINT command.  It will automatically print one copy of the letter for each
<6540record in the file.  You do not need to use the REPEAT
;6560command.  If you stop the print with a control-C, you
,6580must execute the MERGE command again.]
6600
M6620[If there are more up arrows in the file than substrings in the record,
K6640the extra ^ will be ignored.  If there are fewer ^ in the letter than
M6660substrings in the record, the extra substrings will be ignored and each
M6680letter will begin with a new record.  If you are entering data into the
M6700body of the letter, the data must be able to fit on the line containing
N6720the ^.  Characters that do not fit on the line will be ignored since the
>6740editor does not know where to logically split the data.]
6760
B6780[Look at BASICPGM and SAMPLTTR for specific examples of this
R6800technique.  BASICPGM is provided as an example only.  You will want to write
G6820a more sophisticated program to allow addition, modification, and
B6840deletion of data, but this will depend on your application.]
6860\
6880PART 7. ADVANCED FEATURES
6900
6920A) THE CALL COMMAND
K6940[During the PRINT command, SECRETARY will scan the line for a special
R6960character and call your own subroutine if the character appears in the line.
Q6980To call your routine for all lines, search for a carriage return, 0D, which
M7000will be on each line.  To ignore all lines, search for the character 00
37020hex.  This can be used to rescan the line for
;7040special printers.  A sample test routine is coded in
L7060SECRETARY  at 2D33.    The address of the buffer with the line will be
C7080in the HL registers and SECRETARY expects the address of the
J7100new buffer line to be  in DE registers.  The other registers may be
H7120destroyed.  This is an advanced technique and the user should be a
L7140proficient assembler language programmer before attempting to use this
7160feature.]
7180<CALL 2D33,0D
7200
7220B) FILES TOO BIG
;7240[If a file on disk is larger than memory, the message
H7260"FILE TOO BIG" will be printed when the file is loaded.  SECRETARY
O7280will read as much as it can into memory.  If the file was large, but the
R7300data itself within the file is small enough to fit in memory, SECRETARY will
K7320work correctly and the message can be ignored.  Otherwise some of the
J7340data will be lost.  To be sure that the file was small enough to fit
P7360 or to salvage as much of the data as possible if it was too large, enter]
7380<RECOVER
7400
7420C) FILE TOO SMALL
J7440[If the file on disk is too small to hold all of the data in memory,
@7460the message "FILE TOO SMALL" will be printed when the file
?7480is saved.  SECRETARY will write as much of the file as it
#7500can.  When the file is loaded
I7520back later, however, some of the data will be missing.    Since the
P7540end-of-file indicator will be missing, SECRETARY  will not be able to tell
O7560where the file ends.  To salvage as much of this data as possible, enter]
7580<RECOVER
7600\
7620D) THE BLOAD COMMAND
Q7640[A BASIC program is not in the format that can be processed with SECRETARY.
R7660To load a BASIC program and convert it to SECRETARY format in memory, enter]
7680<BLOAD BASIC-program-name
R7700[You can then use the editing features of SECRETARY on it.  The line numbers
M7720in the BASIC program must not exceed 9999 so you may have to do a BASIC
R7740RENUMBER before BLOADing the file.  NOTE: RENUMBER in SECRETARY only changes
O7760the line numbers at the left side of the line and not references to those
P7780line numbers within a line (such as GOTO, GOSUB etc) as the BASIC RENUMBER
;7800does.  Use CHNG or CHALL to change those references.]
7820
7840E) THE BSAVE COMMAND
L7860[This is the opposite of BLOAD.  It takes a SECRETARY fomatted file in
N7880memory, converts it to North Star BASIC, and writes it to disk.  Be sure
O7900that the disk file is already created, it is type 2 file, and it is large
R7920enough to include any changes that you may have added to the program.  Since
M7940the conversion requires searching a large table, the program may take a
R7960minute or two to perform this command.  To save the BASIC  program BASICPGM,
7980enter]
8000<BSAVE BASICPGM
8020
0F) THE EXPAND COMMAND
N8060[There may be times when you do not need the CONFIGURE, BSAVE, and BLOAD
H8080commands and you are short of space.  You can wipe out these three
L8100commands and get an extra 2K of memory for your text file by entering]

8120<EXPAND
R8140[This will cause the data area to be EXPANDed.  &CAUTION: Do not save a copy
R8160of the program after entering EXPAND or you will permanently lose the BSAVE,
O8180BLOAD, and CONFIGURE commands.  BE SURE TO SAVE ANY TEXT IN THE DATA AREA
N8200BEFORE ENTERING EXPAND.  ANY TEXT IN THE DATA AREA AFTER ENTERING EXPAND
"8220WILL BE PERMANENTLY LOST.& ]
8240
0G) TO QUIT AND RETURN
C8280[If you need to QUIT SECRETARY to return to DOS and you later
@8300wish to return without destroying the data, jump to 2D04.]
8320#CHAIN USERMAN3