@L}5 _$% l0$)$$Hȱ$ UhL" `e$$%`$%`  R@W!( L(1   Y I`  d  Ld M * @  $ % CC$$)%1 Udߥ$9%: !0 S$% DD˙`  }J)Lr d 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:A*.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 }POPj өj DP0B JKNDPE V0 BLVE:P&;7=7;J&&K&*}L&ʩ * d5I&&&© 1 -L*I&˜ ' 4&0& 1&& *L*& & 1 -& +}& 1 - - *`RUNTIME ERROR AT LINE &&Lr*+ +L&` '& &L&PROGRAM STOPPED&&,}Ńł ȱ`iL'HH 1*L/ r* . 1 + '. . . 1 . ' 1 + . 'hh-}L.ʥ`HHhh`8L'u`Huh.}` Lr*L' Lr*L' ) . ( . ' r* .Lo* ) . ' , ( . ' /}+ ' r* ' + 1 , . o*Lr* ) ' ' , ( . ' + ' r* ' + 1 , . (( . o*Lo* ' 1* '.0}L/` ) r* .L. ) . . + ' . ' ,L' ) ' , ' . + 'L'J&1}K&L& ) 1 1,L&eJ&iK&`L&8LM& . '.L&`ʔȱȱȱ 12}*Șe惠 惨6,*6-* L*HHhh```Lo*3}` ** &JL&J *HHl JLw TO BOOT FOR DOS TO RERUNp B V8+` 4}+ȱLr*&&8558凅刐SJj)ee`ффiiL#+85}L#+ LM&uuuLr*8` +Lr*iLr*豂Hȱh`p +Lr*+H+ B6}HI+ 4 -h`8` ,L, ,#` ,0 ,0L, ,0` ,0L,L,`7}޵` `Ȕ`ʔ惥u`+ BHI DEH8} 4 -HyhLo* + -`+JJJJ`d-+e- +- c-0 c-Lr* J-Lr*` f-H J-h 0 c-`L+9}8 0ƅ`66&Ln-HH` B VhH)Kh)0 IJD-EB 4hLr*S:+Lr*TUVLo* -`++L+ -:}8ɰɅ +`ʱȱȱ`ȵȵLr*Lr* '. . .ʥ . . '. .L3 '.;} . . . 1*uȱuȱu W* 1* .0 @,L3 ȱLr* T,L.ʵ`eeLM&<}HHhh`ؐHH 1*L/ r*HH . .6 +i i .i i .hh =}. . 'hh .`HH 1*% r*HH 1L'/ 1* '. LM& .6 + . +` 1* '.ޠ . 1 +L/>}  o*Lr*H+ B Vh` ҵ  o*Lo*H+BHI 4+h+L1 g0+KJBD0EH?} 4h o*Lr* r* '.0Ɔ򩛙0` -H`B 4h`00L1Lr*Lr* +@}`H o*hL11HH eHHƆeiH '.lꦆ 1Օ`0  L,`8`|1A}rd-1e- (- 10|1L1|10|1`1 r* '.1 1`+6-1L1801LM& + 1 . 1 1 ++ 1 B}+Ɔʭ1 +`ʕ`66`HHH66666uuuhhhLr*C} +愵 ' + 'I 1 280/66&&&`uuu` 2 2Ј 2D} o* +`@32@2 .22222 LM&ȥ2i223`L*32 3E}`LM&2@82ƅ3 ȱ222` w3L?33L?3H3 2h`1+ %  8F}8L3 o* o*` o* o*`  o* o*` 3$' 3"0 30 !4L, 4L, 4L,L1L1G}4 1 '. .4444`H+? ++HI4D44E4B 4H4h` VLM&4` D44 1H}4α44 1L4 D44LM&44, α44ﭯ4 148e44α4 11L1  'LI}r*hh iLr* (5L2 (5L*42&&ȱ0 5Lw5 555&& L5&&`iJ}`J&&K&L&` +ȱ&&%8e慱HȱhױL&iJ&iK&Lr*+ BH VhK} 1LW*+&BH 4hN 1 W*L 1MLW*+%BNLMH 4hLo*)}*1*N*W*v*11+,J2+,a,s,@,/,T,9,H,L}),**++++,,-------6.c./x///2:3}10000)///0090.444(4!4440&D'@(f(()))V)4440T5\5A1+1d535M}5&(6@6j6S1 7 8U8(828<8P8889 9.969999999 :$B:.S:3i:8m:B:L:V:`::N}:&;G;b;;;;;7@7@7@7Fhhh) hh) hhhO}hԦ˩B͝DΝEԝH՝I V$A7GFP̩ B͝DΝEԝH՝I V0.˽HI ˦̹HHII BB7uP}u"-C7DΝE Vԩ`B7]77@77 B*?7D7P:777D.7D.7D/J7Q}.944F4E:7@@" ϠΠҠ 1. R}USING TEXTPRO 2. KEYBOARD MACROS 3. TEXTPRO EXTENSIONS 4. EXIT TO DOSS}" SELECT (1-4):?7HI@?77 i:47:7 D:TEXTPRO.PRTA7:7 D:MAT}CRO.PRTA7:7D:EXTEND25.PRTA7:7  77J+44}  "&;ҠԠU}Š7G;ERROR #7b;ERROR #U ٠٠Ϡ;V}P&7G;ERROR #7b;ERROR #U ٠٠Ϡ;Page 1 - TEXTPRO - Version 1.2 Ke X}yboard Macro Feature and Textpro Extension By (C)1986 Mike Colli Y}ns and Ronnie Riche From the SOFTWARE PLUS+ BBS (504) 279-7073 Z}Aug 15, 1986This documentation is an updated, and hopefully improved, version ofthe original docs for v1.1 and includ [}es discussion of the additionalfeatures of TEXTPRO 1.2.* SECTION 1 *Using TEXTPRO...HATE DOCS?You really don't ne \}ed to read this entire document to begin usingTEXTPRO. Just load the program and type your text into the editor.The ]}words will wrap to the next line automatically so only pressRETURN to go the end of a paragraph. The cursor contr ^}ols will berather familiar since they are much like the ATARI editor. Use theCOMMAND SUMMARY sheets at the end of th _}is doc as a reference to theTEXTPRO commands. To save your work enter the* ave file commandand type in the `}filename. To get to the disk menu for loading andmanipulating files press the* enu commandand there you are. a} The bottom of the screen contains a menu of yourselections. Move the wide bar cursor to the file you want and makeyour b} selection. Pressing ESCape will return you to the editor. Toprint your masterpiece use the* rint command fro c}m the editor screen and press RETURN.TEXTPRO will format your document using its internal default formatsettings. Make d} sure that an 80 column printer is online and ready.That's all there is to using TEXTPRO in a hurry, but if you want to e}learn how to use all of the features of this powerful and usefulprogram just read on.Page 2...USER INT f}ERFACE AND CONFIGURATIONTEXTPRO features a user interface that allows the user to choose:- Word wrap on/off ...CTRL-Y- F g}ast key repeat on/off ...CTRL-N (XL/XE machines only)- Key click on/off ...SELECT+CTRL-N- Upper/lower case at startup ...CA h}PS key- Background color ...CTRL-B(+SELECT to reverse)- Text luminance ...CTRL-T(+SELECT to reverse)- False spaces on/off i}...CTRL-O to toggle- Carriage return shown or subdued ...SELECT+CTRL-O to toggle- Insert/replace mode ...CTRL-I(nsert toggl j}e)- Screen width ... SHIFT TAB (Widen screen) ... CTRL TAB (Narrow screen)After getting the editor the wa k}y you want it at startup use* ave a file.This will write the configuration file to the disk for select l}ion atstartup.If you change the user interface during an edit and would like itreturned to the startup selections pr m}ess* Restore defaults command.To pick a font for the editor choose any ATARI Graphics 0 font of yourliking, pu n}t it on your TEXTPRO disk and name it TEXTPRO.FNT. It willload automatically at startup.If you are using TEXTPRO 1.2 o} and want to load one of the specialTEXTPRO extension files just put the extension of your choice on yourTEXTPRO disk a p}s TEXTPRO.EXT. It will automatically load and patchitself into TEXTPRO. An explanation of these special extension files q}is contained in section two of this documentation.The COMMAND SUMMARY provides a complete listing of all of the TEXTPROc r}ommands. The TEXTPRO Keyboard Macro Feature is not fully explainedin this documentation. For a full description of s} the uses andprotocols of the Keyboard Macro Feature get the TEXTPRO MACRODOCUMENTATION which is distributed as t} a separate file. A descriptionof the editor and editor commands follows....EDITING COMMANDS:The editor for TEXTPRO is u} full featured and behaves for the most partlike the standard ATARI editor. If you are familiar with the ATARIeditor y v}ou should have no problem getting familiar with the TEXTPROeditor. There are also additional features which make the w}TEXTPROeditor one of the most functional and complete offered for the ATARI.Page 3The arrow keys, delete b x}ack-space, and insert keys are functionallyidentical to the ATARI editor. There is no equivalent for the ATARIdelete sc y}reen line command (SHIFT DELETE) but the additional editingcommands provide a great deal of power and flexibility fo z}r textmovement and deletion.The additional editing commands are:* Moves the cursor to the be {}ginning of theprevious word or the next word respectively* Moves the cursor to the beginning o |}f theprevious paragraph or next paragraph respectively.* Moves the cursor to the beginning of the previ }}oussentence or the next sentence respectively.* to move the cursor to the beginning of the screen line.* to move the cursor to the end of the screen line.* ome cursor commandPressed once the cursor goes to the top } of the screen. If held downor pressed twice in succession the cursor jumps to the top of thefile.* nd of f }ile commandMoves the cursor to the end of the file.The editor operates in both the insert and replace modes. In the }insert mode text is inserted at the cursor position and the remainderof the file after the cursor is moved over to ac }commodate the newtext. In the replace mode the new text overwrites the previous text.These modes are toggled by the* nsert toggle command.When you press the mode you have just entered will beindicated on the message }line.The particular mode that you use is mostly a matter of personalpreference and will matter little when editing }at the end of the file. When editing at the top of a large file using the insert mode theneed to move all of the char }acters after the cursor to make room foreach new character can slow the editor down. This can also cause theeditor to "d }rop" some characters during fast keyboard entry since theeditor has not had time to complete the insertion and recover bef }orethe next key is pressed. This can be a frustrating limitation duringextensive editing. A keyboard buffer utility wi }ll solve the problemof dropped characters but does not speed up the editor. For thisPage 4reason it is }preferable to use the replace mode to edit at the top ofa large file since the speed of editing in the replace mode is n }otaffected by the number of characters following the cursor. The onlydisadvantage to this method is that the file m }ust be opened up toenter additional text since otherwise you would overwrite text thatyou might want to keep intact.To } facilitate rapid opening of the text file for replace mode editingTEXTPRO has two commands that will quickly insert editi }ng room in thefile. Editing room is inserted in the form of blank spaces which canbe typed over without effecting the con }text of the document.These commands are:* always inserts 5 blank spacesregardless of editing mode and can be us }ed to open small areas in thefile quite rapidly.* is a special commandthat will do a rapid insert of }255 spaces from the cursor positioneach time it is pressed. This is used to open an editing "window" inthe file. This }will help when you need to do large text editing andentry in the top or middle of a large file. Press this key as manyt }imes as needed to quickly insert the needed space into the file.Then use replace mode editing to enter your text. D }on't use insertmode since this would defeat the purpose of opening the editing windowin the first place!To quickly remove } those left over blank spaces after entering your newtext use the* delete blank spaces commandand all of }the extra blank spaces between the cursor and the next wordin the file will be deleted and the editing window will be close }d up.With these special editing commands you will be able to do rapidediting any place in the file, even on a text fi }le that approaches themaximum size of the text buffer (over 19K).When using Version 1.2 you will notice that in the rep }lace mode the replaces the character before the cursor with ablank space without moving the followi }ng text up behind it with eachdeletion. In the insert mode the text after the cursor follows thecursor back in the }file. This is parallel to the behavior of theeditor when entering text in the respective modes.Finally, you will noti }ce that regardless of your editing mode youcannot typeover a return character. When a return character isencounte }red in replace mode editing the editor behaves exactly as ifit were in the insert mode. This is intentional and will m }ake moresense the more you use the editor.Page 5If all of this seems rather confusing don't be concerned. } You willfind the editor a lot easier to use than it is to read about. I amdocumenting all of the various differences h }ere in order that you havea reference to answer questions you may have after using the editorand observing its behavio }r. There is no substitute for working withan editor to learn its features and weaknesses. After using theTEXTPRO 1 }.2 editor for awhile we feel that you will find it to be oneof the easier to use and more flexible editors for the ATARI.. }..SOME MORE COMMANDS:To delete text you have great flexibility in the TEXTPRO editor. Justgo to the spot from which you w }ant 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)aragraphrespectively and specifies } the chunk of text in front of the cursorthat you wish to delete. Pressing these keys will delete the selectedtext and }place it in the paste buffer. You may continue to choosetext to delete until you press RETURN (or any key other than S, }W, orP) to quit the delete mode and return to the normal editor.If you wish to add the text you are deleting to the curr }ent contentsof the paste buffer use the* elete and append to buffer command.The paste buffer will not b }e cleared and the y deleted text will thenbe appended to the original contents of the paste buffer.To replace the deleted }text just use the* eplace deleted text command.and the deleted text in the buffer will be pasted back. You may p }astethe text back as often as you wish or move to another place in thedocument and paste it back. You may even load a }nother file and pastethe text into that file if you wish. The deleted text will remain inthe paste buffer until you issue } a* ill paste buffer commandwhich clears the buffer of the deleted text. Other operations thatwill delete }the contents of the paste buffer are issuing anotherdelete command without pressing SELECT or using the copy file comma }ndfrom either the editor or the menu.Page 6Another important feature of a word processor is the ability to se }archand replace text strings in a document. TEXTPRO 1.2 has a powerfulsearch and replace feature that can search and }replace ANY characteror 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 search for and pressRETURN.To find the select }ed string just press* ind string.There is no need to press RETURN. TEXTPRO will immediately search outthe first } occurrence of the string in your file. If the string is notanywhere in the file the prompt "Not Found" will appear. Simpl }y pressind as many times as you need to find all of the occurrences ofyour search string. The search is case sensi }tive so be sure you typein the string with the correct upper/lower case configuration if youmust.To change a found stri }ng use the* hange string selection command.Just enter the string that you want to change the found st }ring to,press RETURN, and you are ready to go. Each time the program findsthe search string and you want to replace it }press* hange found string commandand the found string will be changed to the selected string. Thiscommand }will only work after a successful find operation. Pressing at any other time has no effect.This gives you a f }ast and easy way to search and replace strings oneat a time. Sometimes this is just what you want to do, but othertim }es you may want to replace every occurrence of one string withanother without doing each one individually. To searc }h and replaceevery occurrence 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 wantto do b }efore using this command. The search and replace operationwill begin immediately and will proceed through the entire file }.Page 7Another 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 number of the characterunder the cursor in the PRINTED file will be displ }ayed on the messageline. This can be a really neat feature to use when planning the pagebreaks in a document.A handy tri }ck for editing and paging multiple file documents that willbe printed with the link file command and enter the starting page # atthe top of the each separate file with the }start numbering @ pagecommand +< desired print key>then<=>then.The print k }ey will appear in inverse and can be used from then on inyour document to send that decimal code to your printer. The way } itworks is simple. Whenever the TEXTPRO print formatter encounters theparticular print key it replaces the print key w }ith the decimal codeto which it is assigned and sends this code to the printer. All ofthe inverse capital letters are } available for your use as print keyssince they have no special definitions in the TEXTPRO print routines.Do not use th }e lowercase inverse keys that are already defined asTEXTPRO formatting commands since this will cause unpredictable }results. See the COMMAND SUMMARY section to find out what these keysare. There are also some pre-defined print keys and }these may also befound in the COMMAND SUMMARY.Page 8The only print key that requires special explanation is t }he* SELECT><.> ...SELECT+Periodwhich is defined as decimal #32 and is the hard space character. Thischaracter is count }ed by the formatting and justification routines andby the printer as a printable space character.What on earth is a "hard }space" character?A hard space character is used in conjunction with the printjustification and word wrap featu }res. Right margin justification isachieved in TEXTPRO by inserting extra spaces between words until theline is the requ }ired length. This can be a problem since spaces cansometimes be inserted in places where you do not want them, such asb }etween entries in a columnar table. You may also have wordcombinations that you do not want broken at the end o }f a line by theautomatic word wrap. For word combinations that require fixed spacingor that you wish to have treated }as one word just use hard spacesinstead of normal spaces between the words. This will cause theformatter to regard }the phrase as one word for justification and wordwrap. This will retain your desired format without effecting thecont }ext of the document since the hard spaces will be sent to theprinter as a normal space character.You may also creat }e non-printing tags for your text file by definingprint keys of your choice as the null character of your particularpri }nter or by using an undefined print key. This can be very helpfulin finding your way around your document using the TEXTPR }O find stringfeature. When one of these print keys is encountered during printingit will simply be ignored. Put in as ma }ny as you like.You may embed control characters within the text simply by typingESCape prior to entering the keystrok }e. To enter the ESCAPE characterto the editor simply press ESC twice in succession. This is analternate method fo }r sending control characters to the printer but itis not recommended since these characters will be recognized by thefor }matter as printable characters and will throw off your linespacing. Learn to use the print keys for printer codes. }This procedure is mentioned because there is a practical value toentering control characters directly to the edi }tor. This is themethod used for editing the TEXTPRO command macro sequences. Duringmacro execution the equivalent of th }e control code will be sent to theprogram as an actual command. For instance, during a macro the CTRL-Lcharacter would b }e interpreted as a load file command. This is anexact replication of its function in the TEXTPRO editor. The specialTE }XTPRO character sets will display these control characters in adifferent font so they will be more easily identifie }d when writingmacros and tracing the sequence of macro execution.Page 9 * SECTION 2 *General Information }TEXTPRO features include:* Fast, full featured editor for easy text entry. More cursor movement, cut, paste a }nd replace flexibility than any other ATARI word processor.* Ability to cut and paste between files. Delete to end a }nd top of file. Save and load from the editor or get full DOS features from the disk menu for up to 8 drives.* Fas }t 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 function keys.* Full featured formatting including justification }, conditional page break, outdenting, headers, footers, page numbering, block right, and a file link feature for prin }ting large documents.* The ability to exit to DOS and 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 fi }les to screen. Copy files from device to device without leaving the program or losing text in editor. Append in } copy, save, or print to device operations.* Version 1.2 can be extended by machine language modules for extra fea }tures. Individual utility extensions are available now for additional directory and DOS functions, as well as }a keyboard buffer. Macro extensions offering multiple features are also available for DOS 2.0/2.5 and SpartaDOS. }* TEXTPRO uses no RAM under the OS and should be compatible with most DOS and hardware enhancements for any model of AT }ARI computer. - Supports the following hardware and software enhancements: o All RAMDISKS can be used from the D }OS menu or the editor. It does not matter which RAMDISK (AXLON, RAMBO, XE) is used as long as legal call }s to CIO are implemented by the software. o All versions of the Time/Date display of SPARTADOS up to Ve }rsion 3.2. o The program has been tested with the HAPPY running high speed I/O and with the US Doubler w }ith it's Ultra Speed package without difficulty. The menu also supports the use of 8 disk drives and can } be used with the new ICD drive modification for the 1050 which defines drives 5-8.Page 10...DOS PACKA }GES and TEXTPROTEXTPRO uses only legal calls to the operating system for input andoutput. Version 1.2a is the most r }ecent and powerful version of theprogram as of this writing. If you are still using v1.1 or v1.2 itwould probably be be }st to obtain a copy of 1.2a.The following is a result of test with various DOS packages.* SPARTADOSAll versions of SPA }RTADOS tested worked well with TEXTPRO, especiallywhen using all the additional DOS features. The TEXTPRO file entryrou }tines allow room for the use of sub directories and you can exit toDOS, use any built in DOS function except COPY, and }return to theprogram with your text intact. This is great for changing, deleting,or creating those directories.The SPAR }TADOS time/date line display and file stamping with either thesoftware clock or the R-Time 8 cartridge are both fully supp }orted asis the Ultra Speed disk IO enhancement for the 1050 drive providedwith the US Doubler. The TEXTPRO 1.2 }directory extension alsosupports the expanded directory listing used in the SPARTADOS format.The SPARTADOS macro extensi }ons for Version 1.2 add numerous features,including verify on/off, an exit to BASIC, and sub-directory supportfrom the TE }XTPRO disk menu to mention a few. You could spend a lot ofmoney on other machines and programs without finding a more poten }t andflexible word processing environment than that offered by the extendedTEXTPRO 1.2a and SPARTADOS. This is especially } true if you are luckyenough to have available the high speed disk IO of ICD's US Doublerenhancement. Find a system y }ou can test this combo on and give it atest drive. It may just save you some money. The SPARTADOS macroextensions a }re ICD Extension 2.3a/b. For more information onacquiring these extensions see the ASSOCIATED FILES section at the e }ndof this doc.This is a great DOS package for TEXTPRO, and a lot of other things.It has our highest recommendation.* } DOS 2/2.5Works with both versions of ATARI DOS equally well. If MEM.SAV isused the same ability to exit and use D }OS features works with theseDOS's. Most of the available DOS features required are available fromthe TEXTPRO menu and a }dditional features are available with TEXTPRO1.2 extensions making an exit to DOS with these packages hardlynecessar }y.Page 11There are also two macro extension files available for DOS 2.0/2.5.These are Extensions 2. }5b and 2.5c. These extensions will work withthe other DOS's but all of the features offered are only availablewhen usi }ng DOS 2.0/2.5. See the ASSOCIATED FILES section for moreinformation.* OSA+, Version 2.1Since TEXTPRO was develop }ed using this DOS and MAC-65 it works verywell with OSA+. Exits and re-runs beautifully retaining your filewhen re-run } with the RUN command.We do not have DOS-XL or OSA+ v4 so they could not be tested usingTEXTPRO. If these packages e }xhibit the same reliable features of theother OSS products we would anticipate no problems using TEXTPRO withthese DOS's. } We would appreciate any information regarding theperformance of TEXTPRO under these packages.* TOPDOS Version 1.5 }TEXTPRO 1.2 supports TOPDOS as long as the DOS is configured for aLOMEM setting of 1F00 or lower. This can be achieve }d by reducing thenumber of buffers to 3 when using the 130XE RAMDISK module. LOMEMsettings larger than 1F00 cause DO }S overwrite by the TEXTPRO programand will cause unpredictable results.It would be possible to configure a special ve }rsion of TEXTPRO tosupport the full features of this DOS. This would createcomplications with regard to exten }sions for this special version sincethe assembly address would have to be higher to accommodate the extraTOPDOS modules !}and the resulting absolute addresses of the equatesused for programming extensions would be different. For this reason "}we do not plan to publish this version at the present time. If wereceive enough requests for a special TOPDOS v #}ersion we willreconsider the option.* MACHDOSTEXTPRO 1.2 runs at full speed from MACHDOS XL. The only limitationfo $}und here is the lack of a RAMDISK module for those with the 130XE orother expanded RAM machines. At least we don't know of %}one.* MYDOSTEXTPRO 1.2 does not run from this DOS at all. This DOS reactsstrangely to the TEXTPRO extension &}initialization routines and thedirectory structure is not compatible with the TEXTPRO DOS menuroutines. Sorry, but '} for now if you want to use TEXTPRO, you'll haveto pick another DOS.Page 12 * SECTION 3 *TEXTPRO Version (}s...Differences between Versions 1.1 and 1.2In addition to the ability to load extension files there are also anumber )} of handy housekeeping improvements to TEXTPRO 1.2 that makeusing this version a bit easier. Some of these would not *}be noticedby a new user but old hands with TEXTPRO 1.1 will appreciate them.+ In TEXTPRO 1.1 the editor defaults to upper +}case after reset, run ataddress, or the copy command. TEXTPRO 1.2 returns in theconfiguration that it was ,}in when you left. As an added feature italso returns to your exact position in the file.+ When editing in the rep -}lace mode with TEXTPRO 1.2 the key will delete the character before the cursor butthe following .}text will remain in place. This allows easier andfaster editing of large text files and saves keystrokes when deleting /}and replacing text. You can use the toremove extra spaces left when editing in this mode. 0}+ The SPARTADOS run vector is set properly by TEXTPRO 1.2 and theprogram can be rerun after exiting to DOS with the RUN 1} command.+ In Version 1.2 the COPY command uses both the paste buffer and thefull unused space of the text buffer to spe 2}ed file transfer.+ The cold start selection of TEXTPRO v1.1 did not work properly andwould cold start the machine onl 3}y about half of the time. This bughas been corrected and TEXTPRO 1.2 will cold start every time usingthe combination. An additional feature of Version 1.2is the ability to cold start with BASIC disabled by pressing< 5}OPTION+RESET>.+ If you have an XL/XE machine and use a DOS that does not load intothe RAM area under the OS (DOS 2,2.5, 6}OSA+ etc.) you can gain an extra4K in the editor by using the translator with TEXTPRO 1.2. You musthave the cartridge 7} de-selected for the program to recognize theadditional RAM space.+ TEXTPRO 1.2 has a default filename "NAME.ME" tied 8} to the SELECT L/lfilename functions for the command line. This will prevent the nofilename errors caused by trying to 9} auto-save a file that had not beenpreviously loaded. This default filename also resets itself aftereach CLEAR all tex :}t command.+ The SELECT L/l filename command can also be used with Version 1.2 toprint to the message line from within ;} a macro. This allows macromessages to be developed using the current filename. A usefulapplication is to defin <}e OPTION L/l to print the name of the currenteditor file to the message line.Page 13+ After a copy to scr =}een command to display a HELP screen or othertext any OPTION keypress(macro) will be executed immediately usingVersion >} 1.2. This feature is enabled when the "Press any key" promptis displayed. This precludes having to press a key to retur ?}n to theeditor prior to entering the desired macro key. This feature willallow the creation of nested macro scre @}ens and will improve theusefulness of the TEXTPRO help screens or those of your own design.+ In Version 1.1 the "Wait for A} Keypress" macro command would clear themessage line. This has been corrected in TEXTPRO 1.2 to allow amessage to B}be printed and a wait for keypress to be issued. Themessage will not clear until the next keypress.+ The copy, prin C}t to disk, and save functions of TEXTPRO 1.2 have anappend feature that is selected like the ATARI DOS append. Whene D}xecuting a copy, print to disk, or save operation you can enter the/A extender to the filename to select an append. Th E}is feature alsoworks with the copy selection from the menu. Add the /A extender toperform an append of the highlighted f F}ile to the the target file.+ Two more print keys have been predefined in Version 1.2. Theinverse <5> equals decimal 13 G}and theinverse <6> equals decimal 10. These codes are universal as the carriage return and line feedcharacters r H}espectively and can be used to produce footnotes and toperform other formatting tricks with TEXTPRO.+ The Delete to End I} of File was altered in Version 1.2 to also deletethe character that the cursor is resting on. This is rather arbitrarybut J} this method seemed more conventional.+ The blank screen command* commandis available from the edi K}tor in TEXTPRO 1.2. If you are editingpassword files or some other confidential text you may want to usethis featur L}e if you quit editing for a while. Re-enable the displayusing the* command.There are other touch up M}s that have been included to the program butthey will be more noticeable for what won't happen than for what youcan do. N} We won't waste time documenting them. Overall, TEXTPRO 1.2is a smoother, more powerful, and easier to use version of O}TEXTPROthan v1.1.Page 14...IMPORTANT!+ Unlike Version 1.1 TEXTPRO 1.2 can be used to edit ANY file, even P}object code files, since all characters are now converted to theiroriginal form when saved to disk. Do not try this wi Q}th 1.1!!The editor characters displayed are different for a few keys and youmust keep this in mind when editing object o R}r BASIC files. It is alsopreferable to edit source code with the word wrap off since it is anirrelevant feature for this S} type of file and only limits the number ofcharacters displayed on screen. The conversions are as follows:* T} will appear as the inverse escape character in theTEXTPRO v1.2 editor.* will appear as an invers U}e carriage return.The text will also break on this character just as it does for anormal carriage return. This is V} just a quirk of TEXTPRO and has noadverse effect on the saved file.Pressing then during a replace or fin W}d operation willenter the return character to the command line without terminatingstring input. Use this method t X}o search and replace the characters if desired. This can be very handy for sometelecommunications n Y}eeds, such as replacing the ATARI carriage returnswith the ASCII CR/LF (CTRL-M/CTRL-J) combinations....EXTENDING TEXTPRO Z}We aren't likely to think of everything, and since we are aware of thedesire of many of you to alter the program for you [}r own purposes wehave built a rather unique feature into TEXTPRO 1.2. Before wecontinue let me digress with a bit o \}f explanation regarding the designof the program.It is hoped that TEXTPRO 1.2 will be the last full implementation ofth ]}e program. We are committed to fixing any disastrous bugs that maypop up in operation but we are relatively sure that ^} you will findVersion 1.2 to be a reliable program. Some of you have asked for thesource code to TEXTPRO but we both feel _} that it would be a bad idea tohave a lot of different versions of "TEXTPRO" floating around. Inaddition, the task `}of commenting the expanded source code files forreadability would not be trivial. There are only 5 or so sectors lefton t a}he source code disk and we did not comment the program very muchas we went along.We regret these circumstances since it b} is not our intention to closeTEXTPRO development to those who feel they can improve it. Read onand you may find that c}there is an easier way to add your own featuresto TEXTPRO.Page 15When TEXTPRO 1.2 loads it looks for a fi d}le named TEXTPRO.EXT on thedisk. If this file is present it is loaded and initialized at runtimeand on RESET. This is e} an ideal method for loading such things askeyboard buffers and other short utilities. For most people this willbe the on f}ly use for this feature that is needed or desired.You assembly and ACTION! programmers will be pleased to know thatTE g}XTPRO 1.2 has been opened at numerous locations to be hooked bymachine language extensions to the program. These exten q}BŠ b%DOS SYSb.)AUTORUN SYSb5WTEXTPRO PRTb;EXTEND25PRTsion files canbe loaded and initialized using the TEXTPRO.EXT feature to beavailable automatically at runtime. r} The hooks supplied should besufficient to provide for powerful extended features that are fullyintegrated with the TE s}XTPRO routines.There are hooks available for editor, print, and file routines. It ishoped that in the future all enhance t}ments to the TEXTPRO program willbe published as extensions to and not as revisions of the program.This method offers u} advantages in development time and will give youthe opportunity to do your own thing without the need to assemble theent v}ire program. It will also allow additional features to be selectedindividually for specific applications rather than sacri w}ficing memoryin the main program for features that are not frequently needed. Onefinal benefit is that the program itse x}lf will remain unchanged and arelative amount of compatibility assured.Please be patient until we can compile all of the y}information that isrequired for programming extensions into a readable format. Since wemust develop and test the procedu z}res that must be followed in hookingto TEXTPRO it will take a little time before the documentation will becomplete. The {}resulting programmer's notes for TEXTPRO extensionswill be published as a separate document and posted as soon as it is |}available.The initial extension files are produced as Page 6 utilities. A macroextension file will be prepared for DOS 2 }}.0/2.5 and Spartados. Thesemacro extensions will contain DOS specific functions, like binaryload, and will combine im ~}proved versions of the Page 6 extensions. Noeditor memory will be sacrificed to load these macro extensions sincethey wil }l load to a pre-selected area of memory....PROGRAMMER'S NOTESThe LOAD and RUN address of TEXTPRO Ver1.1 and Ver1.2, } is $1F00,in both of these versions. The paste buffer and the macro bufferare fixed at 3K each for all versions }. The copy routine used byTEXTPRO uses the paste buffer for file transfer so text stored therewill be lost when COPY is }used. Version 1.2 also uses the full unusedmemory of the text buffer to speed file transfer.Page 16The }infamous PAGE SIX is free and can be used for a keyboard bufferprogram or other utilities as desired. This can help t }o make textentry at the top of a large file more reliable if not faster. Thebest solution for rapid editing through }out the file is to keep yourfiles under 12K or so. Use separate modules with the link filefeature to produce larg }e documents. This method was used to producethis documentation and provides an effective method of producingdocument }s of any length. For you assembly language programmers page zero locations $CB through$CF are also free for your us }e in writing utilities or TEXTPROextensions.It should be noted that if you use SPARTADOS Version 2.3 with TEXTPRO1.2 }or 1.1 there is sufficient room above DOS for the SPARTADOS RS232handler to remain resident. This is the only DOS that has }a LOMEM lowenough to allow this. If you have a serial printer this is animportant consideration when selecting a D }OS package.The extra RAM of your 130XE or modified 800 machine can be used to itsmaximum by using the RAMDISK with t }he Keyboard Macro Feature toemulate a multiple open buffer system that can be called with a singlekeypress. The MOSAIC } and AXLON boards work identically in thisapplication to the 130. The macro to implement this feature isalready } written into the STYLE10 Version 1.2 macro file for TEXTPRO.This macro defines the RAMDISK as D8:. If your RAMDISK is }set for adifferent drive number simply edit the macro to suit. Within thelimitations of RAMDISK size you can ha }ve up to 64 files in RAMsimultaneously and they can be accessed and manipulated from a menuwithout ever typing in a f }ilename. Using SPARTADOS you can even havedifferent subdirectories on the RAMDISK and switch between them with afew keystr }okes.Unlike true multiple RAM buffers the RAMDISK can also contain othertypes of files (BASIC etc.) for use from D }OS;#]. One of the mostuseful features of this method is to list BASIC programs to theRAMDISK, load them to TEXTPRO } with the word wrap and carriage returnsoff and a 38 column screen width to mimic the BASIC editor and thenedit, cut, p }aste, search/replace and manipulate the file as you wish.You can then exit to DOS, go to BASIC and ENTER your program f }romRAMDISK for testing. This is only one example of the flexibilityoffered by TEXTPRO.This method is especially } useful when used in conjunction with thefine LBASIC program by Kent Peterson published in ANALOG. Use the Exitto Basic fea }ture to make using TEXTPRO with LBASIC a breeze.TEXTPRO will disable BASIC automatically on load unless the OPTION keyis }held down during the load. If OPTION is held down until the titlescreen appears BASIC will remain resident and the text } buffer willlose 8K of RAM space. Do not try to exit TEXTPRO to DOS and then usePage 17BASIC if BASIC is e }nabled in this way. The reason for this is the useof BASIC's page zero pointers by TEXTPRO. Running BASIC after exitingTE }XTPRO without resetting these pointers can cause unpredictableresults. The Exit to BASIC feature supplied in e }xtensions willproperly reset BASIC and should be used if available. If you useSPARTADOS there will be no conflict at }all if you use the BASIC ON/OFFcommands.It should be noted that the BASIC disable on load does not work withSPARTADOS }due to conflict with internal DOS routines and you shoulduse BASIC OFF from a batch file before loading TEXTPRO.One poss }ible reason to leave BASIC resident when loading TEXTPRO is togive 800XL owners access to a RAMDISK under BASIC. SPARTADOS } alreadyprovides a program for this application. Since the RAMDISK offersabout 6K of storage and the loss of RAM t }o BASIC is 8K the loss ofmemory for this application is only about 2K.ASSOCIATED FILES:-----------------* SUPPORT.001 } - This is a compound file containing macro, text, andbinary files. Used with TEXTPRO 1.2 it will create a 23 file suppo }rtsystem on a disk, including 3 fonts, 5 extensions, 14 help screens,and more!* SUPPORT.002 - This compound file wil }l create the 5 extension filesand the doc file. DL this file if you already have the help screensand just want the exten }sion files.* SUPPORT.025 - This file contains EXTENSION 2.5b and 2.5c and theirdocumentation. These are "macro-extens }ions" that combine and addimproved versions of many of the Page 6 extension files. The size ofthe editor memory is }unaffected and Page 6 is left free when theseextensions are loaded.* SUPPORT.023 - This file contains ICD Extensions 2. }3a and 2.3b. Thedocumentation describing the extensions is included in the file.Note:All files are available on the }SOFTWARE PLUS+ BBS and COMPUSERVE.Extensions in the SUPPORT files are:TPBLOAD.EXT - Binary load extension for DOS 2.0/2.5 }.TPERR.EXT --- Plain english error messages provided.BUFFER.EXT -- Keyboard buffer for TEXTPRO.XDIR.EXT ---- Provides exte }nded directory features.TPBASIC.EXT - Exit to BASIC extension for XE/XL machines.Page 18EXTENSION 2.5b/c - } These are macro-extension files for DOS 2.0/2.5that contain improved versions of all of the above extensions. The" }c" version also installs the key buffer to Page 6. Also included isa selection to choose write with verify on or off. }The binary loadand verify selections of this extension work only with DOS 2.0/2.5.ICD EXTENSION 2.3a/b - These are } macro-extensions for SPARTADOSVersions 2x and up. Features include all those mentioned above inaddition to menu s }upport for the SPARTADOS sub directories. The "a"version sorts the disk menu automatically, the "b" version sorts bycom }mand. The keyboard buffer is not included with these extensionssince SPARTADOS supplies its own key buffer routines.S }PECIAL MACRO SPECIFIERS: Entered as [macro key] in Macro File-------------------------------------------------------------- }@ .... Startup Macro# .... START Key Macro? .... HELP Key MacroATARI CONTROL COMMANDS: Entered with CONTROL------------ }--------------------------------1 .... Pause Screen Listing2 .... Ring BellCOMMANDS AVAILABLE FROM MACROS: Entered with }ESC then SELECT-CTRL-----------------------------------------------------------------A Moves cursor left one spaceE Erase } G Goto Macro I Input Mode (Special text entry mode)K Wait for KeypressM Print to Messag }e Line (persistent)P Pre-Select Macro If followed by a Load Macro command will go to the selected macro in the } chained fileR Rename Y Print to Message Line (until next keypress)PRE-PROGRAMMED PRINT } KEYS: Enter with SELECT--------------------------------------------<.> Decimal value .... 32 (hard space)<1> Decimal val }ue .... 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 com }mand)Page 19TEXTPRO PRINT COMMANDS: Enter with SELECT key-----------------------------[Default]------ot }tom margin 58enter textdge rightooter defineo to linked fileeader definenformation l }ineelect linefeedseft margin 5argin releaseext page, conditional with # 0

age length } 66justify right 0=off 1=on offight margin 75ine spacing } 1op margin 5nderline togglepage wait offcolumns across } 80<#>page number<@>starting page number 1print starting with # 1SPECIAL CASE KEYS: Entered on Com }mand Line------------------------------------------ and When entered in macros or pressed during com }mand line entry in a load,save, or save macro operation these keys print the name of the lastfile loaded to the command }line. prints the name without device to the command line prints the name with the load device to the c }ommand lineFEATURES AVAILABLE WITH EXTENSIONS---------------------------------- .... Binary Load feature to print the desired directory mask tothe message line. T}his feature has been added to this extension to saveyou some keystrokes. One caution, however. Be careful not to save a file}using the .From the menu...Extension 2.3 }supplies menu support for the special SPARTADOSsub-directories. These will appear in the menu with the ext "DIR" ininverse }video. To change the working directory to a sub-directory put thewide bar cursor on the directory of your choice and press}">" the right pointing wedge.The current working directory will be changed to your selection and thefiles in the new dire}ctory will be displayed on the screen. To back up tothe root directory just press"<" the left pointing wedge.You will g}o back one level to the root directory.You can also delete an empty directory by placing the cursor over thedirectory name} and using the CTRL-D(elete) command. The directory MUST beempty for this command to work. If the directory is not empty you} will geterror #167.To verify or not to verify...A little lagniappe (in NOLA that means something extra for free) is als}oincluded that hasn't been published in an extension before. Just press<;> yep, that's the semi-colonto to}ggle between write with verify on or off. The program will originallyload in the verify mode selected by the DOS. You can sa}ve the desired DOSconfiguration by exiting to DOS and saving DOS files. No more pokingaround with BASIC to change the DOS v}erify mode on your disk.This is another of those DOS specific selections and will only work withOSA+ in addition to the AT}ARI/SPARTA DOS's. This key is disabled for otherDOSs.This rounds out the utilization of TEXTPRO 1.2 with these extensions.} Wehope you enjoy it.GOOD LUCKRONNIE & MIKEs rounds out the utilization of TEXTPRO 1.2 with these extensions.;SEATTLE-PUGET SOUND ATARI COMPUTERENTHUS- IASTS ˠϠӠUpdated:Mar15,88Ast.Lib.M. Ingle