@L}5 _$% l0$)$$Hȱ$ UhL" `e$$%`$%`  R@P!( L(1   Y I`  d  Ld M * @  $ % CC$$)%1 Udߥ$9%: !0 S$% DD˙`  }J)Lr ɛ - 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 hoped that we could answer all of th }e requests of users with extensions to Version 1.2 bu there are some things, such as moving the assembled address, }that make modification with extensions impossible. For this reason we will produce a couple of special purpose vers }ions of TEXTPRO. These will be file and print compatible with the original versions but will have special qualities that } cannot be provided by extensions. Some of the extra features offered in this and other special versions, such as t }he file divide feature, will also be provided in extension files for Version 1.2. Version 2.5r is assembled a}t 2B00 and allows room for the RS232 handler or other special handler files with even the most memory hungry DOS pa}ckages. Since TEXTPRO can read/write to or from any legally defined device this gives a programmer considerable latitude} in developing custom handlers to support special features. Since the RS232 handler can be 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 TOP}DOS 1.5 configured with the HAPPY, WISE, RS232, and 130XE modules all installed at once. It also works well with a }fully configured version of the new public domain MACHDOS 3.7 and should operate at full speed under any DOS packag}e and handler combination that is compatible at CIO level with DOS 2.0 and does not push LOMEM above 2B00. Th}e program is customized to operate with ATARI DOS 2.0/2.5. Despite this the majority of the additional features will wor}k 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 fe}atures 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 startup. M}ost of the features offered by v1.2 extensions are built into 2.5r along with some additional features not yet offered e}ven in - 1 - the macro extension files. The cost of this has been the l}oss of some editor space but the 2.5r editor will still handle files of over 15K in one load. Additional features a}re 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. This command can be used from the editor or from a macro to jump from TEXTPRO to $}another binary program file. This key is disabled in all other DOS's ENGLISH ERROR MESSAGES.. Repl%}aces the cryptic error codes of the ATARI OS with plain English error messages. This file has been expanded with more er&}ror messages than were included in the Page 6 error message extension file GO STRAIGHT TO BASIC... '} With 2.5r you can use to exit TEXTPRO directly to BASIC. This is great when you're usi(}ng TEXTPRO to edit BASIC programs. Just list the program to disk and go to TEXTPRO and edit it. One convenie)}nt 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 j*}ust 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 ver,}y much. If you want to go to the real DUP.SYS just insert a disk with DUP.SYS on it before typing 'DOS'. By t-}he way this will also work with RAMDISK.COM and will move TEXTPRO to the RAMDISK on boot and run it after typing DOS fro.}m 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 y/}ou don't need MEM.SAV you could also binary load it from another disk. - 2 0}- The exit to BASIC command has been improved to prevent re-run of TEXTPRO after BASIC has been enabled due t1}o the unpredictable results this may cause. Jump to BASIC and then go to DOS and run at address 2B00. Yo2}u'll go right back to BASIC again THE /PARAMETER COMMANDS... TEXTPRO uses the '/' key followed by a let3}ter parameter to activate some additional features. When the '/' parameters are used only one will be recognized at4} a time. Be sure that there are no spaces between the '/' and the parameter and that the parameter is the last letter 5} entered. Failure to enter the parameter correctly will cause the command to be ignored. Some examples of legal and i6}llegal syntax are: Copy>D:TEST.FIL,D8:TEST.FIL/A (CORRECT. Chooses an appended copy to the file on D8: 7} Print File>D:TEST.FIL/A (CORRECT. Chooses an appended print to the specified file.) Save File>D:TES8}T.FIL/ A (INCORRECT. Space between parameter and '/'. Parameter will be ignored.) Save File>D:TEST.FIL/DC (IN9}CORRECT. Two parameters selected. Parameters will be ignored.) Version 1.2 introduced the /A command which se:}lects an append to file operation during Save, Print, or Copy. The next feature expands on the '/' parameter comman;}ds. SPECIAL DIRECTORY FEATURES... With 2.5r the menu display is sorted alphabetically whenever you go t<}o the menu or list a new menu directory. All unlocked files are at the top of the menu in alphabetical order and th=}e locked files are listed alphabetically at the bottom Use the next feature to keep your disk catalog with TE>}XTPRO With 2.5r you can enter a directory listing into the TEXTPRO editor as easily as loading a file ?} Press and when the "Load File>" prompt appears type in /D and the directory listing of drive one will be lo@}aded to the editor. Go to the end of file and do the same for another disk. The new directory will append to the fiA}le. In no time at all you will have the a disk log in the form of a TEXTPRO file. Since you are in the TEXTPRO editor B} you can use the FIND feature to locate the occurences of any particular filename, extender etc C} - 3 - By typing in a short description of the disk and the files on it at the top of eaD}ch listing you can track your disks easily. There is also room to enter descriptions or notes after each file name E} To update a disk just go to the TEXTPRO menu, do any file operations you want to the disk, and then return to the F}editor. Paste out the particular disk's listing and go to the end of file. Paste it back, put the cursor at the begG}inning of the first line of the listing (after the disk name and notes) and read the directory into the editor. TheH} previous directory will be overwritten by the new listing Using this method you will scroll the latest updates toI} the end of the file and those that need update will "bubble" to the top Wildcards are fully supported in theJ} directory specifier. You are not limited to drive one either and may use any drive # supported by your DOS and harK}dware You folks that use SPARTADOS will get the full features of the expanded directory listing, complete witL}h time/date stamps. You can also list the subdirectories without problem by first entering the subdirectory specifiM}er TOGGLE VERIFY MODE... Just press ...yep, that's the semi-colon to toggle N}between write with verify on or off. The program will originally load in the verify mode selected by the DOS. You can saO}ve the desired DOS configuration by exiting to DOS and saving DOS files. If MEM.SAV is active you can return back tP}o TEXTPRO after saving DOS files by using the 'M' selection to run at address 2B00. Your editor file will still be Q}intact and you will return to the position you were in when you exited to DOS. No more need to poke around with BASIC toR} change the DOS verify mode as you desire. This is another of those DOS specific selections and will only worS}k with OSA+ in addition to the ATARI DOS's. In other DOS packages this key is disabled The keyboard buffT}er that was included in the extension files for 1.2a is not built into this version. To supply a keyboard buffer to theU} program simply load it as a separate file from DOS. It can be disabled by pressing SYSTEM RESET. Reloading it from V}DOS will make it active again. - 4 - WORKING WITH ANY SIZEW} FILE... One of the most requested features for new versions or extensions has been the ability to work with X}any size file. All word processors seem to have exactly the same amount of space in the text buffer: not enough. WeY} have supplied a utility program named DIVIDE.COM which can break large files into manageable segments for use with TEXTZ}PRO and other word processors but we always considered this to be an interim solution. All utilities of this type s[}uffer from some of the same problems. The need to exit the word processor to divide the file is an annoyance. Also,\} the spots chosen to break the file are arbitrary and almost always require later touching up with an editor and further]} file manipulation. This has made even minor editing of large files very cumbersome. With TEXTPRO 2.5r t^}he ability to segment ANY size file is built right into the program. You also get to pick the size and makeup of each _} segment 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 smalla}est editor of any TEXTPRO version it can effectively work on a larger file than even the most powerful word processb}ors currently offered for the ATARI. File size is limited only by the capacity of the disk. USING THE /C AND c}/Z PARAMETER COMMANDS... Let's step through an example file to demonstrate the methods used with TEXTPRO 2.5rd} to divide a large file for editing. The first thing to do is to simply load the file from either the editor or the menue}. If the file is too large for the buffer the load will stop with 80 characters left in the editor. This allows twof} screen lines of room for some minor editing on the file segment. Now we need to find the best spot for breaking thg}e first segment. Just move around the file and place the cursor at the spot where you want the file segmented. To fh}ind the exact size of the segment that you are selecting just use the sed/Unused memory command. i} This feature has been enhanced in 2.5r to include the position of the cursor in the file. This will be the exact j}number of bytes plus one of the segment being selected. Now we must save this first segment to the disk (or R} Page 1 of TEXTPRO Documentation - TEXTPRO - Version 1.1 Keyboard Macro Feature l} (C) 1986 MIKE COLLINS and RONNIE RICHE.....Using TEXTPRO USER INTERFACE and CONFIGURATION TEXTPRO fm}eatures a user interface that allows the user to choose: - Word wrap on/off...CTRL-Y - Fast key repeat on/off...CTRLn}-N - Key click on/off...SELECT+CTRL-N - Upper/lower case at startup ...CAPS - Background color ...CTRo}L-B(+SELECT to reverse) - Text luminance...CTRL-T(+SELECT to reverse) - False spaces on/off...CTRL-O to togglep} - Carriage return shown or subdued ...SELECT+CTRL-O to toggle - Insert/replace mode ...CTRL-I(nsert toggle) - Scrq}een width ... SHIFT TAB (Widen screen) ... CTRL TAB (Narrow screen) After getting the editor the way you want it at starr}tup use SELECT+CTRL-S(ave config file). This will write the configuration file to the disk for selection at startup. If you s}change the user interface during an edit and would like it returned to the startup selections press ...CTRL-J To pick at} font for the editor choose any ATARI Graphics 0 font, put it on your TEXTPRO disk and name it TEXTPRO.FNT. It will load autou}matically at startup.EDITING COMMANDS: The editor for TEXTPRO is full featured and behaves like the standard ATARI ev}ditor. There are also other additions which make the TEXTPRO editor one of the most functional and complete offered for the Aw}TARI. The additional editing commands are: * SHIFT-LEFT/RIGHT ARROW: Moves the cursor to the beginning of the previous x}word or the next word respectively. * SHIFT-UP/DOWN ARROW: Moves the cursor to the beginning of the previous paragraph y}or next paragraph respectively. * CTRL-[ and CTRL-]: Moves the cursor to the beginning of the previous sentence or the z}next sentence respectively. * CTRL-Q to move the cursor to the beginning of the screen line. * CTRL-Z to move the{} cursor to the end of the screen line. * CTRL-H(ome) command Pressed once the cursor goes to the top of the screen. If |}held down or pressed twice in succession the cursor jumps to the top of the file. * CTRL-E(nd of file) command Moves th}}e cursor to the end of the file.ADDITIONAL COMMANDS: The command summary file at the end of this document has the com~}mand listing for TEXTPRO. Most of the commands are self-explanatory. Also obtain the TPMACRO.DOC file that contains an explan}ation of the powerful keyboard macro feature of TEXTPRO and a few of the many ways that macros can be used. Learn to emulate }multiple buffers with your XE (or any other RAMDISK). TEXTPRO features programmable printkeys for the defining of control cha}racters for the printer. These characters are not counted for spacing or justification. To define a control code enter the pr}int key using: then the Where: is any legal ATARI }keystroke, to include control characters. This gives a large selection of macro keys. Now I can enter my sequence. The first thing I want to do is save a file so I enter the CTRL-S chara}cter by typing ESCAPE just as I did the first time. This will get the save prompt to the prompt line. I must delete the col}on of D: so I type in ESCAPE followed by DELETE BACK SPACE which enters this character to the screen. I then type in the 2:} for drive 2. I do not include a carriage return since this would terminate the filename input. My macro is complete. I e}nter it to TEXTPRO by saving it to disk and then loading it back using the CTRL-V (Load macro) command. Now if I press OPTIO}N and hold it down while pressing CTRL-S the prompt SAVE FILE>D2: will appear on the command line. Lets try writing anothe}r useful macro. TEXTPRO does not have an automatic paragraph feature but with the macro feature it is easy to create one. L}ets define the RETURN key as the macro key: followed by and#} the file will be automatically saved when the macro executes. We then want to go to the menu so we can pick a new file to sw$}ap to the editor so we follow with the menu command: Now if we save and load this sequence as part of our mac%}ro file each time we press the START key the file in the editor will be saved to the RAMDISK under its own filename and you w&}ill be sent to the default menu. If the default is the RAMDISK menu the effect will be a fast and efficient emulation of a m'}ultiple RAM buffer system and, better yet, you won't even need to type in a filename to swap files around. To get your files (}to the RAMDISK in the first place you could use the menu copy function to move the files you wanted or you could just write a)} start-up macro to swap them automatically when TEXTPRO loads up. If you're using SPARTADOS TEXTPRO can be on the main direc*}tory and the various configurations and macros on the subdirectories. You can then load the program in a variety of configur+}ations from the same disk simply by changing the working directory. Thats all there is to creating macro files. The uses are,} limited only by the needs and imagination of the user and the features of the program. All possible editing commands, file -}commands, search and replace, and file manipulations available from the keyboard are available from macros using this simple .}method. This makes TEXTPRO a remarkably flexible program, capable of more modification to meet the likes and needs of the us/}er than any other ATARI word processor. There are even additional commands available only from macros that make the macro lan0}guage even more powerful than the keyboard. These are listed as follows: Commands Available from Macros Only Entered with S1}ELECT-CTRL---------------------------------------------------------------------- A Moves cursor left one space E Erase G Goto Macro I Input Mode...Special text entry mode. ends input. K Wait for Keyp3}ress M Print to Message Line (persistent) P Pre-Select Macro If followed by a Load Macro command will go to the4} selected macro in the chained file Q Copy file R Rename Y Print to Message Line (non-persistent) Special Macro Identifiers Used as Macro Keys-------------------------------6}--------------------------------------- @......... Startup macro #......... START key macro ?......... HELP key macro7} Standard ATARI Commands Entered with CONTROL---------------------------------------------------------------------- 1......8}... Pause toggle for Screen listings 2......... Ring Bell SPECIAL MACRO COMMANDS A few of these commands may require e9}xplanation since they perform specialized functions. These are: moves the cursor left one space. This is :}used in place of the usual left arrow key since the left arrow represents the carriage return in the TEXTPRO editor. The oth;}er arrow keys for moving the cursor can be sent in the usual fashion. o to macro. When this key is encounte<}red in a macro sequence the macro will branch to the macro key that follows. After executing this macro the sequence resumes=} execution from the point where it branched. This is equivalent to a go sub instruction in programming. You may nest these>} go to macro instructions to 128 levels. +nput text command. When this command is encountered during a macro?} sequence the execution of the macro is halted temporarily until a is entered. Macro execution then resumes from th@}e spot where it was interrupted. The character is not sent when is pressed during input. If you need a carA}riage return at this point you must send it from the macro. When TEXTPRO is in the input mode text may be entered in the usuB}al fashion but the cursor movement keys are disabled and the only editing key available is the DELETE-BACK SPACE. Some commaC}nd keys are still functional. You can still get word count, print position, and free memory. Input mode also uses the colonD}(:) character as a delimiter and will not allow cursor movement past a colon in either direction. This allows the effective iE}mplementation of preplanned form printing or simulated data base functions using the TEXTPRO keyboard macro feature. You mayF} terminate the input mode at any time with the BREAK key. will also terminate input mode as will initiating another mG}acro. Completing the macro any time with the BREAK key. will also terminate input mode as will initiating another mor the input sequence will also return you to the full editor. The input feature is used extensively in the new STYLE 10 forI}matting macro and is one of the most useful writing tools you will ever use with any program for any computer. J}eypress wait command. Will pause the execution of the macro until a key is pressed. The keypress will not be sent to theK} editor but will resume execution of the macro. Use to send a prompt to the prompt line and pause the macro. <L}M> persistent message command. Sends the following (1-38) characters to the message line. "Persistent" means that the messageM} will not be cleared until a command is issued that writes to the message line.

re-select macro command. UseN}d only prior to a load macro command. Enter this command followed by the desired macro key. You then issue the loaO}d macro command and the new macro will load and the sequence will branch immediately to the selected macro key in the new macP}ro. Used to chain macros together for interactive operations. Let me give an example. The STYLE10 formatting macro hasQ} a help system that can be produced on a disk by using the MAKEHELP macro and the MAKEHELP text file. STYLE10 and MAKEHELP arR}e two separate macros but it is easy to work them together. We'll say that you have STYLE10 on your disks as TEXTPRO.MAC and S}it loads automatically. Change your STYLE10 marcro by loading it to the editor and defining one of the unused macro keys toT} this sequence:

<#>MAKEHELP.MAC The pound(#) key executes the defined macro from the START U}key. This is the macro key defined in MAKEHELP to begin execution of the macro. You can now generate the HELP system on any V}disk that contains the MAKEHELP macro and text files. Now when you are using STYLE10 and press OPTION with the new macro key W}the MAKEHELP macro will load and begin executing. The entire HELP system will be created on the new disk. You could also alX}ter MAKEHELP.MAC with the same technique to reload your original macro when it finishes the job. Sure beats copying 14 filesY} to a disk, especially if you only have one drive. non-persistent message command. Will send the charactersZ} that follow the command (1-38) to the message line. The message will be "non-persistent" meaning that it will clear itself [}on the first keypress. The wait for keypress command is not recognized as a keypress so you can send a non\}-persistent message followed by a wait for keypress command and the next keypress will clear the message line and resume macr]}o execution. With these commands in addition to the standard keyboard commands of the TEXTPRO program it is possible to creat^}e powerful and unusual effects with the program. If you have a RAMDISK, any RAMDISK, you can simulate multiple windows using_} the high speed IO available. With the ability to print to the command line and move the cursor around the screen it is poss`}ible to layout and produce pre-printed forms complete with prompts about what to do and where to go next. The HELP key macroa} can be used with the copy to device command to provide online HELP screens from the disk with one key press. The screen canb} be blanked for cosmetic and speed purposes and turned back on selectively. A macro can be tested and perfected with the scrc}een display on and then, when it is working properly a screen blank routine can be added to prevent distraction. These are jud}st some of the possible uses of macros in TEXTPRO. We hope that you find even more useful applications for this powerful feae}ture. This is not intended to be a tutorial but only a guide to enable those that wish to use keyboard macros to get startedf}. It is only necessary to know the conventions of operation of the TEXTPRO program to enable you to use this feature. The og}nly rule to recall at all times is that when creating or editing your macro files in the TEXTPRO editor you must enter the ESh}CAPE command before entering any of the command/control characters. These characters will be interpreted exactly as if they i}were entered from the keyboard so a knowledge of the sequence in which TEXTPRO accepts commands is needed to be effective witj}h complicated command macros. Try your luck with a few simple macros and then get more adventurous. With a little time and k}skill with the macros, in combination with the large selection of user options available with TEXTPRO, we feel that you will l}find that this is a program that you can have your way.- SEARCHING & REPLACING SPECIAL CHARACTERS - One difference tham}t must be noted between TEXTPRO 1.1 and 1.2 is seen in the method of searching and replacing special characters, such as the n}RETURN character from a macro. Due to character conversions performed by Version 1.2 the RETURN character can only be searcho}ed from a macro by representing it in the macro search routine as the inverse escape character. A macro for doing just this p}would be entered as follows:Select and enter the macro key and the inverse equal sign followed by then toq} select the global replace command. This will get the "Find>" prompt to the command line. Since we want to find the RETURN cr}haracters we then enter then