STEX OPERATING INSTRUCTIONS a (BEGIN LINE) See BEGIN LINE b (END) See END c (CHANGE CASE OF CHARACTER) See CASE CHANGE d (DELETE WORD) e (END OF LINE) See END LINE f (FORMAT PARAGRAPH) g (GOTO MERGE FILE) See GOTO MERGE FILE h (ONLINE HELP) See ONLINE HELP i (INSERT SPACE CHARACTER) j (unused) k (SCROLL UP) See SCROLL UP l (LOWERCASE WORD) m (CURSOR LEFT) See CURSOR LEFT n (SPELL MENU) o (OTHER MERGE FILE) See OTHER DOCUMENT p (PREVIOUS MERGE FILE) See PREVIOUS MERGE FILE q (SAVE MISSPELLED WORD) r (SCROLL RIGHT) See SCROLL RIGHT s (SCROLL LEFT) See SCROLL LEFT t (BEGIN) See BEGIN u (UPPERCASE WORD) v (SCROLL DOWN) See SCROLL DOWN w (PASTE WORD) See PASTE WORD x (MACRO EXECUTE) See MACRO EXECUTE y (MACRO COLLECT) See MACRO COLLECT z (MACRO STOP) See MACRO STOP , (BACK SENTENCE) . (NEXT SENTENCE) / (COPY SENTENCE) ; (PASTE SENTENCE) ' (DELETE SENTENCE) HELP FOR STEX. Screen TEXt editor. Use the "stex" command as follows: stex [pathname] [-c config_file] [-m merge_path] [-kb keyboard] [-help] [-preload] [-wrap] [-ml macro_path] [-mlx macro_path] where "pathname" is the LOAD pathname of the file to edit. "-c" reads the configuration file in \STEX\CONFIG\config_file. "-m" is used to merge into memory a second document from disk named "merge_path" (ie. a MERGE file). "-kb" is used to set the keyboard type to "keyboard". The default keyboard type is "PC" (see below). "-help" displays this screen. "-preload" is used to extract part of the file prior to editing. "-wrap" wraps the cursor to the next line instead of scrolling left. "-ml" loads a STEX macro named macro_path. "-mlx" loads a STEX macro named macro_path and executes it. If "pathname" is used then the requested file is read into memory and edit mode is entered, otherwise the STEX menu is displayed unless the "-help" option is selected. To EXIT edit mode press the "MENU" function key or press the "" key twice. Note that online help is available while in EDIT mode by pressing the "" function key or pressing "C" followed by "HELP". Keyboard types are defined in the file "\STEX\FUNCTION\KEYS.PC" This file may be modified by STEX in order to tailor keyboards to individual user requirements. Online help is also available for: COMMAND MODE C A (ADD BLANK TEXT LINES) AGRAM (ANAGRAM) AP (APPEND TEXT TO END OF LINE(S)) BR (BRIEF mode) C (CHANGE TEXT LINES (MULTI)) D (DELETE TEXT LINES (MULTI)) DIR (Directory of STEX files) E (ERASE TEXT LINES (MULTI)) FCOL (FIND TEXT FORWARDS IN COLUMN) FIL (File the current document) FILL (FILL COLUMNS WITH TEXT) FLEN (Find length of text) G (GET TEXT LINE(S)) HELP (ONLINE HELP) KB (SET KEYBOARD TYPE) LCOL (LOCATE TEXT IN COLUMN) LINES (LINE NUMBER DISPLAY) LOAD (LOAD FILE) L (LOCATE TEXT (ALL occurrences) LP (Set LEFT POINTER) INDENT (set the paragraph indent) MARGIN (set the paragraph left margin) ML (MACRO LOAD) MR (MACRO REPEAT) MS (MACRO SAVE) MLX (MACRO LOAD AND EXECUTE) N (NEXT LOGICAL LINE) N- (PREVIOUS LOGICAL LINE) PO (POINT TO LOGICAL LINE NUMBER) R (RESUME SHELL PROGRAM) RP (RIGHT POINTER) SPELL (check spelling of a word) TABS (Show TAB stops) TABSET (Set TAB stops) T (TRANSFER TEXT LINE(S)) UCOL (FIND TEXT UPWARDS IN COLUMN) VE (VERIFY mode) W (WHERE YOU ARE WITHIN DOCUMENT) WRAP (Word wrap lines of text) Y (YANK BACK LINE(S)) ! (Execute command as in Command Prompt) #Dn (Convert decimal number to binary (0 to 255)) CURSOR CONTROL KEYS UP CURSOR K DOWN CURSOR V RIGHT CURSOR L LEFT CURSOR H HOME CURSOR ^ TAB CURSOR I ENTER KEY M LINE EDITING KEYS ERASE LINE E GET TEXT LINE G LEFT CURSOR H TAB CURSOR I RIGHT CURSOR L ENTER KEY M REDISPLAY LINE R TRANSFER TEXT LINE T LITERAL MODE X TOGGLE OVERLAY/INSERT Z CHAR INSERT S CHAR DELETE _ HOME CURSOR ^ SCREEN EDITING KEYS CHAR INSERT S CHAR DELETE _ LINE INSERT A LINE DELETE D ERASE LINE E WORD EDITING KEYS COPY WORD W PASTE WORD w DELETE WORD d BACK WORD B NEXT WORD N SENTENCE EDITING KEYS BACK SENTENCE , NEXT SENTENCE . COPY SENTENCE / PASTE SENTENCE ; DELETE SENTENCE ' CONTROL KEYS BACK WORD B COPY WORD W CURSOR TAB I DOWN CURSOR V FIND TEXT F FIND TEXT AGAIN P FIND TEXT UPWARDS U GET TEXT G INSERT LINE A KEYBOARD ON or OFF S LEFT CURSOR H LINE DELETE D LINE ERASE E LITERAL MODE X MODE COMMAND C NEXT SCREEN \ NEXT WORD N OVERLAY AND INSERT MODE Z OTHER DOCUMENT O PREVIOUS SCREEN ] REDISPLAY LINE R ENTER KEY M RIGHT CURSOR L SPELL CHECK Q TRANSFER TEXT T UP CURSOR K YANK BACK LINE Y FUNCTION KEYS BEGIN (Top of Document) BEGIN LINE CASE CHANGE CURSOR LEFT END (End of Document) END LINE GOTO MERGE FILE MACRO COLLECT MACRO EXECUTE MACRO STOP ONLINE HELP OTHER (Merge file) PASTE WORD PREVIOUS (Merge file) SCROLL DOWN SCROLL LEFT SCROLL RIGHT SCROLL UP MENU DISPLAY Edit file Load file Clear all Save file Merge file Process Command Quit STEX Help SPELL MENU G Ignore all words I Ignore one word W Add to database of correctly spelled words A Change ALL words C Change ONE word ? Enter new word (with wildcard "*" and/or "?") N Next word or skip Q Quit Spell Menu H Hide Spell Menu WILDCARD CHARACTERS The following STEX commands allow the use of wildcard characters: CONTROL KEYS FIND TEXT FORWARDS F FIND TEXT UPWARDS U FIND TEXT AGAIN P COMMAND MODE C C (CHANGE TEXT LINES (MULTI)) L (LOCATE TEXT (ALL occurrences) Using wildcard characters to locate a wild string within another Valid wildcard characters are "*", "?", "<", ">" and ";" where * Matches with 0 or more instances of ANY character or set of characters ? Matches with any ONE character < Look for any string BEGINNING with the wild string that follows e.g. <*q?ick matches a string beginning with "the quick" > Look for any string ENDING with the wild string that follows e.g. >l?z*g matches a string ending with "lazy dog" ; Used as an ending DELIMITER for the find string with trailing blanks \ Must appear at start of WILD_STR to ESCAPE any subsequent characters NOTE: The Escape Character ("\" Backslash) preserves the case of all text NOTE: Text entered may contain zero, one or many wildcard characters MISCELLANEOUS FUNCTION KEYS OPTIONS SLOAD SMERGE ALPHABETICAL LIST OF CONTROL KEYS The following control sequences are supported: CTRL A Insert line (Add line) CTRL B Back word CTRL C COMMAND MODE CTRL D Delete line CTRL E Erase line CTRL F Find text forwards CTRL G Get text line into copy buffer CTRL H Backspace CTRL I Tab CTRL K Up arrow (Up line) CTRL L Right arrow (Duplicate) CTRL M Enter (Begin next line) CTRL N Next word CTRL O Other document CTRL P Find Text Again CTRL Q Spell word CTRL R Redisplay line CTRL S Insert character CTRL T Transfer text line from copy buffer CTRL U Find text upwards CTRL V Down arrow (Down line) CTRL W Copy word CTRL X Literal mode CTRL Y Yank line from delete buffer CTRL Z Toggle overlay/insert CTRL \ Page down (Next screen) CTRL ] Page up (Previous screen) CTRL ^ Home cursor CTRL _ Delete character ALPHABETICAL LIST OF ESCAPE FUNCTION KEYS The following escape sequences are supported: ESC a Move to start of line ESC b Bottom of document ESC c Change case of character ESC d Delete word ESC e Move to end of line ESC f Format paragraph ESC g Goto Merge document ESC h Help ESC i Insert character ESC k Scroll up ESC l Convert word to lower case ESC m Move left ESC n Spell menu ESC o Other Merge document ESC p Previous Merge document ESC q Append word to LOCAL Spelling ESC r Scroll right ESC s Scroll left ESC t Top of document ESC u Convert word to upper case ESC v Scroll down ESC w Paste word ESC x Execute macro ESC y Collect macro ESC z Stop collect macro ESC , Back sentence ESC . Next sentence ESC / Copy sentence ESC ; Paste sentence ESC ' Delete sentence ESC ESC Menu ESC 1 Menu option 1 (Edit file) ESC 2 Menu option 2 (Load file) ESC 3 Menu option 3 (Clear all) ESC 4 Menu option 4 (Save file) ESC 5 Menu option 5 (Merge file) ESC 6 Menu option 6 (Process Command) ESC 7 Menu option 7 (Quit STEX)  :203 COMMAND MODE C Enters COMMAND MODE. The following commands are supported: A Add blank text into the document AGRAM Anagram find AP Append text to end of line BR BRief mode C Multi Change text lines D Multi Delete text lines DIR DIRectory of STEX files E Multi Erase text lines FCOL Find text forwards in column FIL File the current document (i.e. save) FILL Fill column with "text" FLEN Find length of text G Get one or more lines of text into buffer H Help details INDENT Set the paragraph indent KB Keyboard type L Locate all occurrences of text LCOL Locate text in current cursor COLumn LI Display screen with line numbers LOAD Load file and insert contents before the line containing the cursor LP Left Pointer of screen MARGIN Set the paragraph left margin ML Macro Load MLX Macro Load and Execute MR Macro repeat MS Macro Save N Next logical line N- Previous logical line PO POint to logical line number R Resume SHELL program RP Right Pointer of screen SPELL Check spelling of a word T Transfer text line(s) of text from buffer TABS Display TAB stops and allow to change TABSET Set TAB stops UCOL Find text upwards in column VE VErify mode W Display Where you are within the document WRAP Line wrap on or off Y Yank back one or more lines of text ! Execute a SHELL command #Dn Convert decimal number to binary ADD BLANK TEXT LINES (COMMAND MODE) Add blank text lines into the document. Blank text is effectively inserted AFTER the line containing the cursor. The format is as follows: (i) An where "n" is the number of blank lines to add into the text. After the text has been added the screen is redisplayed. The added blank lines will appear immediately after. AGRAM (COMMAND MODE) Display all matching anagrams for a given word. An anagram is direct word switch or word play, the result of rearranging the letters of a single word to produce a new word, using all the original letters exactly once. The format is as follows: (i) AGRAM word where "word" is the anagram name to rearrange. An example is "AGRAM moonystar" The word "astronomy" is then displayed. APPEND TEXT TO END OF LINE(S) (COMMAND MODE) Append text to the end of a specified number of text lines. This command is useful for appending text strings to the end of a line for a number of lines. The format is as follows: (i) AP text{;count} where "text" is the string to append to the end of each line of text within the document starting at the cursor position and "count" is an OPTIONAL count of the number of lines to append to. After the text has been appended the screen is redisplayed. BRIEF (COMMAND MODE) Suppresses the verification of output produced by the Change command. See also VERIFY. CHANGE TEXT LINES (MULTI) (COMMAND MODE) Multi change text lines. Text is changed from the current line containing the cursor for a specified number of lines. The format is as follows: (i) C/xxx/yyy/{;count} where "xxx" is the text to find, "yyy" is the replacement text and "count" is an OPTIONAL count of the number of lines to change. The string represented by "xxx" or "yyy" may be from 1 to 30 characters in length. More than one occurrence on each line of "xxx" is replaced by "yyy". As each line is changed the replaced line is displayed on the screen. At document end press the "" key to continue editing. (ii) C//yyy/{;count} where "yyy" is the string to insert BEFORE each line of text within the document starting at the cursor position and "count" is an OPTIONAL count of the number of lines to change. Changes are NOT displayed for this option. In both cases above the characters "/" and ";" represent delimiters. Other delimiters include ";,.<>?". See next screen for special use ! NOTE1: If "count" is NOT supplied the default count is assumed to be one. NOTE2: If "C" only is entered then the last multi change command will be displayed. This may then be re-executed "as is" or modified using the arrow and/or edit keys and then executed by pressing "". DELETE TEXT LINES (MULTI) (COMMAND MODE) Multi delete text lines. Lines are deleted from the line containing the cursor for as many lines as requested. The format is as follows: Dn where "n" is an integer number of lines to delete from 1 to 999999. To delete from the cursor to end of document use D999999 or any value greater than the last line number. Deleted lines may be re-inserted at either the same location or at another location within the same or another document. See also "YANK BACK". ERASE TEXT LINES (MULTI) (COMMAND MODE) Multi erase text lines. Lines are erased from the line containing the cursor for as many lines as requested. The format is as follows: En where "n" is an integer number of lines to erase from 1 to 999999. To erase from the cursor to end of document use E999999 or any value greater than the last line number. Erased lines are blanked out from the current column position on the screen for as many lines as specified in "n". See also E and DELETE TEXT LINES (MULTI). DIR (COMMAND MODE) This command displays the STEX Directory listing of all files loaded or merged by STEX. The number of files in memory and the available text lines in memory are displayed. The LOAD file is denoted by file number "0", while MERGE files are numbered from "1" to "128". The number of text lines is also shown for each file, while an "*" denotes the current MERGE file. The format is as follows: DIR After selecting this option any file displayed may be edited by entering its file number followed by the "" key. FCOL (FIND TEXT IN COLUMN) (COMMAND MODE) The document will be searched from the cursor forwards for the "find text" in the COLUMN where the cursor currently resides. The format is as follows: FCOL text; where "text" is the text string to search for starting at the current cursor position. The delimiter ";" is used if the find string ends in one or more blanks. eg. "FCOL this ;" will search for "this ". It is important to position the cursor at the correct position within the document as the search will begin from the current document row and only search each line at the current cursor column. NOTE1: If "FCOL" only is entered then the last find forwards by column command will be displayed. This may then be re-executed "as is" or modified using the arrow and/or edit keys and then executed by pressing "". See also F and U for searching forwards and upwards respectively. FIL (COMMAND MODE) File the current document. This command provides a means of doing a quick save of the document currently being edited The format is as follows: FIL No options are allowed. If the file already exists on disk then it will be overwritten. FILL COLUMNS WITH TEXT (COMMAND MODE) Multi fill text columns with text. Fill each line in the document with "text" from the current cursor position for a specified number of lines. The format is as follows: FILL text;{;count} where "text" is the text string to fill each line with starting at the current cursor position. The delimiter ";" is used if the fill string ends in one or more blanks. eg. "FILL all this ;" fills each column with "all this ". "count" is an OPTIONAL count of the number of lines to fill. It defaults to one. It is important to position the cursor at the correct position within the document before executing this command. See next screen for special use ! NOTE1: If "FILL" only is entered then the last fill by column command will be displayed. This may then be re-executed "as is" or modified using the arrow and/or edit keys and then executed by pressing "". FLEN (Find length of text) (COMMAND MODE) This command finds the text matching a specific line length and displays it on the screen. The format is as follows: FLEN xx n where "xx" is a logical operator as follows: "EQ" is equal to "NE" is not equal to "GT" is greater than "GE" is greater than or equal to "LT" is less than "LE" is less than or equal to and "n" is an integer line length from 0 to 512. For example "FLEN EQ 80" will display the first line from the cursor matching a length of 80 characters, while "FLEN GE 10" will display the first line from the cursor which is greater than or equal to 10 characters in length. GET TEXT LINE(S) (COMMAND MODE) This command gets text into a "COPY" buffer. The line containing the cursor is "remembered" by storing its address in "last in first out" order. When combined with the "T" command (transfer text TO screen from buffer), this command enables the copying of large blocks of text from one part of a document to another. When combined with the O command (switch to OTHER document) and the "T" command (transfer text to screen from buffer), this command enables the copying of large blocks of text from one document to another. The format is as follows: Gn where "n" is an integer number of lines to "get" from 1 to 999999. See also G, O, T and "TRANSFER" KB (SET KEYBOARD TYPE) (COMMAND MODE) Set the keyboard type as defined in the file "\STEX\FUNCTION\KEYS.name" where "name" is a unique keyboard identifier. The format is as follows: KB name where "name" is the keyboard identifier. The default keyboard name is "PC". LCOL (LOCATE TEXT IN COLUMN) (COMMAND MODE) Locate all text lines containing the occurrence of "xxx" STARTING in the current cursor column. The format is as follows: (i) LCOL xxx where "xxx" is the text string to locate. (ii) LCOL xxx ; as above, however the delimiter ";" is used to include space characters in the locate. As each line is located it is displayed on the screen. At document end press the "" key to continue editing. See next screen for special use ! NOTE1: If "LCOL" only is entered then the last locate by column command will be displayed. This may then be re-executed "as is" or modified using the arrow and/or edit keys and then executed by pressing "". See also LOCATE TEXT (ALL occurrences). LINES (LINE NUMBER DISPLAY) (COMMAND MODE) Display the current screen with line numbers. The format is as follows: LI This command will display logical line numbers in the left hand margin. Lines longer than 72 characters will be truncated in the display. Press the key to quit this display and continue editing. LOAD FILE (COMMAND MODE) Load file and insert contents before the line containing the cursor. The format is as follows: LOAD pathname where "pathname" is the file name (or pathname) of the document to load and insert before the line containing the cursor. If the requested file does NOT exist then an error message will be displayed and NO text will be inserted. See also the "LOAD FROM" menu option. LOCATE TEXT (ALL occurrences) (COMMAND MODE) Locate all text lines containing at least the one occurrence of "xxx" as follows: (i) L xxx where "xxx" is the text string to locate. (ii) L xxx ; as above, however the delimiter ";" is used to include space characters in the locate. As each line is located it is displayed on the screen. At document end press the "" key to continue editing. See next screen for special use ! NOTE1: If "L" only is entered then the last locate (all occurrences) will be displayed. This may then be re-executed "as is" or modified using the arrow and/or edit keys and then executed by pressing "". See also LCOL (LOCATE TEXT IN COLUMN). LP (LEFT POINTER) (COMMAND MODE) Reposition the horizontal Left Pointer of the screen display. This command is useful for viewing printed reports where the page width is more than 80 characters. The format is as follows: LPn where "n" is an integer from 1 to 433 and represents the left margin of the document. See RP (RIGHT POINTER) for a discussion on setting the right margin of the document. ML (MACRO LOAD) (COMMAND MODE) Load a STEX macro file from disk. The macro file must have been created by the "MS" (Macro Save) COMMAND MODE command. The format is as follows: ML pathname where "pathname" is the file name (or pathname) of the STEX macro file to load. If the requested file does NOT exist then an error message will be displayed and NO macro file will be loaded. See also the "MS" (Macro Save) COMMAND MODE command. MR (MACRO REPEAT) (COMMAND MODE) Specifies the number of times to repeat a STEX macro. Normally a STEX macro is executed once only. The format is as follows: MRn where "n" is the number of times to repeat the STEX macro and may range from 1 to 999999. The macro will be repeated the specified number of times when it is executed. See next screen for special use ! If the MR command is used to set the macro repeat (MR) value to a large number (e.g. 999999) then the following commands will cause the macro to stop when the "find text" can no longer be found: - Find Forwards (CTRL/F) - Find Upwards (CTRL/U) - Find Forwards by column (FCOL - Command mode) - Find Upwards by column (UCOL - Command mode) NOTE1: If "MR" only is entered then the last macro repeat value will be displayed. This may then be re-executed "as is" or modified using the arrow and/or edit keys and then executed by pressing "". See also the MACRO EXECUTE command. MS (MACRO SAVE) (COMMAND MODE) Save a STEX macro file to disk. The STEX macro must have been created by the Execute Macro command. The format is as follows: MS pathname where "pathname" is the file name (or pathname) of the STEX macro file to save. If the requested file does exist then it will be overwritten. See also the "ML" (Macro Load) COMMAND MODE command. MLX (MACRO LOAD AND EXECUTE) (COMMAND MODE) Load and execute a STEX macro file from disk. The macro file must have been created by the "MS" (Macro Save) COMMAND MODE command. The format is as follows: MLX pathname where "pathname" is the file name (or pathname) of the STEX macro file to load and execute. If the requested file does NOT exist then an error message will be displayed and NO macro file will be loaded. See also the "MS" (Macro Save) COMMAND MODE command. N (NEXT LOGICAL LINE) (COMMAND MODE) Skip ahead "n" lines within the document. The format is as follows: Nn where "n" is an integer number of lines from 1 to 999999. To point to the last line in the document enter N999999 or any value greater than the number of lines remaining in the document. If lines are added or deleted within the document then this command will always reflect the LOGICAL line number as opposed to the physical record stored in memory. See next screen for special use ! NOTE1: If "N" only is entered then the last skip ahead command will be displayed. This may then be re-executed "as is" or modified using the arrow and edit keys and then executed by pressing "". N- (PREVIOUS LOGICAL LINE) (COMMAND MODE) Skip backwards "n" lines within the document. The format is as follows: N-n where "n" is an integer number of lines from 1 to 999999. To point to the first line in the document enter N-999999 or any value less than the current line number. If lines are added or deleted within the document then this command will always reflect the LOGICAL line number as opposed to the physical record stored in memory. See next screen for special use ! NOTE1: If "N-" only is entered then the last skip backwards command will be displayed. This may then be re-executed "as is" or modified using the arrow and edit keys and then executed by pressing "". POINT TO LOGICAL LINE NUMBER (COMMAND MODE) If the logical line number is known (eg. line number in program listing) then a jump to this line can be made directly (without having to read all the previous lines). The format is as follows: POn where "n" is an integer number of lines from 1 to 999999. To point to the last line in the document enter PO999999 or any value greater than the last line number. If lines are added or deleted within the document then this command will always reflect the LOGICAL line number as opposed to the physical record stored in memory. See next screen for special use ! NOTE1: If "PO" only is entered then the last point command will be displayed. This may then be re-executed "as is" or modified using the arrow and/or edit keys and then executed by pressing "". NOTE2: If "PO*" only is entered then the current point is calculated and displayed. The "PO" command mentioned above may then be given at a later stage to return to the same logical line number. R SHELL PROGRAM (COMMAND MODE) Resume (ie. execute) the SHELL program that is currently being edited. It is possible to run a SHELL program from within STEX by using this command. In fact if MERGE files are also in use then many SHELL programs may be developed at the same time. The format is as follows: R {optional_arguments} where "optional_arguments" are optional SHELL arguments that may be specified on the command line. RP (RIGHT POINTER) (COMMAND MODE) Reposition the horizontal Right Pointer of the screen display. This command is useful for viewing printed reports where the page width is more than 80 characters. The format is as follows: RPn where "n" is an integer from 80 to 512 and represents the right margin of the document. See LP (LEFT POINTER) for a discussion on setting the left margin of the document. TABS (COMMAND MODE) Displays the current logical TAB positions. By using the arrow keys the command line may be edited and the TAB stops changed to other values. See also the TAB CURSOR editing key and the TABSET command. TABSET (COMMAND MODE) Sets tab stops for use with the "TAB" key. The format is as follows: TABSET t1, t2, t3, t4, tn where t1, t2, t3, t4 to tn are column numbers from 1 to 80 in ascending sequence which are to be used as tab stops. NOTE: Commas are optional above. A maximum of 60 characters may be used in entering this command. See also the TAB CURSOR editing key and the TABS command (COMMAND MODE). TRANSFER TEXT LINE(S) (COMMAND MODE) This command causes line(s) from the "COPY" buffer to be inserted within the document. Prior to issuing this command at least one G or "GET TEXT" into buffer command must have been given otherwise the bell will sound. If there is text in the "COPY" buffer then the text will be inserted at this point. The format is as follows: Tn where "n" is an integer number of lines to "transfer" from 1 to 999999. See GET TEXT G for a discussion of the "COPY" buffer and also the O command. UCOL (FIND TEXT UP IN COLUMN) (COMMAND MODE) The document will be searched from the cursor backwards for the "find text" in the COLUMN where the cursor currently resides. The format is as follows: UCOL text; where "text" is the text string to search for starting at the current cursor position. The delimiter ";" is used if the find string ends in one or more blanks. eg. "UCOL this ;" will search for "this ". It is important to position the cursor at the correct position within the document as the search will begin from the current document row and only search each line at the current cursor column. NOTE1: If "UCOL" only is entered then the last find backwards by column command will be displayed. This may then be re-executed "as is" or modified using the arrow and/or edit keys and then executed by pressing "". See also F and U for searching backwards and upwards respectively. VERIFY (COMMAND MODE) Verify result of CHANGE command. See also BRIEF. WHERE YOU ARE WITHIN DOCUMENT (COMMAND MODE) This command displays the following information: (i) Edit mode Either Overlay or Insert (ii) LOAD/MERGE The LOAD or MERGE file number (iii) Text line Document LOGICAL line number (iv) Row Row in which the cursor lives (v) Col Col in which the cursor lives (vi) Path name Document name Press "" to continue editing after selecting this command. NOTE: "W" is useful when editing more than one document (see O to determine which document is currently being edited). WRAP (COMMAND MODE) This command switches between one of two modes. The format is as follows: (i) WRAP OFF. The screen will scroll to the left when the cursor is moved to the right most position of the screen. This is the default mode. (ii) WRAP ON. When the cursor is moved to the right most position of the screen the cursor will wrap around to the start of the next screen line. ! (COMMAND MODE) Execute a SHELL command of the form: command (document_name) arguments For example enter the following while in COMMAND MODE: !type where "type" is a valid shell command. The current document file is automatically inserted as the argument for this command. NOTE. Commands that are executed in this manner MUST take a pathname (or filename) as the FIRST argument. In this case the first argument is the STEX document name (S.document_name). The document name must NOT be used in this command as it is implied as shown above. Another example is as follows: !start /min notepad /P This command will spool the current document. The above command is expanded by STEX to produce the following: "!start /min notepad /P S.document_name" where "document_name" is the name of the STEX document being edited. See also SHELL. YANK BACK LINE(S) (COMMAND MODE) This powerful command provides the following: i) Allows accidentally deleted lines to be restored (ie. yanked back). ii) Allows successive lines to be deleted from one part of a document and inserted at another point. iii) Allows successive lines from one document to be deleted and then re-inserted into another document (see O). If this command is given without at least one LINE DELETE having been made previously then the bell will sound. The format is as follows: Yn where "n" is an integer number of lines to YANK BACK from 1 to 999999. See also Y. CURSOR CONTROL KEYS Keys for controlling the cursor are as follows: UP CURSOR K DOWN CURSOR V RIGHT CURSOR L LEFT CURSOR H HOME CURSOR ^ TAB CURSOR I ENTER KEY M :213 UP CURSOR K Moves the cursor vertically UP one line. If the cursor is on the top line of the screen the screen will scroll DOWNWARDS.  :226 DOWN CURSOR V Moves the cursor vertically DOWN one line. If the cursor is on the bottom line of the screen the screen will scroll UPWARDS. :214 RIGHT CURSOR L Moves the cursor horizontally one character to the RIGHT. If the cursor is on the right side of the screen AND there is more text to the right then the screen will scroll to the LEFT.  :210 LEFT CURSOR H Moves the cursor horizontally one character to the LEFT. If the cursor is on the left edge of the screen AND there is more text to the left then the screen will scroll to the RIGHT. Note that in INSERT mode the "" key acts similarly to the "CHAR DELETE" key except that when column one of the screen is reached the current line is deleted and appended to the line above (ie "join" line). This is effectively the reverse of the "" key in INSERT mode. In INSERT mode the key will NOT function on the first line of the screen. See also OVERLAY AND INSERT MODE.  :236 HOME CURSOR ^ HOME the cursor to the top left hand corner of the screen. If the cursor is already positioned at the HOME and the top screen line does NOT contain the starting text line of the document then the screen will be refreshed starting with the first line of the document. :211 TAB CURSOR Moves the cursor to the next TAB stop. Tab stops are initially defined as follows: 10, 20, 30, 40, 50, 60, 70, 80 If it is required to review or change the default values then see the TABSET and TABS commands (COMMAND MODE). ENTER KEY M Moves the cursor to the START of the next screen line (ie. column one). If the cursor is on the bottom line then a screen scroll up is performed. See also DOWN CURSOR V. In INSERT mode the "" key breaks a line at the cursor position. This erases all text from the cursor to the end of the line and inserts (adds) a new line below the current line which will contain the erased text. Note that in "INSERT" mode the "" key will NOT function on the last line of the screen. See also OVERLAY AND INSERT MODE. LINE EDITING KEYS While in COMMAND MODE, SHELL MODE or when entering a single line of text the following sequences are supported: E Erase line from flashing cursor G Get text line into copy buffer H Left cursor I Tab cursor L Right cursor M Enter key R Redisplay line S Character insert T Transfer text line from copy buffer X Enter literal character Z Toggle overlay/insert _ Character delete ^ Home cursor SCREEN EDITING KEYS The following keys provide full screen editing: CHAR INSERT S CHAR DELETE _ LINE INSERT A LINE DELETE D ERASE LINE E  CHAR INSERT S All characters to the RIGHT of the cursor are moved one position to the right. The character under the cursor is space filled. Characters moving off the right side of the screen are NOT lost, however the maximum line length cannot be exceeded (512 characters). The bell will sound if the line length exceeds this limit.  CHAR DELETE _ The character under the cursor is deleted. All characters to the right of the cursor are moved one position to the LEFT. Text that is off the right edge of the screen is moved into the right most column of the screen line.  :201 LINE INSERT A The screen line containing the cursor and those beneath are scrolled DOWNWARDS. A blank line is inserted at this point. If the cursor is on the bottom screen line then the bottom screen line will contain the inserted blank line. Inserting lines BEFORE the first line in the text file changes the start of the file to the newly inserted line. To add more than one line of blank text into the document see the ADD command. :204 LINE DELETE D The screen line containing the cursor is deleted. Lines beneath the deleted line scroll UPWARDS to fill the vacant spot left by the deleted line. If the first text line is deleted then the NEXT text line becomes the start of the document. If the last text line is deleted then the PREVIOUS text line becomes the last line in the document.  :205 ERASE LINE E Erase to end of line. The character under the cursor and those characters to the right of the cursor are changed to spaces (including any characters off the right edge of the screen).  :201 INSERT LINE A See LINE INSERT  :202 BACK WORD B Position the cursor to the end of the previous word. If there are no more text words on the screen then a screen scroll DOWN occurs and the cursor is positioned at the end of the first screen line.  :203 MODE COMMAND C See COMMAND MODE  :204 LINE DELETE D See LINE DELETE  :205 LINE ERASE E See LINE ERASE  :206 FIND TEXT F Finds FIRST occurrence of text within the document. After selecting this option the following prompt will appear: ENTER TEXT TO FIND: Enter the find text and press "". If the requested text string is found then the the line containing the text will be displayed on the 12th screen line from the top, and the rest of the document will appear above and below. If "" only is pressed then a search will be conducted for the LAST find text entered. If "" only is pressed then this command will be aborted and the document will be redisplayed. If the requested find string is NOT found then the document will be displayed from the position BEFORE this command was given. Note: Both lower and upper case occurrences of the find text will be searched for. See also FCOL (FIND TEXT IN COLUMN).  :207 GET TEXT G This command gets text into a "COPY" buffer. The line containing the cursor is "remembered" by storing it in "last in first out" order. In addition a screen scroll UP is performed. In conjunction with "T" (transfer to screen from buffer) this command enables the copying of large blocks of text from one part of a document to another. Combining this command with "O" (switch to OTHER document) and "T" (transfer to screen from buffer) provides the facility of copying large blocks of text from one document to another.  :210 LEFT CURSOR H See LEFT CURSOR :211 CURSOR TAB I See TAB CURSOR :213 UP CURSOR K See UP CURSOR :214 RIGHT CURSOR L See RIGHT CURSOR :215 ENTER KEY M See ENTER KEY  :216 NEXT WORD N Position the cursor at the start of the next text word. If there are no more text words on the screen then a screen scroll UP occurs and the cursor is positioned at the start of the last screen line.  :217 OTHER DOCUMENT O There are TWO commands to switch to the OTHER document. Use O to switch between the LOAD and current MERGE file, while the key bound to the STEX "o" function will switch to the other Merge file (if two Merge files exist in memory) or to the next Merge file if there are more than two Merge files in memory. These options are only available if option 5 has been selected from the main menu otherwise the bell is sounded (MERGE FROM DISK AND EDIT). Use of this command swaps ALL editing functions from one document to another and saves details for the current document. See next screen ! In particular the following details are stored for each document: Beginning of document line End of document line Number of lines in document Cursor row Cursor column Screen left pointer Screen right pointer  :220 FIND TEXT AGAIN P Repeat the Find Text Forward "F" or the Find Text Upwards "U" commands.  :221 SPELL WORD Q Spell word will highlight the next incorrectly spelled word. Pressing "n" will then display the STEX Spell Menu.  :222 REDISPLAY LINE R The line containing the cursor is redisplayed. If a text line is inadvertently changed by typing over it, using character insert/delete or erasing part/whole then the previous contents of the line may be restored by this command. However, if the screen is scrolled or any other editing command is given then using "R" will have NO effect.  :224 TRANSFER TEXT T This command causes a line from the "COPY" buffer to be inserted within the document. Prior to issuing this command at least one "G" command (get text into buffer) must have been given otherwise the bell will sound. If there is text in the "COPY" buffer then a screen scroll DOWN will occur from the cursor line downwards (similar to LINE INSERT) and the text will be inserted at this point. If a new line is to be inserted within the document then ensure that the cursor is displayed at the extreme left edge of the screen. If the cursor is within the body of the text then any existing text will be overwritten by this command. Note. If the cursor is on the BOTTOM line of the screen and to the right of column one then the bell will sound and any existing text will NOT be overwritten ! See "GET TEXT" and "G" for a discussion of the "COPY" buffer.  :225 FIND TEXT UPWARDS U Finds previous occurrence of text within the document. After selecting this option the following prompt will appear: ENTER UPWARDS FIND TEXT: Enter the find text and press "". If the requested text string is found then the the line containing the text will be displayed on the 12th screen line from the top, and the rest of the document will appear above and below. If "" only is pressed then a search will be conducted for the LAST upwards find text. If "" only is pressed then this command will be aborted and the document will be redisplayed. If the requested find string is NOT found then the document will be displayed from the position BEFORE this command was given. Note: Both lower and upper case occurrences of the find text will be searched for. See also FCOL (FIND TEXT IN COLUMN).  :226 DOWN CURSOR V See DOWN CURSOR  :227 COPY WORD W The word under the flashing cursor is copied into the Copy/Delete buffer stack. Many words may be put in this buffer and retrieved using the "w" function. See also "DELETE WORD" "d" function. See also "PASTE WORD" "w" function.  :230 LITERAL MODE X After depression of "X" the next keystroke will be entered literally into the text. For example depressing "X" followed by "G" will insert one character (octal 207) into the text under the cursor. Literal characters are represented in the body of the text by the character "@".  :231 YANK BACK LINE Y This powerful command provides the following: i) Allows accidentally deleted lines to be restored (ie. yanked back). ii) Allows successive lines to be deleted from one part of a document and inserted at another point. iii) Allows successive lines from one document to be deleted and then re-inserted into another document (see "O"). If this command is given without at least one LINE DELETE having been made previously then the bell will sound. A screen scroll DOWN will occur after a successful "Y" command as in LINE INSERT.  NEXT SCREEN \ The screen is cleared and the next 24 lines of the document are displayed from the last line of the current screen. A row of "^" characters signifies the start/end of the document. Paging down past this point will cause the screen to wrap around to the start of the document in a circular fashion.  PREVIOUS SCREEN ] The screen is cleared and the previous 24 lines of the document are displayed from the first line of the current screen. A row of "^" characters signifies the start/end of the document. Paging up past this point will cause the screen to wrap around to the end of the document in a circular fashion. See also: PREVIOUS MERGE FILE END (Bottom of Document) "b" function. Displays the bottom of the document. A line containing all "^" characters is displayed on the bottom line of the display screen. This signifies the end of the document. CASE CHANGE "c" function. Change (toggle) the case of the character under the cursor. If the character under the cursor is in lower case then pressing this key will convert it to upper case and vice versa. The cursor is moved one position to the right after converting the case of the character. If no case conversion takes place (ie. numeric or special character) then the cursor is still moved one place to the right. DELETE WORD "d" function. The word under the flashing cursor is deleted. Deletes the current word and copies the deleted word to the stack of Copy/Deleted words. Deleted words can be pasted into the document using the PASTE WORD command ( "w" function). See also "COPY WORD" "W". See also "PASTE WORD" "w" function. END LINE "e" function. Moves the cursor to the end of the line of text. GOTO MERGE FILE "g" function. If there is more than ONE MERGE file in memory then this command displays the prompt: ENTER MERGE FILE NAME: Either the full or partial name of the STEX Merge file that is ALREADY in memory may be entered. If the name entered is a valid document file name known to STEX then this file will be displayed and screen editing will continue with the new document displayed. ONLINE HELP "h" function. The ONLINE HELP mode is entered. You are using this feature now ! SCROLL UP "k" function. The whole screen will scroll upwards Text on the top screen line disappears while new text will appear on the bottom screen line. A row of "^" characters signifies the start/end of the document. Scrolling up past this point will cause the screen to wrap around to the end of the document in a circular fashion. Once the screen has been scrolled the text in memory will be updated with the text displayed on the screen. CURSOR LEFT (Move left) "m" function. Moves the cursor horizontally one character to the LEFT. If the cursor is on the left edge of the screen AND there is more text to the left then the screen will scroll to the RIGHT. SPELL MENU "Q" key followed by "n" function. Use the "Q" key to display the next incorrectly spelled word. Then press "n" to display the STEX Spelling menu as follows: +===========================+ |STEX Spell Menu |iGnore all| G Ignore all words |________________|__________| | |Ignore one| I Ignore one word |________________|__________| | | Word add | W Add to database | |__________| | |change All| A Change ALL words | |__________| | | Change | C Change ONE word | |__________| | |? new word| ? Enter new word | |__________| | |Next spell| N Next word or skip | |__________| | | Quit | Q Quit Spell Menu | |h to Hide | H Hide Spell Menu +===========================+ Note that all commands are single letters in either upper or lower case. When entering a wildcard character for a new word the following wildcard characters are supported: * --> Matches with 0 or more instances of any character or set of characters ? --> Matches with any one character For example the "?t?r*t?l" matches the spelling for "pterodactyl" PREVIOUS MERGE FILE "p" function. If there is more than ONE MERGE file in memory then this command will display the previous Merge file in memory and allow it to be edited. See also: MERGE FROM DISK AND EDIT OTHER DOCUMENT SCROLL RIGHT "r" function. The whole screen will scroll to the right. Text on the right edge of the screen disappears while new text will appear from the left edge of the screen. The bell will sound if the screen cannot be scrolled beyond its limit (512 characters). Scrolling right does not cause the text in memory to be updated with the text displayed on the screen. The screen must be scrolled vertically to update the text in memory (ie. use scroll up and/or down). SCROLL LEFT "s" function. The whole screen will scroll to the left. Text on the left edge of the screen disappears while new text will appear from the right edge of the screen. The bell will sound if the screen cannot be scrolled beyond its limit (512 characters). Scrolling left does not cause the text in memory to be updated with the text displayed on the screen. The screen must be scrolled vertically to update the text in memory (ie. use scroll up and/or down). BEGIN (Top of Document) "t" function. The screen is cleared and the first screen page of the document is displayed. BEGIN LINE "a" function. Moves the cursor to the beginning of the line of text. SCROLL DOWN "v" function. The whole screen will scroll downwards. Text on the bottom screen line disappears while new text will appear on the top screen line. A row of "^" characters signifies the end/start of the document. Scrolling down past this point will cause the screen to wrap around to the start of the document in a circular fashion. Once the screen has been scrolled the text in memory will be updated with the text displayed on the screen. PASTE WORD "w" function. Paste a word from the Copy/Delete buffer stack. The most recent word in the word stack is placed on the screen in last in, first out fashion. See also "COPY WORD" "W". See also "DELETE WORD" "d" function. MACRO STEX supports the use of Macros as follows: Collect a macro - see MACRO COLLECT Execute a macro - see MACRO EXECUTE Load a macro - see ML (MACRO LOAD) Load/execute - see MLX (MACRO LOAD AND EXECUTE) Repeat a macro - see MR (MACRO REPEAT) Save a macro - see MS (MACRO SAVE) Stop collecting - see MACRO STOP MACRO EXECUTE "x" function. Begin executing the STEX commands and text contained within the macro buffer. Use the Macro Collect command to collect a macro into the macro buffer and the Macro Stop command to stop collecting a macro. See also MR (MACRO REPEAT) MACRO COLLECT "y" function. Begin collecting a macro. All STEX commands and text are subsequently placed into a macro buffer. Use the Macro Stop command to stop collecting a macro and the Macro Execute command to begin executing the macro. MACRO STOP "z" function. Stop collecting a macro. Use the Macro Collect command to collect a macro into the macro buffer and the Macro Execute command to execute the macro.  :233 :233 MENU DISPLAY From Edit mode the sequence " " returns to the main menu selection. Currently the following menu options are supported: 1. Edit file 2. Load file 3. Clear all 4. Save file 5. Merge file 6. Process Command 7. Quit STEX 8. Help Please enter your selection: EDIT MENU OPTION 1 If there is at least one current file in memory then this option allows editing (add, change, delete or review) of that file. If no file currently exists then this option proceeds as for option 3 (Clear Text buffer and Edit). LOAD FILE MENU OPTION 2 This option LOADs from disk into memory a document file. This document file must be either a SAM or DAM file (ie Sequential Access Method or Direct Access Method file). If a document file has been LOADed previously then any subsequent LOAD will overwrite the document in memory. Note that the document file held on disk is never overwritten by a LOAD operation. If a document file has been MERGEd previously then a subsequent LOAD will NOT overwrite either the previously MERGEd document file in memory or on disk. When using the "W"here command the LOADed file will always correspond to LOAD File Number 0. After a successful LOAD the screen will fill with the LOADed document and the cursor will be placed at the home (top left) position ready for screen editing. To return to the menu type " " or press the "MENU" key. See also the "LOAD FILE" command. CLEAR ALL MENU OPTION 3 This option erases any document file already in memory (ie. both the LOADed and MERGEd files if they exist). The screen will then blank and the cursor will be placed at the home (top left) position. Full screen editing of a new document may then commence. To return to the menu type " " or press the "MENU" key. SAVE FILE MENU OPTION 4 This option allows the current document being edited to be saved to disk. If the "" key only is pressed for the prompt: "Please enter pathname of file to SAVE..." then STEX will first verify if the file exists on disk. If it does then the following prompt will be displayed: "File exists. Do you want to overwrite it (Y/N):" Enter "Y" to overwrite the file on disk or "N" to abort the save operation. Pathnames may be entered instead of simple filenames, however there is a limitation of 80 characters per name. MERGE FILE MENU OPTION 5 This option is similar to the LOAD option, however the significant difference is that the MERGEd file does NOT overwrite any LOADed file already in memory. Both the LOADed and MERGEd document files are in fact SEPARATE document files held in memory at the SAME TIME. By using the "O" editing command a user may flip from the LOADed document file to the MERGEd document file in memory and vice versa. See the following editing commands for a discussion of how useful MERGEd files can be: G GET TEXT INTO BUFFER O OTHER DOCUMENT FILE T TRANSFER TEXT FROM BUFFER Y YANK BANK DELETED LINE When using the "W"here command the MERGEd file will correspond to MERGE File Number 1 to 128. After a successful MERGE the screen will fill with the MERGEd document and the cursor will be placed at the home (top left) position ready for screen editing. To return to the menu type " " or press the "MENU" key. See also: DIR GOTO MERGE FILE OTHER DOCUMENT PREVIOUS MERGE FILE PROCESS COMMAND MENU OPTION 6 This option provides the facility to enter SHELL commands while still within a STEX edit session. If it is desired to continue an editing session from where one left off simply press the key sequence " 1". Note that any SHELL command may be given at the "STEX>" prompt. While in "pseudo SHELL" the STEX menu functions may be activated by pressing the "" key followed by the menu function number (eg. press "" and then "1" to continue editing). See also "!". QUIT STEX MENU OPTION 7 This option will terminate STEX. If modifications have been made to either the "load" file or any "merge" files AND these documents have not been saved then the following question will be asked: Do you want to save the above (YES/NO) If "YES" is entered then editing will continue thus allowing the file(s) to be saved. If "NO" is entered then the screen will be cleared and STEX will terminate. HELP MENU OPTION 8 You are using this facility now FUNCTION KEYS The filename "\STEX\FUNCTION\KEYS.PC" contains a list of all function keys and the commands with which they correspond. Users may tailor the use of function keys by editing this file using STEX. Refer to the "KB" command in COMMAND MODE for further details. The next screen display shows the special functions within STEX The following STEX functions must be bound to a key before they may be used: STEX FUNCTION INTERNAL STEX CODE BEGIN (Top of Document) t BEGIN LINE a CASE CHANGE c CURSOR LEFT (Move left) m DELETE WORD d END (Bottom of Document) b END LINE e FORMAT PARAGRAPH f GOTO MERGE FILE g MACRO COLLECT y MACRO EXECUTE x MACRO STOP z HELP h LOWERCASE WORD l OTHER MERGE FILE o PASTE WORD w PREVIOUS MERGE FILE p SCROLL DOWN v SCROLL LEFT s SCROLL RIGHT r SCROLL UP k SENTENCE BACK , SENTENCE NEXT . SENTENCE COPY / SENTENCE PASTE ; SENTENCE DELETE ' SPELL MENU n UPPERCASE WORD u WORD SAVE q OPTIONS The following command line options may be specified when invoking STEX: stex [pathname] [-c config_file] [-m merge_path] [-kb keyboard] [-help] [-preload] [-wrap] [-ml macro_path] [-mlx macro_path] where "pathname" is the name of a SAM or DAM file to LOAD, "-c" reads the configuration file in \STEX\CONFIG\config_file. "-m" is used to merge into memory a second document from disk named "merge_path" (ie. a MERGE file). "-kb" is used to set the keyboard type to "keyboard". The default keyboard type is "PC". "-help" displays the HELP screen, "-preload" allows either the LOADed and/or MERGEd file to be scanned for start text or skipped before it is brought into the program"s memory. "-wrap" wraps the cursor to the start of the next line instead of scrolling left, "-ml" loads a STEX macro named macro_path, "-mlx" loads a STEX macro named macro_path and executes it. SLOAD While in "pseudo SHELL" this command will load a new file into STEX. It is equivalent to option 2 in the STEX menu, however the format is as follows: SLOAD pathname where "pathname" is the name of the new file to load. SMERGE While in "pseudo SHELL" this command will merge a new file into STEX. It is equivalent to option 5 in the STEX menu, however the format is as follows: SMERGE pathname where "pathname" is the name of the new file to merge. SYNONYMS Words that you might use instead of the STEX command for a given function. BACKSPACE See LEFT CURSOR BOTTOM See END BYE See QUIT END See QUIT FILE LOAD See either: LOAD FILE - Load file and insert contents before the line containing the cursor LOAD FROM - Load from disk and edit (menu option) FINISH See QUIT INSERT See one of: CHAR INSERT Insert characters LINE INSERT Insert blank lines of text OVERLAY AND INSERT MODE Toggle (switch between) "OVERLAY" and "INSERT" mod mode JUMP See POINT - Point to logical line number KEY BINDINGS See FUNCTION KEYS KILL See ERASE LINE WRAP See WRAP MARGIN See either: LP - Left Pointer to screen display RP - Right Pointer to screen display MODIFY See CHANGE - Change text lines PROGRAM FUNCTION KEYS See FUNCTION KEYS QUIT See either: MENU - to quit editing and display menu EXIT - to quit from the menu  :377 RUBOUT See CHAR DELETE RUN See RESUME TOP See BEGIN DUMMY ENTRY MUST ALWAYS BE LAST