This is a list of all the scripts that come with Textra 1.16, accompanied by a short description and an example of their use. All scriptnames (minus the '.textra'), with or without arguments, may be enetered in any of the 10 saveable string gadgets in the ARexx requester. 8 of these are bound to a function key. Textra will bind scripts named CTRLA.textra, CTRLB.textra, etc. to the appropriate CTRL-key combination. Case-insensitive, up to 26 CTRL key combinations may be defined for chars A thru Z. of course, such scripts do not accept arguments in the normal sense, but can look at environment variables, files, etc. A complete glossary of the 70+ available commands that make up the Textra-ARexx interface is included in the Textra package, (in the RexxCommand.doc file) as well as full documentation for all editor features (in the Textra.doc file). General Textra ARexx scripts =========================================================================== AddIcon.textra - With just a little setup work, this script can be used to create Workbench icons for your Textra files. Double-clicking on them opens the text file in Textra! Art1.textra & Art2.textra - neat random-movement ascii graphics... hard to believe it's a text editor! Thanks to Nick Didkovsky (saying thanks to Nick gets to be a habit!), long-time JForth guru. bol.textra - Moves the cursor to the beginning of the current line (In Textra 1.15 and higher, 'column 0' is faster) Usage: bol date.textra - Writes the current date at the cursor/select location Usage: date DelToEnd.textra - Deletes from the current cursor/select to the end of the line (sounds ominous, eh?) Usage: deltoend DelToStart.textra - Deletes from the current cursor/select to the beginning of the line. Usage: deltostart DelWholeLine.textra - Deletes the entire cursor/select line Usage: delwholeline DoubleSpace.textra - Adds a blank line between every line in the selected range Usage: Doublespace eol.textra - Moves the cursor to the end of the current line (In Textra 1.15 and higher, 'column "-1"' is faster) Usage: eol eval.textra - Select a mathematical expression, eval will calculate it and display the answer, and even optionally insert the answer in the text document at the current cursor/select position! Usage: eval (displays answer in requester) eval (inserts answer in document) Files.textra - Opens a window and presents a very informative display of summary information for each open Textra window (#lines, size in ram & on disk, 'changed' status, window position, more) Usage: files Hello.textra - Simple example of text insertion and delay timing. Usage: hello indent.textra - Similar to slide.textra, this script will also shift selected lines of text left or right, but uses TABs for the whitespace character (slide.textra uses BLANKs) See scoot.textra and slide.textra. Usage: indent 2 (shifts 2 TAB chars right) indent -2 (shifts 2 TAB chars left) InsertF.textra - recommend you assign this to a CTRL or F- key. Then, enter & select the filename, then at the touch of that key, the file is inserted. MarkAutodoc.textra - Open any standard Commodore autodoc file and let this script fly! When done, there will be a defined MARK for every function described, allowing you to save the MARKS info permanently without changing the original autodoc file at all! Your autodoc-navigating problems are over. (without AmigaGuide and it's overhead) Usage: MarkAutoDoc paragraph.textra - Used for paragraph formatting, works on the selected lines, accepts 3 arguments: 1. left margin of first line 2. left margin of all following lines in selection 3. right margin for all lines. Multiple paragraphs may be formatted, just put a blank line between each intended paragraph. Usage: paragraph 12 8 68 Scary.textra - Simple example of conditional branching and prompting the user with a YES/NO question and waiting for the answer. Usage: scary Scoot.textra - A very versatile script that really replaces both slide.textra and indent.textra. This one also shifts blocks of text left and right, and can be told to use EITHER TABs or BLANKs for whitespace! It can also be used to convert between the two (entab & reverse entab) with no visible change. The only disadvantage is that it is slightly slower than either of it's subsets (so they remain in the package). Usage: scoot 0 (entabs) scoot 12 scoot -2 ScootTest.textra - Can be used with scoot.textra for making sure a left-shift argument will not lose any characters by inadvertantly being too large. Usage: scoot -2 SingleSpace.textra - Removes all blank lines in the select range. Usage: SingleSpace Slide.textra - Similar to indent.textra, this script will also shift selected lines of text left or right, but uses BLANKs for the whitespace character (indent.textra uses TABs) Also see scoot.textra. Usage: slide 14 slide -4 StartTextra.rexx - Not intended for use from textra, this script can be used by other applications as a convienient way to open Textra on a given file. Usage: rx 'starttextra ' TInfo.textra - Illustrates use of the Textra PREFS Arexx command, as well as illustrating Textra's excellent error recovery when an illegal argument is passed. usage: TInfo Tutorial.textra - Self explanatory. Usage: Tutorial WhereAmI.textra - Sample of reading/interpreting cursor or select position. Usage: WhereAmI General C Language scripts =========================================================================== Box.textra - Select some lines and enter Box, all will be commented out with an orderly box of '*' chars. Usage: box MarkCFuncs.textra - Creates a defined MARK for all the functions in your C source file. Usage: markcfuncs UnBox.textra - Removes the comment "box" created by box.textra. Usage: unbox Scripts to integrate with SAS/C =========================================================================== CTRLB.textra - Press CTRL-B to 'B'uild current project. This is the easy way to restart the compiler after you have made changes to the source... even checks for the existence of a make file! Usage: ctrlb (automatically bound to CTRL-B key) CTRLF.textra - Press CTRL-F to 'F'ind current symbol. Similar to the script provided with SE, this will allow you to place the cursor on a C symbol (such as 'strlen', et. al.), and GSTs will be searched for that symbol, with a new window popping up with the file that symbol is defined in if found. Usage: ctrlf (automatically bound to CTRL-F key) CTRLN.textra - Press CTRL-N to step to the 'N'ext compiler error/warning. Usage: ctrln (automatically bound to CTRL-N key) CTRLP.textra - Press CTRL-P to step to the 'P'revious compiler error/warning. Usage: ctrlp (automatically bound to CTRL-P key) SCMSG - Sample SAS/C compiler config file to tell SAS/C to use Textra. Usage: See SASC.readme in Textra package. Scripts to integrate with HS/Pascal =========================================================================== HScompile.textra - Invokes HS/Pascal to compile the selected file. Usage: hscompile Scripts to integrate with JForth Professional =========================================================================== DeferStub.textra - This simple AREXX script is useful for assigning stub words to deferred words in JForth source code. Usage: DeferStub (on selected text) interpret.textra - Send the selected text to the JForth interpreter. Usage: interpret JCompile.textra - Tell JForth to compile the selected file. Usage: JCompile jfcomment.textra - Comment out the selected lines, or uncomment them if already commented out. Usage: jfcomment jfcomment jFILE?.textra - Accepts the name of a JForth function, passes it to the JForth FILE? function. Usage: jfile? MarkColons.textra - Finds and MARKS all high-level definitions in a JForth source file (colon definitions) Usage: markcolons nextcolon.textra - Locates the next colon definition in the file, following the current cursor/select position. Usage: nextcolon Textra.f - JForth source file which must be compiled into your JForth before you can use the view.textra or viewsel.textra scripts. Usage: compiled into JForth tojf.textra - accepts a string and passes it to the JForth interpreter. Usage: tojf view.textra - accepts the name of a JForth function name and opens the souce file and locates the definition. (JForth must be running and listening to ARExx. Also, see Textra.f). Usage: view viewsel.textra - Considers the selected text to be a JForth function name and opens the souce file and locates the definition. (JForth must be running and listening to ARExx. Also, see Textra.f). Usage: viewsel zDotIf.textra - used to conditionally comment in-or-out the selected lines of source code by inserting/deleting pairs of "0 .IF" and ".THEN" statements. Usage: zDotIf