w䩶PբԠ0 )i(Ԑ601ԩ Ԡ 9 9!! 9##`iLeH׍ ԍI h@$iskformatiertmit")"/-/.QVk6c "ibosoft #/-093(/07eitere)nformationenbei#/-093(/04elpppppppBPppppppppA62 Hɝ( Ǭ0d M * @  $ % CC$$)%1 Udߥ$9%: !0 S$%} DD˙`  }J)Lr J  ((  p L ()   J}L= ( L 0q A    IB JC;? D W } LL  ` W )LA!  ߰")-݆ p" } $G@LL 08`Q")<2Q0 -G$Ș݆ UL# ; p8(()(0ʥ)NQ` }$GȘ݆LU )L ݆ L GȘ ݆LL )W>Z   HH)H }p h  hyhy D L> L JJ    ! LA*` BF }7'8  M HN H` 8 Z  \LdJJ!"! GFE@F (!L }EE !E^ ^ E E7EȩEdE/EȩE  D } .L }  ;F d  ;?F7F? ( .   Z D LL d } . D  L    p  E` , d)  D L) 0BM݊L݉} ML  N݆ L NLML [ TEqEHȱEqEh 0Gȹ G} HLL GɛL  LFREE SECTORS G) *Gȩ GȽG GȌ*jj >G} C8jJ3j2CD( C202C ԠBX` N 1? l LlD:RAMDISK}.COMLu L1 L ;LHL  T`  `8  ɐ     `TU  } L ? .  t`GBJ ~DEHI B V0dV!}QDEHI VF9 ,0 ,0 s0hhL  L` H hDHEh"}DEL8HI4 0 HI,0 0  9 .G VLO#},0 L4*IJ`llD1:AUTORUN.SYSNEED MEM.SAV TO LOAD THIS FILE.D8:MEM.SAV J y08 B|DEHI$} V0 0`B;DEL`?<0LV`@ʆ v s? F0Ξ05: [ BDEHI%} VY8 B V  @  /DE `E:D8:DUP.SYSERROR-SAVING USER MEMORY ON DISKTYPE Y TO &}STILL RUN DOS B;DE J  (` 9 V⪍ ઍ  -'}LLu ÝDEHILV 9 .l 9 .l  `` s$B BH(}I|DE V BLV nB,DE JLV B V BLVDEIʩ BꭝLu }05  15 2 2151^116115ύ011$r2ԭ5 3)5)5ԭx G*}@@L00)+& 2 L0=ɛ -L!1LV1L1 /3 3ȹ441L-4 v3 25 2H 2h͔5+}L3L3 2 k3U hh`DOC`QL3P1Lk0S1H /3h0B k3@ VL0LU!#$53 1181118,}1111Ε5 1Lk0552 1Ȍ1i111i11115Lk0pppB4f5&&&&&&&&^6f^6&&&&&-}&&A1@BJ D2ELVK@BHILV^Щ6 2BD2EJ VBD5EHI0 V0%5.}5 2iХiL[2 25 25`D:*.*` i@`8 ``@i `8@`0 BLV525<4/}5`HH i ԍΗ552 ԍhh@ Lح1Э1Ѣ 24.4 240}4`D4E` 2BJ k3LVRH` 2BD4EhK)I JLV333}MENU and use: ENTER"Dn:Filename.Ext" -Programs may be one of the following file types: BAS > BASIC languag?}e OBJ > MACHINE language DOC > DOCumentation PIC|MIC|FNT|MVM > Graphics AMS|MUS|MBD > Music LST@} > BASIC LISTing -Some MACHINE language programs can only be run by booting the disk MENU "without" BASIC! -For sA}ome programs, XL/XE models may require a "TRANSLATOR" program to be booted first! [Also available from BELLCOM] -B}Most programs are relatively self-explanatory; however, some have separate DOCumentation files available. Some BASICC} programs may contain instructions in their program listings. -To use this great MENU program on your own disks, D}simply copy the file "AUTORUN.SYS" onto your disk. * MENU written by DAVID CASTELL * program on your own disks, ^ _______ TEXTPRO _______ Version 1.2 from the SOFTWARE F} PLUS+ BBS (504) 279-7073 Textpro Extension and Keyboard Macro Features (C) 1986 M G}IKE COLLINS and RONNIE RICHE Aug 15, 1986 This documentation is an updated, and hopefully improved, version H} of the original docs for v1.1 and includes discussion of the additional features of TEXTPRO 1.2. * SECTION I} 1 * ------------- Using TEXTPRO ... HATE DOCS? You really don't need to read this entire document to begi J}n using TEXTPRO. Just type your text into the editor. The words will wrap to the next line automatically so only pr K}ess RETURN to force the end of a paragraph. The cursor controls will be rather familiar since they are much like the L} ATARI editor. Use the COMMAND SUMMARY sheets at the end of this DOC ("TEXTPRO4.DOC") as a reference to the TEXTPRO M}commands. To save your work enter the * ave file command and type in the filename. To get to the disk N} menu for loading and manipulating files press the * enu command and there you are. The bottom of the sc O}reen contains a menu of your selections. Move the wide bar cursor to the file you want and make your selection. Pre P}ssing ape will return you to the editor. To print your masterpiece use the * rint command from the Q}editor screen and press RETURN. TEXTPRO will format your document using its internal default format settings. Make R}sure that an 80 column printer is online and ready. Thats all there is to using TEXTPRO in a hurry, but if you wan S}t to learn how to use all of the features of this powerful and useful program just read on. USER INTERFACE AND CONFI T}GURATION -------------------------------- TEXTPRO features a user interface that allows the user to choose: - Word U}wrap on/off...CTRL-Y - Fast key repeat on/off...CTRL-N (XL/XE machines only) - Key click on/off...SELECT+CTRL-N - U V}pper/lower case at startup... CAPS key - Background color...CTRL-B (+SELECT to reverse) - Text luminance...CTRL-T W}(+SELECT to reverse) - False spaces on/off...CTRL-O to toggle - Carriage return shown or subdued...SELECT+CTR X}L-O to toggle - Insert/replace mode... CTRL-I(nsert toggle) - Screen width... SHIFT TAB (Widen screen)... CT Y}RL TAB (Narrow screen) After getting the editor the way you want it at startup use * ave config Z} file. This will write the configuration file to the disk for selection at startup. If you change the user interf [}ace during an edit and would like it returned to the startup selections press * Restore defaults comm \}and. To pick a font for the editor choose any ATARI Graphics 0 font of your liking, put it on your TEXTPRO disk and ]}name it TEXTPRO.FNT. It will load automatically at startup. If you are using TEXTPRO 1.2 and want to load one of th ^}e special TEXTPRO extension files just put the extension of your choice on your TEXTPRO disk as TEXTPRO.EXT. It will _}automatically load and initialize at startup and on RESET. An explanation of these special extension files is contai `}ned in section two of this documentation. The COMMAND SUMMARY provides a complete listing of all of the TEXTPRO comm a}ands. The TEXTPRO Keyboard Macro Feature is not fully explained in this documentation. For a full description of th b}e uses and protocols of the Keyboard Macro Feature get the TEXTPRO MACRO DOCUMENTATION which is distributed as a sepa c}rate file on this disk ("MACRO.DOC"). A description of the editor and editor commands follows. EDITING COMMA d}NDS ---------------- The editor for TEXTPRO is full featured and behaves for the most part like the standard e}ATARI editor. If you are familiar with the ATARI editor you should have no problem getting familiar with the TEXTPRO f} editor. There are also additional features which make the TEXTPRO editor one of the most functional and complete of g}fered for the ATARI computers. The arrow keys, delete back-space, and insert keys are functionally identical to the AT h}ARI editor. There is no equivalent for the ATARI delete screen line command (SHIFT DELETE) but the additional editin i}g commands provide a great deal of power and flexibility for text movement and deletion. The additional editing comman j}ds are: * Moves the cursor to the beginning of the previous word or the nex k}t word respectively. * Moves the cursor to the beginning of the previous paragra l}ph or next paragraph respectively. * Moves the cursor to the beginning of the prev m}ious sentence or the next sentence respectively. * to move the cursor to the beginning of the n} screen line. * to move the cursor to the end of the screen line. * ome cursor comman o}d Pressed once the cursor goes to the top of the screen. If held down or pressed twice in succession p} the cursor jumps to the top of the file. * nd of file command Moves the cursor to the end of q}the file. The editor operates in both the insert and replace modes. In the insert mode text is inserted at the curs r}or position and the remainder of the file after the cursor is moved over to accommodate the new text. In the replace s} mode the new text overwrites the previous text. These modes are toggled by the * nsert toggle command. t} When you press the mode you have just entered will be prompted on the message line. The particular mode that u} you use is mostly a matter of personal preference and will matter little when editing at the end of the file. When v}editing at the top of a large file using the insert mode the need to move all of the characters after the cursor to m w}ake room for each new character can slow the editor down. This can also cause the editor to "drop" some characters dur x}ing fast keyboard entry since the editor has not had time to complete the insertion and recover before the next key i y}s pressed. This can be a frustrating limitation during extensive editing. A keyboard buffer utility will solve the z}problem of dropped characters but does not speed up the editor. For this reason it is preferable to use the replace {}mode to edit at the top of a large file since the speed of editing in the replace mode is not affected by the number |}of characters following the cursor. The only disadvantage to this method is that the file must be opened up to enter a }}dditional text since otherwise you would overwrite text that you might want to keep intact. To facilitate rapid open ~}ing of the text file for replace mode editing TEXTPRO has two commands that will quickly insert editing room in the f }ile. Editing room is inserted in the form of blank spaces which can be typed over without effecting the context of }the document. These commands are: * always inserts 5 blank spaces regardless of editing mode and ca }n be used to open small areas in the file quite rapidly. * is a special command that wi }ll do a rapid insert of 255 spaces from the cursor position each time it is pressed. This is used to } open an editing "window" in the file. This will help when you need to do large text editing and entry in } the top or middle of a large file. Press this key as many times as needed to quickly insert the nee }ded space into the file. Then use replace mode editing to enter your text. Don't use insert mode since } this would defeat the purpose of opening the editing window in the first place! To quickly remove those le }ft over blank spaces after entering your new text use the * delete blank spaces command and }all of the extra blank spaces between the cursor and the next word in the file will be deleted and the editing window w }ill be closed up. With these special editing commands you will be able to do rapid editing any place in the file, ev }en on a text file that approaches the maximum size of the text buffer (over 19K). When using Version 1.2 you will no }tice that in the replace mode the replaces the character before the cursor with a blank space witho }ut moving the following text up behind it with each deletion. In the insert mode the text after the cursor follows t }he cursor back in the file. This is parallel to the behavior of the editor when entering text in the respective mode }s. Finally, you will notice that regardless of your editing mode you cannot typeover a return character. When a ret }urn character is encountered in replace mode editing the editor behaves exactly as if it were in the insert mode. Th }is is intentional and will make more sense the more you use the editor. If all of this seems rather confusing don' }t be concerned. You will find the editor a lot easier to use than it is to read about. I am documenting all of the }various differences here in order that you have a reference to answer questions you may have after using the editor and } observing its behavior. There is no substitute for working with an editor to learn its features and weaknesses. A }fter using the TEXTPRO 1.2 editor for awhile we feel that you will find it to be one of the easier to use and more fl }exible editors for the ATARI. SOME MORE COMMANDS ------------------ To delete text you have great fl }exibility in the TEXTPRO editor. Just go to the spot from which you want to start the deletion and use the * elete text command. The command line will turn red and the prompt "Delete (S, W, P):RETURN to exit" will appear. } The "S, W, P" stands for (S)entence, (W)ord, (P)aragraph respectively and specifies the chunk of text in front of t }he cursor that you wish to delete. Pressing these keys will delete the selected text and place it in the paste buffer. } You may continue to choose text to delete until you press RETURN (or any key other than S, W, or P) to quit the del }ete mode and return to the normal editor. If you wish to add the text you are deleting to the current contents of th }e paste buffer use the * elete and append to buffer command. The paste buffer will not be clear }ed and the newly deleted text will then be appended to the original contents of the paste buffer. To replace the del }eted text just use the * eplace deleted text command and the deleted text in the buffer will be pasted }back. You may paste the text back as often as you wish or move to another place in the document and paste it back. }You may even load another file and paste the text into that file if you wish. The deleted text will remain in the pa }ste buffer until you issue a * ill paste buffer command which clears the buffer of the deleted text. Oth }er operations that will delete the contents of the paste buffer are issuing another delete command without pressing S }ELECT or using the copy file command from either the editor or the menu. Another important feature of a word process }or is the ability to search and replace text strings in a document. TEXTPRO 1.2 has a powerful search and replace fe }ature that can search and replace ANY character or string up to 30 characters long. To define a string to search for } press the * ind string selection command. Simply enter the string that you wish TEXTPRO to searc }h for and press RETURN. To find the selected string just press * ind string. There is no need to press } RETURN. TEXTPRO will immediately search out the first occurence of the string in your file. If the string is not an }ywhere in the file the prompt "Not Found" will appear. Simply press ind as many times as you need to find al }l of the occurences of your search string. The search is case sensitive so be sure you type in the string with the c }orrect upper/lower case configuration if you must.ch is case sensitive so be sure you type in the string with the c 6Continued... To change a found string use the * hange string selection command. Just enter the} string that you want to change the found string to, press RETURN, and you are ready to go. Each time the program fi}nds the search string and you want to replace it press * hange found string command and the found string }will be changed to the selected string. This command will only work after a sucessful find operation. Pressing at any other time has no effect. This gives you a fast and easy way to search and replace strings one at a time. } Somtimes this is just what you want to do, but other times you may want to replace every occurence of one string wit}h another without doing each one individually. To search and replace every occurence of a string in your file use the} * lobal replace command. Just enter the name of the string to find and the string to change to, pressing }RETURN after each selection. Make sure this is what you want to do before using this command. The search and eplace} operation will begin immediately and will proceed through the entire file. Another special TEXTPRO feature that is }worthy of mention is the * here's the cursor command. Any time this key is pressed the page and line numb}er of the character under the cursor in the PRINTED file will be displayed on the message line. This can be a really} neat feature to use when planning the page breaks in a document. A handy trick for editing and paging multiple fi}le documents that will be printed with the link file command and enter the starting page # at the top of the each separate file with the start numbering @ page comman}d +< desired print }key>then<=>then. The print key will appear in inverse and can be used from then on in your document to s}end that decimal code to your printer. The way it works is simple. Whenever the TEXTPRO print formatter encounters th}e particular print key it replaces the print key with the decimal code to which it is assigned and sends this code to} the printer. All of the inverse capital letters are available for your use as print keys since they have no special} definitions in the TEXTPRO print routines. Do not use the lowercase inverse keys that are already defined as TEXTPR}O formatting commands since this will cause unpredictable results. See the COMMAND SUMMARY section to find out what th}ese keys are. There are also some pre-defined print keys and these may also be found in the COMMAND SUMMARY. Th}e only print key that requires special explanation is the * SELECT><.>...SELECT+Period which is defined as decimal #}32 and is the hard space character. This character is counted by the formatting and justification routines and by th}e printer as a printable space character. What on earth is a "hard space" character? A hard space character is used} in conjunction with the print just- ification and word wrap features. Right margin justification is acheived in TEXT}PRO by inserting extra spaces between words until the line is the required length. This can be a problem since space}s can sometimes be inserted in places where you do not want them, such as between entries in a columnar table. You may} also have word combinations that you do not want broken at the end of a line by the automatic word wrap. For word c}ombinations that require fixed spacing or that you wish to have treated as one word just use hard spaces instead of n}ormal spaces between the words. This will cause the formatter to regard the phrase as one word for justification and w}ord wrap. This will retain your desired format without affecting the context of the document since the hard spaces w}ill be sent to the printer as a normal space character. You may also create non-printing tags for your text file b}y defining print keys of your choice as the null character of your particular printer or by using an undefined print }key. This can be very helpful in finding your way around your document using the TEXTPRO find string feature. When }one of these print keys is encountered during printing it will simply be ignored. Put in as many as you like. You} may imbed control characters within the text simply by typing ESCape prior to entering the keystroke. To enter the ES}CAPE character to the editor simply press ESC twice in succession. This is an alternate method for sending control c}haracters to the printer but it is not recommended since these characters will be recognized by the formatter as prin}table characters and will throw off your line spacing. Learn to use the print keys for printer codes. This procedur}e is mentioned because there is a practical value to entering control characters directly to the editor. This is the} method used for editing the TEXTPRO command macro sequences. During macro execution the equivalent of the control c}ode will be sent to the program as an actual command. For instance, during a macro the CTRL-L character would be int}erpreted as a load file command. This is an exact replication of its function in the TEXTPRO editor. The special TE}XTPRO character sets will display these control characters in a different font so they will be more easily identified w}hen writing macros and tracing the sequence of macro execution. * SECTION 2 * ============= } GENERAL INFORMATION TEXTPRO FEATURES -------------------- include: * Fast, full featured editor fo}r easy text entry. More cursor movement, cut, paste and replace flexibility than any other ATARI word processor. * }Ability to cut and paste between files. Delete to end and top of file. Save and load from the editor or get full DO}S features from the disk menu for up to 8 drives. * Fast and useful editor information commands to give byte counts,} word counts and the position of the cursor in the printed file. * User programmable print keys, macro keys, and fun}ction keys. * Full featured formatting including justification, conditional page break, outdenting, headers, footers}, page numbering, block right, and a file link feature for printing large documents. * The ability to exit to DOS an}d run interactively with other programs. Using MEM.SAV your text file can be retrieved on re-entry to the program.} * Print, save, load to any legal device. Copy HELP files to screen. Copy files from device to device without leavin}g the program or losing text in editor. Append in copy, save, or print to device operations. * Version 1.2 can be e}xtended by machine language modules for extra features. Individual utility extensions are available now for addition}al directory and DOS functions, as well as a keyboard buffer. Macro extensions offering multiple features are also a}vailable for DOS 2.0/2.5 and SpartaDOS. * TEXTPRO uses no RAM under the OS and should be compatible with most DOS an}d hardware enhancements for any model of ATARI computer. Supports the following hardware and software enhancements:} - All RAMDISKS can be used from the DOS menu or the editor. It does not matter which RAMDISK (AXLON, RAMBO, XE) is }used as long as legal calls to CIO are implemented by the software. - All versions of the Time/Date display of SPART}ADOS up to Version 3.2. - The program has been tested with the HAPPY running high speed I/O and with the US Doubler }with it's Ultra Speed package without difficulty. The menu also supports the use of 8 disk drives and can be used wi}th the new ICD drive modification for the 1050 which defines drives 5-8. DOS PACKAGES and TEXTPRO ---------}--------------- TEXTPRO uses only legal calls to the operating system for input and output. Version 1.1 of TEXTPRO }is supplied in two versions which are identical except in the assembled address. The R-version of the program (1.1r)} is assembled 3K higher to allow larger DOS packages, RS-232 handlers and your own utility routines to be available u}nderneath. The size of the text buffer is reduced 3K in the R-version to about 17K. The latest and most powerful vers}ion of the program is Version 1.2. The original TEXTPRO v1.2 had a minor bug in the delete routine that is fixed by }a BASIC patch program to upgrade TEXTPRO v1.2 to TEXTPRO 1.2a. Version 1.2a is the most recent and powerful version} of the program as of this writing. If you are still using v1.1 or v1.2 it would probably be best to obtain a copy of }1.2a.(#) The following is a result of test with various DOS packages * SPARTADOS All versions of SPARTADOS tested }worked well with TEXTPRO, especially when using all the additional DOS features. The TEXTPRO file entry routines all}ow room for the use of sub directories and you can exit to DOS, use any built in DOS function except COPY, and return } to the program with your text intact. This is great for changing, deleting, or creating those directories. The SPART}ADOS time/date line display and file stamping with either the software clock or the R-Time 8 cartridge are both fully} supported as is the Ultra Speed disk IO enhancement for the 1050 drive provided with the US Doubler. The TEXTPRO 1.}2 directory extension also supports the expanded directory listing used in the SPARTADOS format. The SPARTADOS macro} extensions for Version 1.2 add numerous features, including verify on/off, an exit to BASIC, and sub-directory suppo}rt from the TEXTPRO disk menu to mention a few. You could spend a lot of money on other machines and programs withou}t finding a more potent and flexible word processing environment than that offered by the extended TEXTPRO 1.2a and  }SPARTADOS. This is especially true if you are lucky enough to have available the high speed disk IO of ICD's US Double }r enhancement. Find a system you can test this combo on and give it a test drive. It may just save you some money.  } The SPARTADOS macro extension is ICD Extension 2.3b. For more information on acquiring these extensions see the ASS }OCIATED FILES section at the end of this doc. This is a great DOS package for TEXTPRO, and a lot of other things.  } It has our highest recommendation. * DOS 2/2.5 Works with both versions of ATARI DOS equally well. If MEM.SAV is u}sed the same ability to exit and use DOS features works with these DOS's. Most of the available DOS features require}d are available from the TEXTPRO menu and additonal features are available with TEXTPRO 1.2 extensions making an exit} to DOS with these packages hardly necessary. There are also two macro extension files available for DOS 2.0/2.5. }These is Extensions 2.5b and 2.5c. These extensions will work with the other DOS's but all of the features offered }are only available when using DOS 2.0/2.5. See the ASSOCIATED FILES section for more information.features offered jContinued... * OSA+, Version 2.1 Since TEXTPRO was developed using this DOS and MAC-65, it works very well with OS}A+. Exits and re-runs beautifully retaining your file when re-run with the RUN command. We do not have DOS-XL or OSA+} v4 so they could not be tested using TEXTPRO. If these packages exhibit the same reliable features of the other OSS} products we would anticipate no problems using TEXTPRO with these DOS's. We would appreciate any information regar}ding the performance of TEXTPRO under these packages. * TOPDOS Version 1.5 TEXTPRO 1.2 supports TOPDOS as long as th}e DOS is configured for a LOMEM setting of 1F00 or lower. This can be acheived by reducing the number of buffers to} 3 when using the 130XE RAMDISK module. LOMEM settings larger than 1F00 cause DOS overwrite by the TEXTPRO program a}nd will cause unpredictable results. It would be possible to configure a special version of TEXTPRO to support the f}ull features of this DOS. This would create compli- cations with regard to extensions for this special version since } the assembly address would have to be higher to accomodate the extra TOPDOS modules and the resulting absolute address}es of the equates used for programming extensions would be different. For this reason we do not plan to publish thi}s version at the present time. If we receive enough requests for a special TOPDOS version we will reconsider the opt}ion. * MACHDOS TEXTPRO 1.2 runs at full speed from MACHDOS XL. The only limitation found here is the lack of a RAMD }ISK module for those with the 130XE or other expanded RAM machines. At least we don't know of one. * MYDOS TEXTPRO !}1.2 does not run from this DOS at all!!! This DOS reacts strangely to the TEXTPRO extension initialization routines a"}nd the directory structure is not compatible with the TEXTPRO DOS menu routines. Sorry, but for now if you want to use#} TEXTPRO, you'll have to pick another DOS. SECTION 3 * =========== TEXTPRO VERSIO$}NS ---------------- ...Differences between Versions 1.1 and 1.2 In additon to the ability to load extensi%}on files there are also a number of handy housekeeping improvements to TEXTPRO 1.2 that make using this version a bit&} easier. Some of these would not be noticed by a new user but old hands with TEXTPRO 1.1 will appreciate them. + I'}n TEXTPRO 1.1 the editor defaults to upper case after reset, run at address, or the copy command. TEXTPRO 1.2 return(}s in the configuration that it was in when you left. As an added feature it also returns to your exact position in the)} file. + When editing in the replace mode with TEXTPRO 1.2 the key will delete the character befo*}re the cursor but the following text will remain in place. This allows easier and faster editing of large text files+} and saves keystrokes when deleting and replacing text. You can use the to remove extra spa,}ces left when editing in this mode. + The SPARTADOS run vector is set properly by TEXTPRO 1.2 and the program can be-} rerun after exiting to DOS with the RUN command. + In Version 1.2 the COPY command uses both the paste buffer and .} the full unused space of the text buffer to speed file transfer. + The cold start selection of TEXTPRO v1.1 did not w/}ork properly and would cold start the machine only about half of the time. This bug has been corrected and TEXTPRO 10}.2 will cold start every time using the combination. An additional feature of Version 1.2 is the abil1}ity to cold start with BASIC disabled by pressing . + If you have an XL/XE machine and use a DOS that 2}does not load into the RAM area under the OS (DOS 2, 2.5, OSA+ etc.) you can gain an extra 4K in the editor by using3} the translator with TEXTPRO 1.2. You must have the cartridge de-selected for the program to recognize the additional 4}RAM space. + TEXTPRO 1.2 has a default filename "NAME.ME" tied to the SELECT L/l filename functions for the comman5}d line. This will prevent the no filename errors caused by trying to auto-save a file that had not been previously l6}oaded. This default filename also resets itself after each ERASE ALL TEXT command. + The SELECT L/l filename command7} can also be used with Version 1.2 to print to the message line from within a macro. This allows macro messages to b8}e developed using the current filename. A useful application is to define OPTION L/l to print the name of the curren9}t editor file to the message line. + After a copy to screen command to display a HELP screen or other text any OPTIO:}N keypress(macro) will be executed immediately using Version 1.2. This feature is enabled when the "Press any key" p;}rompt is displayed. This precludes having to press a key to return to the editor prior to entering the desired macro k<}ey. This feature will allow the creation of nested macro screens and will improve the usefulness of the TEXTPRO help=} screens or those of your own design. + In Version 1.1 the "Wait for Keypress" macro command would clear the message>} line. This has been corrected in TEXTPRO 1.2 to allow a message to be printed and a wait for keypress to be issued. ?} The message will not clear until the next keypress. + The copy, print to disk, and save functions of TEXTPRO 1.2 ha@}ve an append feature that is selected like the ATARI DOS append. When executing a copy, print to disk, or save operatiA}on you can enter the /A extender to the filename to select an append. This feature also works with the copy selectioB}n from the menu. Add the /A extender to perform an append of the highlighted file to the the target file. + Two morC}e print keys have been predefined in Version 1.2. The inverse <5> equals decimal 13 and the inverse <6> equals decimaD}l 10. These codes are universal as the carriage return and line feed characters respectively and can be used to prE}oduce footnotes and to perform other formatting tricks with TEXTPRO. + The Delete to End of File was altered in VersF}ion 1.2 to also delete the character that the cursor is resting on. This is rather arbitrary but this method seemed G}more conventional. + The blank screen command * command is available from the editor in TEXTPROH} 1.2. If you are editing password files or some other confidential text you may want to use this feature if you quit I} editing for a while. Re-enable the display using the * command. There are other touch ups that J} have been included to the program but they will be more noticeable for what won't happen than for what you can do. WeK} won't waste time documenting them. Overall, TEXTPRO 1.2 is a smoother, more powerful, and easier to use version of L}TEXTPRO than v1.1. ...IMPORTANT! + Unlike Version 1.1 TEXTPRO 1.2 can be used to edit ANY file, even object code fiM}les, since all characters are now converted to their original form when saved to disk. Do not try this with v1.1!! N}The editor characters displayed by v1.2 are different for a few keys and you must keep this in mind when editing objectO} or BASIC files. It is also preferable to edit source code with the word wrap off since it is an irrelevant feature P}for this type of file and only limits the number of characters displayed on screen. The conversions are as follows:Q} * will appear as the inverse escape character in the TEXTPRO v1.2 editor. * willR} appear as an inverse carriage return. The text will also break on this character just as it does for a normal carriaS}ge return. This is just a quirk of TEXTPRO and has no adverse effect on the saved file. Pressing then during a replace or find operation will enter the return character to the command line without terminating string iU}nput. Use this method to search and replace the characters if desired. This can be very handy for some teleV}communications needs, such as replacing returns with CTRL-M/CTRL-J combinations. ...EXTENDING TEXTPRO We aren't likW}ely to think of everything, and since we are aware of the desire of many of you to alter the program for your own puX}rposes we have built a rather unique feature into TEXTPRO 1.2. Before we continue let me digress with a bit of explaY}nation regarding the design of the program. It is hoped that TEXTPRO 1.2 will be the last full implementation of theZ} program. We are committed to fixing any disastrous bugs that may pop up in operation but we are relatively sure that [}you will find Version 1.2 to be a reliable program. Some of you have asked for the source code to TEXTPRO but we bot\}h feel that it would be a bad idea to have a lot of different versions of "TEXTPRO" floating around. In addition, th]}e task of commenting the expanded source code files for readability would not be trivial. There are only 5 or so se^}ctors left on the source code disk and we did not comment the program very much as we went along. We regret these ci_}rcumstances since it is not our intention to close TEXTPRO development to those who feel they can improve it. Read o`}n and you may find that there is an easier way to add your own features to TEXTPRO. When TEXTPRO 1.2 loads it looks a}for a file named TEXTPRO.EXT on the disk. If this file is present it is loaded and initialized at runtime and on RESb}ET. This is an ideal method for loading such things as keyboard buffers and other short utilities. For most people thc}is will be the only use for this feature that is needed or desired. You assembly and ACTION! prog- rammers will bed} pleased to know that TEXTPRO 1.2 has been opened at numerous locations to be hooked by machine language extensions te}o the program. These extension files can be loaded and initialized using the TEXTPRO.EXT feature to be available autf}omatically at runtime. The hooks supplied should be sufficient to provide for powerful extended features that are fug}lly integrated with the TEXTPRO routines. There are hooks available for editor, print, and file routines. It is hopeq}d that in the future all enhancements to the TEXTPRO program will be published as extensions to and not as revisions r}of the program. This method offers advantages in development time and will give you the opportunity to do your own ts}hing without the need to assemble the entire program. It will also allow additional features to be selected individut}ally for specific applications rather than sacrificing memory in the main program for features that are not frequentlu}y needed. One final benefit is that the program itself will remain unchanged and a relative amount of compatibility v}assured. Please be patient until we can compile all of the information that is required for programming extensions iw}nto a readable format. Since we must develop and test the procedures that must be followed in hooking to TEXTPRO it x}will take a little time before the documentation will be complete. The resulting programmer's notes for TEXTPRO extey}nsions will be published as a separate document and posted as soon as it is available. The initial extension files werz}e produced as Page 6 utilities. Macro extension files have been prepared for DOS 2.0/2.5 and Spartados. These macro{} extensions contain DOS specific functions, like binary load, and combine improved versions of the Page 6 extensions.|} No editor memory is sacrificed to load these macro extensions since they load to a pre-selected area of memory.s.{Continued... ...PROGRAMMER'S NOTES The assembly and RUN addresses of TEXTPRO 1.1, 1.2, and 1.1r are 1F00, 1F00, ~}and 2B00 respectively. The paste buffer and the macro buffer are fixed at 3K each for all versions. The copy routin}e used by TEXTPRO uses the paste buffer for file transfer so text stored there will be lost when COPY is used. Versi}on 1.2 also uses the full unused memory of the text buffer to speed file transfer. The infamous PAGE SIX is free and } can be used for a keyboard buffer program or other utilities as desired. This can help to make text entry at the top }of a large file more reliable if not faster. The best solution for rapid editing throughout the file is to keep your }files under 12K or so. Use separate modules with the link file feature to produce large documents. This method was }used to produce this documentation and provides an effective method of producing documents of any length. For you as}sembly language programmers page zero locations $CB through $CF are also free for your use in writing utilities or TE}XTPRO extensions. It should be noted that if you use SPARTADOS Version 2.3 with TEXTPRO 1.2 or 1.1 there is sufficie}nt room above DOS for the SPARTADOS RS232 handler to remain resident. This is the only DOS that has a LOMEM low enough} to allow this. If you have a serial printer this is an important consideration when selecting a DOS package. Th}e extra RAM of your 130XE or modified 800 machine can be used to its maximum by using the RAMDISK with the Keyboard Mac}ro Feature to emulate a multiple open buffer system that can be called with a single keypress. The MOSAIC and AXLON }boards work identically in this application to the 130. The macro to implement this feature is already written into }the STYLE10 Version 1.2 macro file for TEXTPRO. This macro defines the RAMDISK as D8:. If your RAMDISK is set for a }different drive number simply edit the macro to suit. Within the limitations of RAMDISK size you can have up to 64 fil}es in RAM simultaneously and they can be accessed and manipulated from a menu without ever typing in a filename. Usi}ng SPARTADOS you can even have different subdirectories on the RAMDISK and switch between them with a few keystrokes.} Unlike true multiple RAM buffers the RAMDISK can also contain other types of files (BASIC etc.) for use from DOS. }One of the most useful features of this method is to list BASIC programs to the RAMDISK, load them to TEXTPRO with th}e word wrap and carriage returns off and a 38 column screen width to mimic the BASIC editor and then edit, cut, paste}, search/replace and manipulate the file as you wish. You can then exit to DOS, go to BASIC and ENTER your program fro}m RAMDISK for testing.(#) This is only one example of the flexibility offered by TEXTPRO. This method is especially }useful when used in conjunction with the fine LBASIC program by Kent Peterson published in ANALOG. Use the Exit to B}asic feature to make using TEXTPRO with LBASIC a breeze. TEXTPRO will disable BASIC automatically on load unless the} OPTION key is held down during the load. If OPTION is held down until the title screen appears BASIC will remain r}esident and the text buffer will lose 8K of RAM space. Do not try to exit TEXTPRO to DOS and then use BASIC if BASIC} is enabled in this way. The reason for this is the use of BASIC's page zero pointers by TEXTPRO. Running BASIC after} exiting TEXTPRO without resetting these pointers can cause unpredictable results. The Exit to BASIC feature supplie}d in extensions will properly reset BASIC and should be used if available. If you use SPARTADOS there will be no co}nflict at all if you use the BASIC ON/OFF commands. It should be noted that the BASIC disable on load does not work} with SPARTADOS due to conflict with internal routines and you should use BASIC OFF from a batch file before loading T}EXTPRO. One possible reason to leave BASIC resident when loading TEXTPRO is to give 800XL owners access to a RAMDISK} under BASIC. SPARTADOS already provides a program for this application. Since the RAMDISK offers about 6K of stora}ge and the loss of RAM to BASIC is 8K the loss of memory for this application is only about 2K. For you students tha}t do your homework on your school's VAX mainframe over the phone line using the ATARI Public Domain KERMIT program by} JOHN PAVELICH you will be happy to know that KERMIT runs interactively with the TEXTPRO 1.1 R-version. Go to KERMIT}, get your homework, exit to DOS, run TEXTPRO and edit the file. Then just reverse the procedure and compile it on the} VAX. Get your errors, if any, and go back to TEXTPRO to make the corrections. Just turn off the word wrap to work }on those tables and get your file length using the TEXTPRO file size feature. TEXTPRO 1.2 COMMAND SUMMARY } KEYBOARD COMMANDS =========================== Normal Select -------------------------------- CTRL A Up}per/Lowercase Swap CTRL B Background Color Reverses sequence CTRL C Change Found String Select Change S}tring CTRL D Delete Append to Buffer CTRL E End of Text Buffer CTRL F Find String Select Find String CTRL G }Global Search and Replace CTRL H Home Cursor CTRL I Insert/Replace Toggle CTRL J Restore Default Parameters CTRL K Ki}ll Buffer CTRL L Load File Load Config File CTRL M Menu CTRL N Fast Repeat On/Off (XL/XE) Key Click On/Off C}TRL O Show False Spaces On/Off Show Return Character On/Off CTRL P Print to Device CTRL Q Beginning of }Line Copy File CTRL R Restore Deleted Text CTRL S Save File Save Config File CTRL T Text Brightness Reverses s}equence CTRL U Used/Unused Memory Delete to Top of File CTRL V Load Macro File Delete to End of File }CTRL W Print Position of Cursor CTRL X Exit to DOS Disable Screen Display CTRL Y Word Wrap On/Off CTRL Z End o}f Line Enable Screen Display CTRL ? Word Count CTRL [ Sentence Left CTRL ] Sentence Right CTRL + Character }Left CTRL * Character Right CTRL - Character Up CTRL = Character Down SHIFT > Insert 255 Spaces SHIFT < Delete Unus}ed Spaces SHIFT + Word Left SHIFT * Word Right SHIFT - Paragraph Up SHIFT = Paragraph Down OPTION Execu}tes Macro CTRL TAB Narrow Screen SHIFT TAB Widen Screen SELECT RESET Causes Cold Start (BASIC enabled) } OPTION RESET Causes Cold Start (BASIC disabled) SPECIAL MACRO SPECIFIERS =======================}= Entered as in Macro File ------------------------------- @............... Startup Macro #.........}..... START Key Macro ?............... HELP Key Macro ATARI CONTROL COMMANDS ====================== } ENTERED WITH CONTROL -------------------- 1........ Pause Screen Listing 2................... Ring Bell} TEXTPRO COMMAND SUMMARY ======================= Commands Available from Macros Only Entered with ESC then} SELECT-CTRL --------------------------------- A Moves cursor left one space E Erase G Goto M}acro I Input Mode (Special text entry mode) K Wait for Keypress M Print to Message Line (persistent}) P Pre-Select Macro If followed by a Load Macro command will go to the selected macro in the chain}ed file R Rename Y Print to Message Line (until next keypress) FEATUR}ES AVAILABLE WITH EXTENSIONS ONLY ----------------------- ... Binary Load }... Exit to BASIC <;>....Verify on/off toggle + When used in a Load File operati}on from the editor the /D extender will load the selected disk direcory to the editor. + The disk menu listing is so}rted, and English error messages supplied with the DOS 2.0/2.5 and the ICD macro extensions installed. Sub directory} support is also featured with the ICD extension. TEXTPRO PRINT COMMANDS ENTERED WITH SELECT KEY =====}================== SELECT + Default Parameter -------------------------------- ottom margin 58 enter te}xt dge right ooter define o to linked file eader define nformation line elect linefeeds ef}t margin 5 argin release ext page, conditional with # 0

age length 66 justify right 0=off 1=on off i}ght margin 75 ine spacing 1 op margin 5 nderline toggle page wait off columns across 80 <#>page nu}mber <@>starting page number 1 print starting with # 1 PRE PROGRAMMED PRINT KEYS ENTERED WITH SELECT } ========================= SELECT+ DEFAULT (For most printers) -------------------- <.>d}ecimal value... 32 (hard space) <1>decimal value... 27 (Escape) <2>decimal value... 14 (Elongate } on) <3>decimal value... 15 (Elongate off/ Condensed on) }<4>decimal value....18 (Condensed off) <5>decimal value....13 (Carriage return} character) <6>decimal value....10 (Line feed command) SPECIAL CASE }KEYS ENTERED TO COMMAND LINE ----------------------- ... and When entered in macros or} pressed during command line entry in a load, save, or save macro operation these keys print the name of the last fil}e loaded to the command line. prints the name without device to the command line prints the} name with the load device to the command line ASSOCIATED FILES ---------------- * SUPPORT.001 - }This is a compound file containing macro, text, and binary files. Used with TEXTPRO 1.2 it will create a 23 file sup}port system on a disk, including 3 fonts, 5 extensions, 14 help screens, the STYLE10 macro and a short doc file. Ava}ilable on the SOFTWARE PLUS+ BBS. Named TPSPT1.XMO on COMPUSERVE's DL5. * SUPPORT.002 - This compound file will cre}ate the 5 extension files and the doc file. DL this file if you already have the help screens and just want the exte}nsion files. Available on the SOFTWARE PLUS+ BBS. Named TPSPT2.XMO on COMPUSERVE's DL5. * SUPPORT.025 - This file }contains EXTENSION 2.5b and 2.5c and the documentation for the extensions. These are "macro-extension" that combine }and add improved versions of many of the Page 6 extension files. The size of the editor memory is unaffected and Page }6 is left free when these extensions are loaded. Available now on the SOFTWARE PLUS+ BBS and COMPUSERVE. * SUPP}ORT.023 - This file contains ICD Extension 2.3b. The documentation describing the extension is included in the file.} Extensions in the SUPPORT files are: TPBLOAD.EXT - Binary load extension for DOS 2.0/2.5 TPERR.EXT - Plain eng}lish error messages provided BUFFER.EXT - Keyboard buffer for TEXTPRO XDIR.EXT - Provides extended directory feat}ures TPBASIC.EXT - Exit to BASIC extension for XE/XL machines EXTENSION 2.5b/c - These are macro-extension files fo}r DOS 2.0/2.5 that contain improved versions of all of the above extensions. The "c" version also installs the key b}uffer to Page 6. Also included is a selection to choose write with verify on or off. The binary load and verify sel}ections of this extension will only work in DOS 2.0/2.5. ICD EXTENSION 2.3b - This macro-extension is for SPARTADOS }Versions 2x and up. Features include all those mentioned above in addition to TEXTPRO menu support for the SPARTADOS s}ub directories. The keyboard buffer is not included with this extension since SPARTADOS supplies its own key buffer} routines. ENDr is not included with this extension since SPARTADOS supplies its own key buffer% - TEXTPRO - ___________ Version 2.5r Keyboard Macro Feature ___________}___________ [C]1986 by Mike Collins and Ronnie Riche DOCUMENTATION } ============= TEXTPRO 2.5r is offered primarily to answer the text processing needs of telecommunicators, folks }that have serial printers, and those that need room between DOS and TEXTPRO for utility routines. We had originally hop}ed that we could answer all of the requests of users with extensions to Version 1.2 but there are some things, such a}s moving the assembled address, that make modification with extensions impossible. For this reason we will produce a} couple of special purpose versions of TEXTPRO. These will be file and print compatible with the original versions b}ut will have special qualities that cannot be provided by extensions. Some of the extra features offered in this and } other special versions, such as the file divide feature, will also be provided in extension files for Version 1.2. }Version 2.5r is assembled at 2B00 and allows room for the RS232 handler or other special handler files with even the mo}st memory hungry DOS packages. Since TEXTPRO can read/write to or from any legally defined device this gives a progr}ammer considerable latitude in developing custom handlers to support special features. Since the RS232 handler can b}e resident with 2.5r this version can now run alongside the excellent EXPRESS terminal program by Keith Ledbetter. } Some suggestions on using these programs together are at the end of this doc. I have tested 2.5r with the ATARI DOS}'s and also with TOPDOS 1.5 configured with the HAPPY, WISE, RS232, and 130XE modules all installed at once. It also w}orks well with a fully configured version of the new public domain MACHDOS 3.7 and should operate at full speed under} any DOS package and handler combination that is compatible at CIO level with DOS 2.0 and does not push LOMEM above 2}B00. The program is customized to operate with ATARI DOS 2.0/2.5. Despite this the majority of the additional featu}res will work with other DOS packages as well. The only exceptions to this rule are features that must use specific }DOS memory addressing. For this reason the binary load and verify on/off selections are disabled in other DOS's since} these features are specific to Atari DOS 2.0/2.5. The verify on/off also works when using OSA+ due to compatiblility} with DOS 2.0/2.5. Due to the different assembled address TEXTPRO 2.5r does not load and use the TEXTPRO extension} files. These files are specialized for operation with 1.2a only. Files named TEXTPRO.EXT are ignored by 2.5r at st}artup. Most of the features offered by v1.2 extensions are built into 2.5r along with some additional features not yet} offered even in the macro extension files. The cost of this has been the loss of some editor space but the 2.5r edi}tor will still handle files of over 15K in one load. Additional features are also offered with 2.5r to allow editing} of any size file. ADDITIONAL FEATURES ------------------- There wouldn't be much reason for another }version if you didn't get added features. The following features are available with TEXTPRO 2.5r: BINARY LOAD... }-------------- This is one of those DOS specific routines and works only with DOS 2.0/2.5. Press } and the prompt "Binary Load>" will appear. Enter the name of the binary file. Works like the "L" option of DOS. T}his command can be used from the editor or from a macro to jump from TEXTPRO to another binary program file. This ke}y is disabled in all other DOS's. ENGLISH ERROR MESSAGES... ------------------------- Replaces the cryptic error co}des of the ATARI OS with plain English error messages. This file has been expanded with more error messages than wer}e included in the Page 6 error message extension file GO STRAIGHT TO BASIC... ----------------------- With 2.5r y}ou can use to exit TEXTPRO directly to BASIC. This is great when you're using TEXTPRO to edit BAS}IC programs. Just list the program to disk and go to TEXTPRO and edit it. One convenient trick using the ATARI DOS'}s is to name TEXTPRO as DUP.SYS on a DOS 2.0/2.5 disk. If you boot with this disk you can just type DOS from BASIC and} you will go straight to TEXTPRO. You can then return to BASIC using the 'Exit to BASIC' feature. Since TEXTPRO has} just about every DOS function except the memory related functions you aren't losing very much. If you want to go to} the real DUP.SYS just insert a disk with DUP.SYS on it before typing 'DOS'. By the way this will also work with RAM }DISK.COM and will move TEXTPRO to the RAMDISK on boot and run it after typing DOS from BASIC. To get to the real DUP }.SYS just copy it to D8:DUP.SYS from another disk and exit to DOS from TEXTPRO. If you don't need MEM.SAV you could al }so binary load it from another disk. The exit to BASIC command has been improved to prevent re-run of TEXTPRO after  }BASIC has been enabled due to the unpredictable results this may cause. Jump to BASIC and then go to DOS and run at  }address 2B00. You'll go right back to BASIC again. THE /PARAMETER COMMANDS... -------------------------- TEXTPRO u}ses the '/' key followed by a letter parameter to activate some additional features. When the '/' parameters are used }only one will be recognized at a time. Be sure that there are no spaces between the '/' and the parameter and that th}e parameter is the last letter entered. Failure to enter the parameter correctly will cause the command to be ignore}d. Some examples of legal and illegal syntax are: Copy>D:TEST.FIL, D8:TEST.FIL/A (CORRECT. Chooses an appended }copy to the file on D8:) Print File>D:TEST.FIL/A (CORRECT. Chooses an appended print to the specified file.) } Save File>D:TEST.FIL/ A (INCORRECT. Space between parameter and '/'. Parameter will be ignored.) Save File>D:T}EST.FIL/DC (INCORRECT. Two parameters selected. Parameters will be ignored.) Version 1.2 introduced the /A comm}and which selects an append to file operation during Save, Print, or Copy. The next feature expands on the '/' paramet}er commands. SPECIAL DIRECTORY FEATURES... ----------------------------- With 2.5r the menu display is sorted alp}habetically whenever you go to the menu or list a new menu directory. All unlocked files are at the top of the menu }in alphabetical order and the locked files are listed alphabetically at the bottom. Use the next feature to keep your} disk catalog with TEXTPRO. With 2.5r you can enter a direct- ory listing into the TEXTPRO editor as easily as loadin}g a file. Press and when the "Load File>" prompt appears type in /D and the directory listing of drive on}e will be loaded to the editor. Go to the end of file and do the same for another disk. The new directory will append }to the file. In no time at all you will have the a disk log in the form of a TEXTPRO file. Since you are in the TEX}TPRO editor you can use the FIND feature to locate the occurences of any particular filename, extender etc. By typin}g in a short description of the disk and the files on it at the top of each listing you can track your disks easily. } There is also room to enter descriptions or notes after each file name. To update a disk just go to the TEXTPRO men }u, do any file operations you want to the disk, and then return to the editor. Paste out the particular disk's listi!}ng and go to the end of file. Paste it back, put the cursor at the beginning of the first line of the listing (after "} the disk name and notes) and read the directory into the editor. The previous directory will be overwritten by the ne#}w listing. Using this method you will scroll the latest updates to the end of the file and those that need update w$}ill "bubble" to the top. Wildcards are fully supported in the directory specifier. You are not limited to drive one e%}ither and may use any drive # supported by your DOS and hardware. You folks that use SPARTADOS will get the full fea&}tures of the expanded directory listing, complete with time/date stamps. You can also list the subdirectories withou'}t problem by first entering the subdirectory specifier. TOGGLE VERIFY MODE... --------------------- Just press ...yep, that's the semi-colon. To toggle between write with verify on or off. The program will origina)}lly load in the verify mode selected by the DOS. You can save the desired DOS configuration by exiting to DOS and sa*}ving DOS files. If MEM.SAV is active you can return back to TEXTPRO after saving DOS files by using the 'M' selection +}to run at address 2B00. Your editor file will still be intact and you will return to the position you were in when y,}ou exited to DOS. No more need to poke around with BASIC to change the DOS verify mode as you desire. This is anoth-}er of those DOS specific selections and will only work with OSA+ in addition to the ATARI DOS's. In other DOS packag.}es this key is disabled. The keyboard buffer that was included in the extension files for 1.2a is not built into this/} version. To supply a keyboard buffer to the program simply load it as a separate file from DOS. It can be disabled 0}by pressing SYSTEM RESET. Reloading it from DOS will make it active again. WORKING WITH ANY SIZE FILE... ----------1}------------------- One of the most requested features for new versions or extensions has been the ability to work w2}ith any size file. All word processors seem to have exactly the same amount of space in the text buffer: not enough. 3} We have supplied a utility program named DIVIDE.COM which can break large files into manageable segments for use wit4}h TEXTPRO and other word processors but we always considered this to be an interim solution. All utilities of this t5}ype suffer from some of the same problems. The need to exit the word processor to divide the file is an annoyance. 6}Also, the spots chosen to break the file are arbitrary and almost always require later touching up with an editor and7} further file manipulation. This has made even minor editing of large files very cumbersome. With TEXTPRO 2.5r the 8}ability to segment ANY size file is built right into the program. You also get to pick the size and makeup of each s9}egment from the editor, placing the file breaks right where you want them before segmenting the file. And it dosen't:} require learning a whole lot of new command keys or using slow, disk-based swap files. Although 2.5r has the smalles;}t editor of any TEXTPRO version it can effectively work on a larger file than even the most powerful word processors <}currently offered for the ATARI. File size is limited only by the capacity of the disk. USING THE /C AND /Z PARAMET=}ER COMMANDS... ----------------------------- Let's step through an example file to demonstrate the methods used wi>}th TEXTPRO 2.5r to divide a large file for editing. The first thing to do is to simply load the file from either the ?} editor or the menu. If the file is too large for the buffer the load will stop with 80 characters left in the editor.@} This allows two screen lines of room for some minor editing on the file segment. Now we need to find the best spotA} for breaking the first segment. Just move around the file and place the cursor at the spot where you want the file B}segmented. To find the exact size of the segment that you are selecting just use the sed/Unused memory C}command. This feature has been enhanced in 2.5r to include the position of the cursor in the file. This will be theD} exact number of bytes plus one of the segment being selected. Now we must save this first segment to the disk (or RE}AMDISK). Just use the usual ave command. Specify the drive number and filename you want for the first sF}egment. The only difference is that after the filename you add a /C parameter command.ename you want for the first s]Continued... This parameter will specify a save from the top of file to the cursor position, not including the ch"H}aracter under the cursor. Think of the /C as standing for 'Cursor position' when it is used in a save operation. Th"I}e next thing to do is to get some more room in the editor. Since you have saved the segment above the cursor to a sepa"J}rate file there is no need to keep it in the editor. Just use the command to delete to the top o"K}f the file. This will delete the segment that you have already saved and free up this space in the editor. You ar"L}e now left with the unsaved segment of the original file, the newly cleared room in the editor, and an easy method to c"M}ontinue segmenting the file on the disk. Just go to the end of the file using the nd of File command. "N}You are now at the exact spot the previous load to the editor ended. It very well could be right in the middle of a wo"O}rd, but don't let that concern you. To append the disk file to the editor from this exact spot just enter the <"P}CTRL L>oad file command. The command line will turn green indicating that an appended load is being selected. Use the"Q} same disk number and filename as the original file. The SELECT-L/l filename feature can be used to make this easy. "R} This command would normally cause an appended load from the start of the disk file. What you really want is to appe"S}nd a load starting from the position that the previous load stopped. To select this you just add the /C parameter agai"T}n. Think of it as meaning 'Continue loading' when used in a load file operation. The file will load and appen"U}d from the spot where the original load ended and continue to the full size of the buffer. You can then go to anothe"V}r position of your choice to break up the second segment and use the save to cursor command again on the new buffer c"W}ontents. You may repeat this segmenting, clearing, and loading procedure as many times as needed to segment the enti"X}re file exactly as you wish and save the segmented files out to disk under any filenames you desire. You can control b"Y}oth the exact size of each individual segment and the exact spot at which each break occurs. You can even use the ex"Z}tra 80 characters provided after each load operation to enter an information line containing the filename of the segm"[}ent and/or a file link command at the end of the segment before saving it out to the disk. If I've succeeded in totall"\}y confusing you or if you are still a bit hazy about how this procedure works please read through it again before mov"]}ing on to the next section, since the next command merely expands on what we have done already. HERE GOES... Ther"^}e may be a time that you simply want do some editing in the middle of a large file and keep it as one large file. You"_} could do this by saving it out as segments and then appending the segments together with the copy command. There is "`}absolutely nothing wrong with this and it will work just fine but if you have become proficient with the TEXTPRO file"a} divide feature you may want to combine the required steps using the /Z parameter. The /Z parameter combines the sa"b}ve to cursor_(/C) and appended save_(/A) selections to allow you to save the segments back to the same file. As an exa"c}mple you could segment the file TEST.TXT and save it using /Z to TEXT.BAK until you reached the portion you want to e"d}dit. You can then simply edit the file and then use the /Z or /A selections to append the remainder of the file to T"e}EXT.BAK. You will then have the newly edited file restored as a single file on the disk. Make sure that the initial s"f}ave to a new filename is a '/C' parameter command and not a '/Z' since you cannot append to a non-existent file witho"g}ut producing an error. You must do a bit of thinking before just jumping into something like this but with a little "h}practice you will find the procedure remarkably simple and easy to use. Of course you can also use TEXTPRO macros to "i} automate any of these procedures if you are daring enough. Feel free to change disks if you are using one drive and w"j}riting the segments to another disk. This does not effect the operation of the divide feature. If you specify eithe"k}r an incorrect filename or attempt a linked read from the wrong disk the load will abort and the message "Sector Link"l} Error" will appear on the command line. Just correct the error and try again. The load should proceed normally. I"m}f you attempt to load a file segment using the '/C' parameter after the end of the file has been loaded you will get "n}the message "Segment Not Linked" on the command line. Using the continuous load feature in conjunction with the abilit"o}y of TEXTPRO to read and write ANY file you can easily do a single drive copy operation without going to DOS. You co"p}uld even write a macro to do this complete with prompts to insert the source and destination disks. That's one that "q}I'll leave to you. I have written a short macro that will aid the editing of large files using the new TEXTPRO '/' c"r}ommands. USING THE SEGMENT.MAC MACRO FILE -------------------------- The macro file on CIS in DL"s}5 as 'SEGMNT.MAC' is a macro file designed to assist in the editing of large files. The macro has a help screen that"t} can be displayed by pressing the HELP or OPTION_? keys. This file must be named SEGMENT.HLP on the disk in D1: fo"u}r the macro to find it. There are a few simple selections offered by this macro that make saving segments of a large"v} file easier. The macro is designed to write the edited file out as a single file and must be modified to write the "w}segments out as different files. To start an edit of a large file just load the file to the editor. Go to an appropr"x}iate place for the first segment and press the START key. The segment to the top of the file will be saved to the di"y}sk and deleted from the editor. Do whatever editing you need to do and save the next segment by placing the cursor at"z} the appropriate location and pressing ave segment. The segment to the top of file will be append"{}ed to D:DOCUMENT.TMP and deleted from the editor. To load a further section of the file from the disk just use the "|} oad segment selection. The buffer will be filled with the next portion of the disk file. Continue"}} with the save and load selections to edit any portion of the file that you desire. To quit the edit without making"~} any changes to the disk files press bort edit. The editor will be cleared and the D:DOCUMENT.TMP"} file will be deleted from the disk. Any time that you feel that you have completed the edit and wish to save out th"}e entire edited file to D:DOCUMENT.TMP just press inish edit. The entire file will be read from an"}d written out to the D:DOCUMENT.TMP file. You can then simply rename the original and edited files any way that you "}wish. If you are sure that everything is OK you could even copy D:DOCUMENT.TMP to the original file to save disk space"}. TEXTPRO 2.5r is the first version of TEXTPRO that supports the SELECT L/l feature from macros using the 'Rename' a"}nd 'Erase' macro functions. I have not included any of these functions into the SEGMENT.MAC macro file but there wou"}ld be numerous uses for this feature. You could delete the original file automatically or rename it with the '.BAK' "}extension if you wish. You could also rename the DOCUMENT.TMP file to the original name automatically. It's there if"} you want it. This macro could also be altered to write the '.TMP' file to the RAMDISK by simply entering it to the "}editor and replacing all 'D:' specifiers with your RAMDISK specifier. As written the macro should work with any ATARI "}with one or more drives. If you want to observe the progress of the macro steps from the editor just delete all of t"}he keys in the macro. This will allow you to see the operations in progress although updating and sc"}rolling the screen display will slow the macro down quite a bit. TEXTPRO and EXPRESS 3.0 -------------------"}---- Since the RS232 handler can remain resident with TEXTPRO 2.5r this is a powerful companion for the superb EXPRE"}SS 3.0 terminal program and for BBS EXPRESS. To configure a DOS 2.0/2.5 disk for using TEXTPRO and EXPRESS together "}it is convenient to name EXPRESS 3.0 as AUTORUN.SYS and TEXTPRO as DUP.SYS on the disk. This allows you to do the fo"}llowing: - Press OPTION on boot and load EXPRESS. - Press RESET from EXPRESS and TEXTPRO will load automaticall"}y. If you are using a 130XE with RAMDISK.COM on the disk TEXTPRO will load from the RAMDISK. - Use the 'Binary"} Load' command from TEXTPRO to reload EXPRESS. You can also go to BASIC from TEXTPRO if you like and return t"}o TEXTPRO from BASIC by typing 'DOS'. - Go to DUP.SYS by inserting a disk with the actual DUP.SYS file"} on it and using the TEXTPRO exit to DOS command. If you are using the 130XE ramdisk you will have to copy t"}he actual DUP.SYS file to D8:DUP.SYS. One problem you may encounter is that EXPRESS 3.0 will autoload the R: hand"}ler every time it is run. This will cause the handler to load on top of itself on each re-run. Do this enough and you"} may push LOMEM above 2B00. Even if LOMEM does not get too high this is certainly not a desirable effect. If you wi"}ll not be re-running EXPRESS 3.0 a few times you probably won't have any problems. If you want to fix this problem,"} however, here is an easy way to do it. You can strip out and save the R: handler from EXPRESS 3.0 using TEXTPRO 2.5"}r. Here's how... - Load EXPRESS 3.0 into TEXTPRO 2.5r. - Use the left arrow to move the cursor to the 89th p"}osition in the file. Use the command to make sure you the cursor is 'at 89'. - ave this segm"}ent to disk as D:RS232.OBJ using the /C(ursor) parameter command. This is the RS232 handler that must be loa"}ded for EXPRESS 3.0 to work. - Now use to delete to the top of file to remove the handler. No"}w just use the /C parameter command to save the rest of EXPRESS 3.0 to disk under another name as a load and "}go file without the handler. This should take about two more continuous loads to the editor. Now if you name "}the RS232 handler as AUTORUN.SYS and TEXTPRO as DUP.SYS on your DOS 2.0/2.5 disk the handler will autoload and the bo"}ot will then load TEXTPRO. Now you can run the modified EXPRESS 3.0 with the TEXTPRO binary load command as many times"} as you wish without reloading the handler. Using these programs together can really be useful since you can DL your"} messages to a RAMDISK file and then log off the service, RESET to go to TEXTPRO and compose the replies and print th"}em to the RAMDISK. Then just re-run EXPRESS using the TEXTPRO binary load command and upload the replies. This saves "}on connect time and uses the RAMDISK as an electronic clipboard that will disappear, along with the redundant replies"}, when the session is over and you turn off the computer. No more cluttering up your disks with message replies. "}Other 6502 machines have terminal programs with word processors included that cost a lot of money and don't approach th"}e capabilities of EXPRESS and TEXTPRO when they are used together. Another reason that you made the right choice whe"}n you bought your ATARI! Use your imagination. I am sure you will get a lot of use out of this special version of T"}EXTPRO. Good luck... RONNIE and MIKE lot of use out of this special version of T O - TEXTPRO - ___________ Additional Documentation ------------------------ ...Som&}e additional notes The macro file on the TEXTPRO disk (or subdirectory) that is named TEXTPRO.MAC will be automatica&}lly loaded to the macro buffer when the program is initially loaded. TEXTPRO will also run any startup macro that is&} defined in the TEXTPRO.MAC file immediately on program load and initialization. I have mentioned startup macros at &}various places in the documentation without telling you how to implement one. A startup macro is the macro that is &}defined in the particular macro file using the <@> key as the macro key. If you are using SPARTADOS the configuratio&}n files, macro files, and fonts that are correctly named to load automatically will be loaded from the current direct&}ory first. If TEXTPRO does not find the configuration files on the current directory it will take them from the main d&}irectory if they are there. This convention can be used to advantage since it allows different configurations of the&} program to be automatically selected from the same disk by simply changing the working directory. The inverse car&}riage return can be entered to the editor by pressing then