RBBS in a Box Volume 1 #2

home *** CD-ROM | disk | FTP | other *** search

/ RBBS in a Box Volume 1 #2 / RBBS_vol1_no2.iso / add2 / seddoc.zip / SEDTMAN.EDT < prev

Wrap

Text File | 1988-05-31 | 190KB | 6,342 lines

Copyright (c) Anker Berg-Sonne, 1985,1986,1987,1988 Sedt Version 3.3 Sedt Reference Manual Index 0 Introduction 0.0 Structure of This Manual 0.1 Terminology 1 Primer 1.0 Getting Started 1.1 Display 1.2 Moving the cursor 1.3 Inserting Text 1.4 Deleting Text 1.5 Saving your changes 1.6 Summary 1.7 Limitations 2 Advanced Guide 2.1 Introduction 2.2 Entering Sedt 2.2.1 -p<PID> 2.2.2 -l<Size> 2.2.3 -j 2.2.4 -e 2.2.5 -f 2.2.6 -b 2.2.7 -r 2.2.8 -pc 2.2.9 -xt 2.2.10 -at 2.2.11 -rb 2.2.12 -mo 2.2.13 -co 2.2.14 -<Line Number> 2.2.15 -k 2.2.16 -s<Size> 2.2.17 -ega 2.2.18 -v 2.2.19 -edt 2.2.20 -wps 2.2.21 -scn 2.2.22 -i<File Name> 2.2.23 -wi 2.3 Sedt's Data Files 2.3.1 Configuration File 2.3.1.1 BACKUPFILE 2.3.1.2 COLUMN 2.3.1.3 CONTEXT 2.3.1.4 CONTROLZ 2.3.1.5 CURSORLINE 2.3.1.6 EGA43 2.3.1.7 FIRMWARE 2.3.1.8 FONTSIZE 2.3.1.9 GOLD 2.3.1.10 JOURNALING 2.3.1.11 KEYBOARD 2.3.1.12 MAPPING 2.3.1.13 MAXSCROLL 2.3.1.14 MODE 2.3.1.15 MOUSE 2.3.1.16 NUMLOCK 2.3.1.17 PALETTE 2.3.2.17 REMEMBER 2.3.1.18 RETURN 2.3.1.19 RULER 2.3.1.20 SCREEN 2.3.1.21 SCREENSHIFT 2.3.1.22 SYSTEM 2.3.1.23 TAB 2.3.1.24 VIDEO 2.4 Initialization 2.5 Setting up the ruler 2.6 Options/Modes 2.7 Responding to Prompts 2.8 Repeating Commands 2.9 Cursor Movement 2.10 Text Insertion 2.11 Selecting Text Ranges 2.12 Deleting Text 2.13 Substitution 2.14 Windows and Buffers 2.15 Text Formatting 2.16 Programming Keys 2.17 Changing Options 2.18 Miscellaneous Commands 3 Using the MS-DOS version of Sedt 3.1 Support of the Microsoft mouse driver 4 Using the Microsoft Windows version of Sedt 4.1 Window Control 4.2 Mouse Control 4.3 Menu Control 4.3.1 File 4.3.1.1 New 4.3.1.2 Open.. 4.3.1.2 Save 4.3.1.3 Save as.. 4.3.1.4 Insert.. 4.3.1.5 Quit 4.3.2 Window 4.3.2.1 Untitled Unused <File name> 4.3.2.2 Switch 4.3.3 Edit 4.3.3.1 Clear 4.3.3.2 Cut 4.3.3.3 Paste 4.3.4 Ruler 4.3.4.1 Load <X> 4.3.5 Help 5 Using the ATARI GEM version of Sedt 5.1 Window Control 5.2 Mouse Control 5.3 Menu Control 5.3.1 Desk 5.3.1.1 About Sedt 5.3.2 File 5.3.2.1 Load.. 5.3.2.2 Save 5.3.2.3 Save as.. 5.3.2.4 Insert.. 5.3.2.5 Quit 5.3.3 Window 5.3.3.1 Open 0 5.3.3.2 Switch 5.3.3.3 Clear 5.3.4 Select 5.3.4.1 Clear 5.3.4.2 Cut 5.3.4.3 Paste 5.3.5 Ruler 5.3.5.1 Load <X> 5.3.6 Help 5.3.6.1 Show 6 Sedt hints and tricks 6.1 Using Sedt for programming 6.2 Using Sedt for text and documents 6.3 Repetitive tasks 7 Reference 7.1 Interpreting Keyboard Input 7.2 Translating Keystrokes 7.3 Command Syntax 7.4 Commands 7.4.1 Movement Commands 7.4.1.1 @AC Absolute Character 7.4.1.2 @AL Absolute Line 7.4.1.3 @BB Beginning of Buffer 7.4.1.4 @BM Match bracketing character 7.4.1.5 @EB End of Buffer 7.4.1.6 @EL End of Line 7.4.1.7 @C Character 7.4.1.8 @F Find 7.4.1.9 @L Line 7.4.1.10 @M Mark 7.4.1.11 @N Next 7.4.1.12 @PAG Page 7.4.1.13 @PAR Paragraph 7.4.1.14 @SCR Screen 7.4.1.15 @SEN Sentence 7.4.1.16 @SR Select Range 7.4.1.17 @V Vertical 7.4.1.18 @W Word 7.4.1.19 @XNM Next Mark 7.4.1.20 @XSR Select Region with no clear 7.4.2 Action Commands 7.4.2.1 :A Advance 7.4.2.2 :B Backward 7.4.2.3 :CB Cursor at Bottom 7.4.2.4 :CC Change Case 7.4.2.5 :CD Change to Lower case 7.4.2.6 :CE Change Case Edt Style 7.4.2.7 :CH Insert ASCII Character 7.4.2.8 :CL Center Line 7.4.2.9 :CM Cursor at Middle 7.4.2.10 :CNA Add number to counter 7.4.2.11 :CNG Get counter from buffer 7.4.2.12 :CNI Increment or decrement counter 7.4.2.13 :CNP Insert value of counter in buffer 7.4.2.14 :CNS Set counter value 7.4.2.15 :CS Save buffer context 7.4.2.16 :CT Cursor at Top 7.4.2.17 :CU Change to Upper Case 7.4.2.18 :D Delete 7.4.2.19 :EAP Delete and Append 7.4.2.20 :EK Execute key 7.4.2.21 :EL Set error level 7.4.2.22 :ERC Clear edit region 7.4.2.23 :ERS Set edit region 7.4.2.24 :FE Edit File 7.4.2.25 :FG Get File 7.4.2.26 :FNL Larger Font 7.4.2.27 :FNS Smaller Font 7.4.2.28 :FS Save File 7.4.2.29 :FW Write File 7.4.2.30 :FX Execute File 7.4.2.31 :GAP Get and append 7.4.2.32 :GE Get 7.4.2.33 :GR Get ruler 7.4.2.34 :H Help 7.4.2.35 :I Insert 7.4.2.36 :K Define key 7.4.2.37 :LD Decrease indentation 7.4.2.38 :LI Increase indentation 7.4.2.39 :LK Load key definition 7.4.2.40 :LNE Execute keystrokes stored in key 7.4.2.41 :LNL Store keystrokes in key 7.4.2.42 :LNX End learning 7.4.2.43 :LS Set indentation level 7.4.2.44 :M Mark cursor position 7.4.2.45 :NL New line 7.4.2.46 :NS Substitute next 7.4.2.47 :OE Output error message 7.4.2.48 :OL Open line 7.4.2.49 :OM Output message 7.4.2.50 :OS Toggle overstrike mode 7.4.2.51 :OW Switch to previous buffer 7.4.2.52 :PD Insert current date 7.4.2.53 :PL Load paste buffer 7.4.2.54 :PR Print current buffer 7.4.2.55 :PS Save paste buffer 7.4.2.56 :PT Insert current time 7.4.2.57 :Q Quit 7.4.2.58 :REP Replace 7.4.2.59 :RF Refresh display 7.4.2.60 :RK Refefine key as character 7.4.2.61 :RL Ruler 7.4.2.62 :RMCHA Clear character delete buffer 7.4.2.63 :RMHEL Clear help buffer 7.4.2.64 :RMLIN Clear line delete buffer 7.4.2.65 :RMPAG Clear page delete buffer 7.4.2.66 :RMPAR Clear paragraph delete buffer 7.4.2.67 :RMPAS Clear paste buffer 7.4.2.68 :RMSEA Clear search buffer 7.4.2.69 :RMSEN Clear sentence delete buffer 7.4.2.70 :RMSUB Clear substitute buffer 7.4.2.71 :RMUNK Clear unknown delete buffer 7.4.2.72 :RMWOR Clear word delete buffer 7.4.2.73 :RS Reset select range 7.4.2.74 :RTAB Replace tabs with spaces 7.4.2.75 :RUL Load ruler from entity 7.4.2.76 :RUS Save ruler in buffer 7.4.2.77 :SAVK Save key definitions in a file 7.4.2.78 :SC Show current column 7.4.2.79 :SEL Select 7.4.2.80 :SETB Set block/line mode toggle 7.4.2.81 :SETD Set direction toggle 7.4.2.82 :SETR Set replace/insert toggle 7.4.2.83 :SETT Set tab insert/expand toggle 7.4.2.84 :SK Save key definition 7.4.2.85 :SL Load search buffer 7.4.2.86 :STAB Replace multiple spaces with tabs 7.4.2.87 :STRP Strip trailing spaces 7.4.2.88 :SUB Substitute 7.4.2.89 :SV Show Version 7.4.2.90 :SYQ Spawn with no output 7.4.2.91 :SYR Spawn with redirected output 7.4.2.92 :SYS Spawn to operating system 7.4.2.93 :TAB Move to next tab stop 7.4.2.94 :TAD Adjust text by one tab stop 7.4.2.95 :TB Toggle Block Mode 7.4.2.96 :TC Toggle Control Character Display 7.4.2.97 :TD Toggle Direction 7.4.2.98 :TF Fill 7.4.2.99 :TI Test for input 7.4.2.100 :TM Toggle buffer markers 7.4.2.101 :TP Toggle Cursor Line 7.4.2.102 :TR Toggle ruler display 7.4.2.103 :TS Toggle automatic screen shifts 7.4.2.104 :TT Toggle tab expansion 7.4.2.105 :UC Undelete character 7.4.2.106 :UL Undelete line 7.4.2.107 :UM Undo last command 7.4.2.108 :UOFF Turn off screen updating 7.4.2.109 :UON Turn on screen updating 7.4.2.110 :UPAG Undelete page 7.4.2.111 :UPAR Undelete paragraph 7.4.2.112 :UPD Update screen header 7.4.2.113 :USEN Undelete sentence 7.4.2.114 :USR Paste 7.4.2.115 :UU Undelete unknown 7.4.2.116 :UW Undelete word 7.4.2.117 :WC Toggle windows 7.4.2.118 :WD Toggle width 7.4.2.119 :WI Select buffer 7.4.2.120 :X Exit 7.4.2.121 :YN Prompt for confirmation 7.4.2.122 :Z Zap buffer Appendix A Keyboard translation Appendix B Installation Appendix C Error Messages Copyright (c) Anker Berg-Sonne, 1985,1986,1987,1988 Sedt Version 3.3 Sedt Reference Manual 0.0 Structure of This Manual This manual is divided into three sections: The first a tutorial that introduces the user to the essential basics of editing using Sedt. The second an advanced guide that explains the more complicated functions, and the third a reference that systematically covers all aspects of the editor. The Tutorial and Advanced Guide are organized by function: Entering Sedt, inserting text, moving, etc.. The reference section is organized alphabetically for easy access. For the operating environments that differ significantly from the standard, command driven interface, the manual has sections that describes the differences. 0.1 Terminology Sedt is supported on a wide range of systems with a variety of keyboard layouts. When the manual instructs you to type a key it will use a generic name for the key, such as <Return>. Use the tables in Appendix A to locate where the key is located on your keyboard. The angle brackets are also used to show where an actual parameter needs to be inserted. E.g. when you see <line number> you should substitute a decimal number that denotes a line in your file. A construct surrounded by curly brackets {} is optional. If a construct is followed by three periods ... it can be repeated as many times as you wish. A keystroke sequence described as <Gold> <Key> is entered by typing the <Gold> key first, then releasing it and typing <Key>. A sequence described as <Control> <Key> is typed by holding down the <Control> key while <Key> is typed. The <Gold> key is the most important key to remember. It's location on the different keyboards that Sedt supports is: Keypad PF1 on Digital keyboards, Esc or Num Lock on old IBM PC keyboards or the new IBM PC keyboard, Esc on old IBM PC/AT keyboards and Keypad ( on ATARI ST keyboards. Copyright (c) Anker Berg-Sonne, 1985,1986,1987,1988 Sedt Version 3.3 Tutorial 1.0 Getting Started To start editing a file with Sedt you type the command "Sedt <file name>" at the operating system command prompt. The same command is used to create a new file and to edit an existing file. For example: SEDT FOO.BAR will create a new file named FOO.BAR, or modify the file if it already exists. 1.1 Display The Sedt screen display show a section, called a window, of the file you are editing. What you see is what will be written to the file. Editors of this type are called WYSIWYG (What You See Is What You Get) editors. Above and below the window is displayed information about the edit session and the settings of options. The first line on the display , the FILE line, gives you information about the file you currently are editing. In the first column you may see an asterisk (*). This shows that you have modified the file since it was loaded, or since last time it was saved by you. Next Sedt shows the name of the file being edited after the text "File: ". The name is exactly the same as the one you entered when you called Sedt. After the text "Column=" you will see the column within the text that the cursor is placed over. On some versions the column number is not shown for performance reasons. The text "Line=" is followed by the absolute line number within the text being edited that the cursor is placed on. The last field, after the text "Buffer=" shows which of several possible file buffers you are editing. Buffers allow you to edit several files at the same time. To begin with, Sedt will always display buffer number 0 containing the file you specified when you called Sedt. More information about buffers is given later in this manual. The second line of the display is the RULER. It shows how the text you are editing will be formatted. You can change the ruler a number of ways. The ruler shown when you enter Sedt is the DEFAULT RULER, which most often is the one supplied with Sedt. You, or your system manager may change the default ruler or any other ruler stored on disk. All lines from the third to the third from the bottom are a WINDOW into the file you are editing. In the window you will see a portion of the text you are editing. The location of the blinking cursor shows the position that editing operations will be performed at. The second line from the bottom is the MODE line and shows you the current state of several options within Sedt. All of these options are under your control. First, you will see either "Forward" or "Reverse". Several commands use the status of this mode and will move toward the beginning of the text when the mode is "Reverse" and toward the end of the text when the mode is "Forward". Secondly you will see either "Insert" or "Replace". In "Insert" mode, which Sedt starts the session in, all text insertion will push the character at the cursor to the right to make room for the new character. In "Replace" mode the text you type will over-write the text previously on the screen. The "Line" or "Block" display show how text cut and paste operations will be performed. More information about this mode is given in the section dealing with cut and paste. "Tabs:Expanded" or "Tabs:Inserted" shows whether Sedt attempts to save file space by inserting horizontal tab characters. Sedt assumes that the terminal and printer have tab stops set at 8 column intervals. In "Tabs:Expanded" mode, which is the state Sedt is in when started, it does not use horizontal tab characters. Several replace mode functions and cut and paste may return undesired results when "Tabs:Inserted" is used. It is recommended that you keep Sedt in "Tabs:Expanded" mode unless you are an experienced user of Sedt. "Screen Shift=" is followed by either a number or the text "Off". When "Screen Shift=" is followed by a number the screen window will be shifted horizontally to ensure that the cursor remains within the window. As the cursor advances beyond the right-most position on the screen, the window will be displaced right to move the cursor back within the screen. When the text "Off" is displayed the leftmost position of the window will correspond to the leftmost position of the text. The next field is blank unless keystrokes are being learned or replayed. When learning the field will display "Learning". When replaying it will display "Executing". The field "Mod=" is followed by the numbers of the editing buffers that contain unsaved changes. 1.2 Moving the cursor The simplest commands to move the cursor are the arrow keys. The <Right arrow> key will advance the cursor by one character in the text. As the cursor advances beyond the last character on a line it moves to the start of the next line. The <Left arrow> key moves a single character toward the start of the text. As the cursor moves past the start of a line it goes to the end of the previous line. The <Up arrow> key moves straight up. If the cursor moves from a position that is further to the right than the end of the previous line it will move to the end of it. Sedt remembers the column that a series of vertical arrow commands started at and will try to position the cursor at the original column. <Down arrow> moves the cursor straight down. Just as with <Up arrow> the cursor will not position itself further right than the end of a line of text and will try to position itself at the same column as it was at when a series of vertical arrow commands were started. The arrow keys are all that you need to move to any location in the text. On most systems you can hold the key down and have the command repeated at a high rate. Sedt can handle very high rates of command input and cannot be harmed by having commands repeated. 1.3 Inserting Text Inserting text is easy with Sedt. Simply place the cursor where you want the first character and type the text. If there are characters over or to the right of the cursor they will be pushed to the right as you type. To end a line of input and continue on the next line simply type a <Return>. You can enter an arbitrary ASCII character by typing <Gold>, then the decimal value of the character on the normal typewriter keyboard and then <Gold> and finally <Keypad 3>. 1.4 Deleting Text Text is easily deleted by moving the cursor to the right of the character you want to delete and typing the <Delete> key. If the cursor is at the far left of a line it will be moved to the end of the previous line. 1.5 Saving your changes When you have finished your changes you can save them and leave Sedt by typing two keys after one another: <Gold> and the F key. If you decide not to keep the changes you can type <Gold> and Q. If you have made any changes to the file you will be asked for confirmation before your changes are thrown away. Answer the affirmative if you are sure you do not need them. If, for some reason such as a power failure, you cannot complete an editing session, there is still hope. Sedt will at regular intervals save the keystrokes you have typed to a journal file. To recover from such a failure, call Sedt with the file name you were editing at the failure. When Sedt sees the journal file it will ask you to confirm before recovery. If your response is negative, the journal file is simply deleted. Sedt will "replay" the saved keystrokes to restore the session to a point close to where it was broken off. On all systems except the ATARI ST journaling is on by default. On the ATARI ST you must provide the -j qualifier to turn keystroke journaling on. NOTE Journaling is not supported on ATARI GEM and Microsoft Windows versions of Sedt because of the complex operating environment, which makes fail-safe journaling almost impossible. 1.6 Summary With the commands described in the tutorial you can make any change you need! Therein lies the beauty of Sedt. It is extremely easy to use, fast and reliable. The rest of the commands extend Sedt by allowing you to perform complex tasks with a few simple keystrokes. The Advanced Guide takes you through all these powerful features. 1.7 Limitations Sedt uses a combination of RAM memory and disk memory to store the information it is working on. This includes files being edited, current key definitions and text that has been deleted. If the total amount of information exceeds available memory Sedt will abort, but will leave the journal files if keystroke journaling has been active. You can then make more room available and restart the edit session using keystroke recovery. Sedt also has an internal limit which cannot be exceeded. If you crash because this limit has been exceeded and you have been editing several buffers, you may be able to recover by editing each file separately. The internal limits are 20MB for the VMS version and 1MB for all other versions. These are defaults which can be extended with the -s qualifier. Copyright (c) Anker Berg-Sonne, 1985,1986,1987,1988 Sedt Version 3.3 Advanced Guide 2.1 Introduction The Advanced Guide attempts to take you logically through the extremely rich command set of Sedt. Even though care has been taken not to mention features without describing them, you may find that you have to cross-reference different sections before you fully understand a feature. The Reference section may come in very useful for this purpose. 2.2 Entering Sedt The complete syntax for calling Sedt is SEDT {<Input File> {<Output file>}} {<Option>... } The input file will be loaded into buffer number 0, which is the editing buffer at start-up. If an output file is specified, buffer 0 will be saved into the specified file by default. Options change the behavior of Sedt for the complete editing session. A complete list of options follows: 2.2.1 -p<PID> Informs Sedt of the Process ID of the parent process. This option is only used on the VMS version of Sedt and creates a resident version of Sedt. On exit Sedt will attach to the parent process and remain resident. Upon reattachment Sedt will continue the editing session. 2.2.2 -l<Size> Limits the main memory buffering of information to <Size> bytes. This option is used to ensure that enough memory is left over to spawn sub-processes on MS-DOS systems. This option has no effect on other than MS-DOS implementations. 2.2.3 -j Suppresses journaling of keystrokes. Without journaling, Sedt cannot recover editing sessions that are interrupted by power failures or other catastrophic crashes. The -j option should only be used when absolutely necessary for performance reasons. On the ATARI ST -j turns journaling ON! 2.2.4 -e Terminate all files written with an ASCII SUB character. Some applications require a SUB character to recognize the end of data files. 2.2.5 -f Disables full screen editing. The cursor will always be placed in the middle of the window and text will move around it. In full screen mode the cursor will move around the window in a manner that minimizes screen updates. 2.2.6 -b Suppresses the renaming of old versions when files are saved. By default Sedt will rename any existing file to .BAK on the MS-DOS and ATARI versions before writing the new version. This allows you to recover from editing sessions where you have accidentally corrupted the file. On VMS there is no need for .BAK files since VMS supports multiple generations of files. Normally -b is used when disk space is too tight for both the new file and the backup. 2.2.7 -r When you supply the -r qualifier all files written to disk will have the last line terminated with an ASCII CR character. Use this when you are writing or editing a file for an application that requires this. 2.2.8 -pc Suppresses Sedt's automatic recognition of the system and makes Sedt assume that it is running on an IBM PC with the PC or XT keyboard. Use this when the recognition code fails to recognize the system properly. 2.2.9 -xt Suppresses Sedt's automatic recognition of the system and makes Sedt assume that it is running on an IBM XT with the PC or XT keyboard. Use this when the recognition code fails to recognize the system properly. 2.2.10 -at Suppresses Sedt's automatic recognition of the system and makes Sedt assume that it is running on an IBM AT with the AT keyboard. Use this when the recognition code fails to recognize the system properly. 2.2.11 -rb Suppresses Sedt's automatic recognition of the system and makes Sedt assume that it is running on a Digital Rainbow 100. Use this when the recognition code fails to recognize the system properly. 2.2.12 -mo Suppresses Sedt's automatic recognition of the system and makes Sedt assume that it is running on a monochrome system. Use this when the recognition code fails to recognize the system properly. 2.2.13 -co Suppresses Sedt's automatic recognition of the system and makes Sedt assume that it is running on a color system. Use this when the recognition code fails to recognize the system properly. 2.2.14 -<Line Number> After initialization Sedt will position the cursor at the start of the line number you provided. This function is most useful for programmers that need to go to a line number that the compiler has passed a syntax error message for. 2.2.15 -k Suppresses Sedt's automatic recognition of the keyboard type and informs Sedt that the system uses the new IBM keyboard. 2.2.16 -s<Size> Set the maximum amount of buffer space to <Size> megabytes. The buffer space is used to contain files being edited, delete and paste buffers plus key definitions. 2.2.17 -ega Switch the display into EGA 43 line mode during the session and switch back into 25 line mode at the end. 2.2.18 -v On IBM PCs and compatibles -v is used to instruct Sedt to access the video RAM directly. The result is a faster display than when the video firmware calls are used. It may, however, be incompatible with some video adaptors. 2.2.19 -edt Use the EDT layout with physical mapping to the LK250 keyboard. This switch is not applicable to VMS. 2.2.20 -wps Use the WPS layout with physical mapping to the LK250 keyboard. This switch is not applicable to VMS. 2.2.21 -scn Use scancode mapping of keyboard functions. This switch is not applicable to VMS. 2.2.22 -i<File Name> Read internal Sedt commands from the given file after initialization and before accepting keyboard input. Using the -i option prevents automatic execution of the default initialization file. 2.2.23 -wiXXYYHHWW Use the window defined by the upper left hand corner with coordinates XX,YY (0 based) and dimensions HH,WW. 2.3 Sedt's Data Files For Sedt to function properly it needs a number of data files. To help organize the files Sedt uses the concept of libraries where the operating system supports such a facility. The files used by Sedt are: An optional configuration file that sedt uses to set various options. The name of the configuration file is always SEDT.CNF. A key definition file that defines what function each key on the keyboard will perform. You can edit this file to change the programming of the keyboard. A Help file that can displayed during an editing session to assist the user in remembering the programming of the keyboard. A default ruler file that is used to set the ruler at initialization time. A set of optional ruler files that can be loaded or saved during an editing session. An optional command file that is executed during Sedt initialization for customization of the editing interface. On MS-DOS the library for all data files used by Sedt is defined by the environment variable SEDT. The contents of the environment variable has the name of the data file appended to it to locate the data file. If no environment variable is defined the files must be found in the default directory. To set up the environment use the DOS SET command. SET SEDT=C:\SEDT\ specifies that the files are found in the directory SEDT on drive C. The names of the files under MS-DOS depend on the configuration. This facilitates using SEDT from a shared server directory with different PC models. The configuration file is always named SEDT.CNF. The key definition file names are: System Keyboard File Rainbow LK201 RBKEY.TXT IBM PC IBM PCKEY.TXT IBM PC/XT IBM XTKEY.TXT IBM PC/AT IBM ATKEY.TXT IBM CONVERTIBLE IBM CVKEY.TXT PS/2 IBM NPKEY.TXT ANY IBM PC ENHANCED NPKEY.TXT ANY IBM PC LK250 LKKEY.TXT TANDY 1400 LT TANDY TXKEY.TXT VAX VT100 SEDT$VT100KEYS: VAX VT200 SEDT$VT200KEYS: ATARI ST STKEY.TXT The names of the help files are: System Keyboard File Rainbow LK201 RBHLP.TXT IBM PC IBM PCHLP.TXT IBM PC/XT IBM XTHLP.TXT IBM PC/AT IBM ATHLP.TXT IBM CONVERTIBLE IBM CVHLP.TXT PS/2 IBM NPHLP.TXT ANY IBM PC ENHANCED NPHLP.TXT ANY IBM PC LK250 LKHLP.TXT TANDY 1400 LT TANDY TXHLP.TXT VAX VT100 SEDT$VT100KEYS: VAX VT200 SEDT$VT200KEYS: ATARI ST STHLP.TXT The MS-DOS initalization file is named SEDTCOM.TXT and must be located in the directory pointed to by the environment variable SEDT. On VMS the ruler files are located in the directory pointed to by the logical name SEDT$DIR:. The key definition files are located by the logical names: System Keyboard File VAX VT100 SEDT$VT100KEYS: VAX VT200 SEDT$VT200KEYS: The help definition files are located by the logical names: System Keyboard File VAX VT100 SEDT$VT100HELP: VAX VT200 SEDT$VT200HELP: The initialization command file is located by the logical name SEDT$COMMANDS: On the ATARI ST under ATARI GEM all files must be in the current directory. On the ATARI ST under the Mark Williams C shell the library for all data files used by Sedt is defined by the environment variable SEDT. The contents of the environment variable has the name of the data file appended to it to locate the data file. If no environment variable is defined the files must be found in the default directory. To set up the environment use the SET command. SETENV SEDT=C:\SEDT\ specifies that the files are found in the directory SEDT on drive C. The names are: Key definition file: STKEY.TXT Help file: STHLP.TXT Initialization file: SEDTCOM.TXT The names of the ruler files are RULERn.TXT where n is a digit from 0 to 9. RULER0.TXT is the default ruler file. The initialization command file is named SEDTCOM.TXT. 2.3.1 Configuration File The configuration file, SEDT.CNF, is an ASCII data file containing one-line commands. Valid commands are: 2.3.1.1 BACKUPFILE=ON Causes Sedt to ensure that a backup version of all files are kept. BACKUPFILE=OFF Causes Sedt to not create backup versions of saved files. 2.3.1.2 COLUMN=DISPLAYED Enables continuous display of the current cursor column on the banner line. This is the default on all versions other than VMS and ULTRIX. Enabling this option on VMS and ULTRIX may have a significant impact on performance across a network. COLUMN=OFF Disables continuous display of the current cursor column on the banner line. This is the default on VMS and ULTRIX. 2.3.1.3 CONTEXT=SAVED Save the editing context when a file is saved. The context, containing the current position, all marks and the current ruler are saved in a file with the same file name and the extention .CTX. When Sedt edits a file, and this option is set, it will look for the file .CTX and restore the context. The result is that when a file is editied again the cursor and marks from the previous edit session will be restored. If you have two files in the same directory with identical filenames, they will default to the same .CTX file and the .CTX file may be overwritten by the .CTX file for the other file. To safeguard against loading the wrong file Sedt will veryfy that a file and it's corresponding .CTX file match. If a mismatch is found the message "Context file does not match input file" will be issued. CONTEXT=FORGOTTEN To not perform the actions described under CONTEXT=SAVED. CONTEXT=CHECK Do not save a context (.CTX) file automatically, but check for the presence of one when loading a file and use it of it is found. 2.3.1.4 CONTROLZ=ON Causes Sedt to terminate all files written with a control Z (EOT) character. CONTROLZ=OFF Causes Sedt to not terminate files written with a control Z (EOT) character. 2.3.1.5 CURSORLINE=FIXED Causes Sedt to keep the cursor on the middle line of the editing window. The benefit is ease of finding the current position and always being able to see several lines above and below the cursor. CURSORLINE=FLOATING Causes Sedt to float the cursor through the editing window. The benefit is fewer screen scrolls. 2.3.1.6 EGA43=ON Causes Sedt to switch the display into 43 line mode. Unpredictable results can be expected on other than EGA displays. EGA43=OFF Turns off 43 line mode. 2.3.1.7 FIRMWARE=NEWINT16 Use the INT16 extentions to support the enhanced keyboard. MS/DOS only. FIRMWARE=OLDINT16 Use the original INT16 call to read characters. MD/DOS only. 2.3.1.8 FONTSIZE=<number> Causes Sedt to default to a font that is close to <number> pixels high. 2.3.1.9 GOLD=<number> Causes Sedt to use function key <number> as the gold key. 2.3.1.10 JOURNALING=ON Causes Sedt to journal keystrokes. Keystroke journaling is not supported on ATARI GEM and Microsoft Windows versions. JOURNALING=OFF Causes Sedt not to journal keystrokes. Keystroke journaling is not supported on ATARI GEM and Microsoft Windows versions. 2.3.1.11 KEYBOARD=STANDARD Forces Sedt to assume that the system uses the standard keyboard. On IBM PCs and compatibles this means the old style keyboard. KEYBOARD=LK250 Forces Sedt to assume that the system has an LK250 keyboard attached. KEYBOARD=NEW Forces Sedt to assume that the system has the new style IBM keyboard attached. KEYBOARD=CONVERTIBLE Forces Sedt to assume that the system has an IBM keyboard convertible keyboard attached. 2.3.1.12 MAPPING=OLD Use .TXT extentions on key definition and help files and map the keys physically as close as possibly to the LK250 keyboard. MAPPING=EDT Use .EDT extentions on key definition and help files and map the keys physically as close as possibly to the LK250 keyboard. MAPPING=WPS Use .WPS extentions on key definition and help files and map the keys physically as close as possibly to the LK250 keyboard. MAPPING=SCANCODE Use .SCN extentions on key definition and help file and map keys by the scncodes sent by the firmware. 2.3.1.13 MAXSCROLL=<Number> Limits scrolling during cursor movement to <Number> lines. 2.3.1.14 MODE=<Hex Number> Use video mode <Hex Number> on PC compatible systems. 2.3.1.15 MOUSE=ENABLED Enabled use of the mouse from Sedt. Sedt will try to detect the presence of a mouse and enable the use of the mouse cursor. MOUSE=DISABLED Sedt will not use a mouse even if it is present. 2.3.1.16 NUMLOCK=ENABLED Enable the normal function of the Num Lock key on IBM PC keyboards. NUMLOCK=DISABLED Disable the normal function of the Num Lock key on IBM PC keyboards and allow it's use as a normal editing key. 2.3.1.17 PALETTE=<hex string> Causes Sedt to use the characters given in <hex string> as it's palette. Each pair of hex digits determines the attribute character as defined for the IBM Color Graphics Adapter. The position of the pair defines the use of the attribute character: (Sedt only uses the REVERSE and BOLD attributes). NORMAL BOLD BLINK BOLD BLINK UNDERLINE BOLD UNDERLINE BLINK UNDERLINE BOLD BLINK UNDERLINE REVERSE BOLD REVERSE BLINK REVERSE BOLD BLINK REVERSE UNDERLINE REVERSE BOLD UNDERLINE REVERSE BLINK UNDERLINE REVERSE BOLD BLINK UNDERLINE REVERSE 2.3.2.17 REMEMBER=ON Remenber the filename that Sedt last was called with and use this filename when Sedt is called without any file arguments. REMEMBER=OFF Do not load any file when Sedt is called without any file arguments. 2.3.1.18 RETURN=ON Causes Sedt to ensure that the last line of saved files is terminates with a CR/LF pair. RETURN=OFF Causes Sedt to not append a CR/LF pair to the last line of saved files. 2.3.1.19 RULER=ON The current ruler will be displayed at the top of the window. RULER=OFF No ruler will displayed unless Sedt is in ruler definition mode. 2.3.1.20 SCREEN=COLOR Forces Sedt to use color graphics firmware calls. SCREEN=MONO Forces Sedt to use monochrome firmware calls. 2.3.1.21 SCREENSHIFT=ON Enables horizontal shifting of the screen to keep the cursor position on-screen. SCREENSHIFT=OFF Disables horizontal shifting of the screen. 2.3.1.22 SYSTEM=IBMPC Forces Sedt to assume that it's running on an IBM PC or compatible. SYSTEM=IBMXT Forces Sedt to assume that it's running on an IBM PC/XT or compatible. SYSTEM=IBMAT Forces Sedt to assume that it's running on an IBM PC/AT or compatible. SYSTEM=VAXMATE Forces Sedt to assume that it's running on a Digital VAXmate. SYSTEM=PC100 Forces Sedt to assume that it's running on a Digital Rainbow 100. SYSTEM=IBMCONVERTIBLE Forces Sedt to assume that it's running on an IBM Convertible. SYSTEM=IBMAT-339 Forces Sedt to assume that it's running on an IBM PC AT model 339. SYSTEM=IBMXT-286 Forces Sedt to assume that it's running on an IBM PC XT model 286. SYSTEM=PS/2-50 Forces Sedt to assume that it's running on an IBM PS/2 model 50. SYSTEM=PS/2-60 Forces Sedt to assume that it's running on an IBM PS/2 model 60. SYSTEM=IBMXT-II Forces Sedt to assume that it's running on an IBM XT with new firmware. SYSTEM=PS/2-30 Forces Sedt to assume that it's running on an IBM PS/2 model 30. SYSTEM=PS/2-80 Forces Sedt to assume that it's running on an IBM PS/2 model 80. SYSTEM=TANDY1400 Forces Sedt to assume that it's running on a TANDY 1400 LT laptop computer. 2.3.1.23 TAB=EXPANDED Causes Sedt to use space characters to space to tab stops and indentation. TABS=INSERTED Cases Sedt to use space and tab characters to space to tab stops and insedtation. 2.3.1.24 VIDEO=BIOS Makes Sedt use BIOS calls for video control on IBM PCs and compatibles. VIDEO=DIRECT Makes Sedt access video RAM directly on IBM PCs and compatibles. 2.4 Initialization The initialization sequence for Sedt will go through the following steps: First the configuration file SEDT.CNF in Sedt's library is read and Sedt is configured as described in the file. Then a default ruler file is read from Sedt's library. The name of the default ruler file is RULER0.TXT. Next, the key definition file is read from Sedt's library. The name of the key definition file depends on the system that Sedt is run on: System Keyboard File Rainbow LK201 RBKEY.TXT IBM PC IBM PCKEY.TXT IBM PC/XT IBM XTKEY.TXT IBM PC/AT IBM ATKEY.TXT IBM CONVERTIBLE IBM CVKEY.TXT PS/2 IBM NPKEY.TXT ANY IBM PC ENHANCED NPKEY.TXT ANY IBM PC LK250 LKKEY.TXT TANDY 1400 LT TANDY TXKEY.TXT VAX VT100 SEDT$VT100KEYS: VAX VT200 SEDT$VT200KEYS: ATARI ST STKEY.TXT Next Sedt will position the cursor at the line number requested in the command line if a -<line number> qualifier was supplied. Then Sedt will look in Sedt's library for a file containing initialization commands for the editor. If a file is found it's contents will be interpreted as internal Sedt commands. The name of the file is system dependent: System File Rainbow SEDTCOM.TXT IBM PC SEDTCOM.TXT IBM PC/XT SEDTCOM.TXT IBM PC/AT SEDTCOM.TXT IBM CONVERTIBLE SEDTCOM.TXT PS/2 SEDTCOM.TXT VAX SEDT$COMMANDS: VAX SEDT$COMMANDS: ATARI ST SEDTCOM.TXT Finally, Sedt will look for a journal file in the same directory as the file you are editing and with the same name except for the extension .JOU. If one is found, Sedt will read the journal file as a sequence of keystrokes used to restore the editing session to the point at which it was broken off. 2.5 Setting up the ruler Sedt offers several options for formatting the text that you input. The current formatting options are displayed on the ruler line on the second line of the display. The initial contents of the ruler line are defined by a file in the standard directory for Sedt. When Sedt is called it reads the contents of the file RULER0.TXT and loads the contents into the ruler. You can change the ruler either by loading a ruler file or by changing it interactively. Most ruler changes are done by entering RULER MODE by typing <Gold> R, which takes the cursor up into the ruler line. When you have finished changing the ruler type <Return>, which will take you back to normal editing mode. The following commands are valid in ruler mode: <Right Arrow> Moves the cursor one column to the right. <Left Arrow> Moves the cursor one column to the left. <Gold> <Digit> Saves the current ruler in Sedt's standard directory in a file named RULER<Digit>.TXT. <Digit> Loads a saved ruler from Sedt's standard directory in a file named RULER<Digit>.TXT. <Control> H Moves the cursor to column one. <Tab> Moves the cursor to the next non-blank position on the ruler. <Return> Exits ruler mode. <Space> Clears any ruler controls at the current cursor position. L Sets the left margin at the current cursor position. When a <Return> is entered the cursor will be indented to the left margin. W Sets the word wrap at the current cursor position. When input is typed to the right of the right margin or the justification column, the input will be wrapped and indented to the word wrap column or automatic margin column. R Sets the right margin at the current cursor position. If any input is typed to the right of the right margin the text will be wrapped and indented to the word wrap column or automatic margin column. J Sets the justification column at the current cursor position. If any input is typed to the right of the justification column, the text will be justified by having the spacing between words on the line modified until a straight right margin at the justification column is achieved. Any text that cannot fit on the current line is wrapped to the next line and indented to the word wrap column or the automatic margin column. I Sets the indentation level at the current cursor position. If a <Tab> is entered to the left of the indentation column, the cursor will be advanced to the indentation column. T Sets a tab stop at the current cursor position. Tab stops can only be set up to column 232, they are fixed at 8 character intervals beyond that. If a <Tab> is entered to the left of a tab stop the cursor will be advanced to the tab stop. A Sets the automatic margin at the current cursor position. When text is wrapped by typing to the right of the right margin or justification column, or a <Return> is typed and the automatic margin is active, the cursor will be advanced to the same column as the leftmost printable character on the line the cursor was on before the character was typed. The automatic margin will also be moved to this position. This feature is most useful for structured programming. - Clears tab stops at the current cursor position. Some of the tab controls are mutually exclusive and setting one of these will automatically cancel those options that it excludes. The following options are mutually exclusive: A and W R and J If several option are set at the same column the ruler will only display one of them. To cancel an option other than T, place the cursor on column 1 and type the option. The only exception to this rule is A. This can only be cancelled by typing R in any position. Saved rulers allow you to set up to 10 different ruler settings according to your preference. You can change the ruler that Sedt loads after start-up by saving the setting you desire in ruler number 0. Example rulers: A T T T T ... This ruler is most convenient for structured programming. Every time a return is entered Sedt will indent to the left margin of the line just terminated. W L T T R ... Every time a return is entered the cursor will be indented to the position of the L on the ruler line. When text is typed to the right of R the line will be wrapped to the left margin. I L W T J ... This ruler will cause text to be filled between W and J. When a return is entered the cursor will be indented to the L. 2.6 Options/Modes The bottom line of the display shows the state of several options that affect how Sedt commands work. Each of these has a default state. Forward/Reverse (default:Forward) Most cursor commands move in the direction shown by the direction state. To change the direction state type <Keypad 4> or <Keypad 5>. Insert/Overstrike (default:Insert) When text is inserted in insert mode it pushes any characters at or to the right of the cursor to the right to make room for the text being inserted. In replace mode text originally at the cursor position is overwritten. To change the state between insert and overstrike modes type <Gold> O. Line/Block (Default:Line) This state only has effect when cutting or pasting text. In line mode a cut will remove all text between the select point and the cursor position, and a paste will insert the contents of the paste buffer at the cursor position. In block mode a cut will remove the rectangle of text defined by the select point and the cursor position and a paste will push all text from the cursor column to the right to make room for the contents of the paste buffer. To change between line and block mode type <Gold> L. Tabs:Expanded/Tabs:Inserted (Default:Tabs:Expanded) When tabs are expanded Sedt will always use ASCII Space characters to indent text. When tabs are inserted Sedt will use ASCII HT and Space characters. It is recommended that the state be left as tabs expanded. To change the tab mode type <Gold> I. Screen Shift=<Number>/Screen Shift=Off (Default:Screen Shift=0) If screen shift is off the leftmost character position on the screen will always correspond to the first column of the text file. If screen shift shows a number, Sedt will keep the cursor within the visible screen by shifting the screen horizontally through the file. The number shown is the number of columns hidden to the left of the screen. This process is totally automatic. To change the screen shift mode type <Gold> A. Learning/Executing The Learning mode indicator shows that Sedt is storing all keyboard input for later reexecution. <Gold> F17> will store learned keystrokes into ^Z. Terminate learning by typing ^Z. The stored keystrokes are executed by typing ^Z again. <Gold> <F18> will prompt for a key to store keystrokes in and then store subsequent keystrokes until the same key is typed. To execute the stored keystrokes type the key you stored them in. The Executing mode indicator shows that Sedt is reexecuting a stored sequence of keystrokes. Execute mode is entered by typing <Gold> <F18> 2.7 Responding to Prompts Some commands, such as the search command, require arguments. Such commands will write a prompt on the bottom line of the screen and wait for you to enter a response. You can enter the following when responding to a prompt: Any key on the typewriter keyboard will be entered into the prompt string at the cursor position. <Control> U Will abort the command. <Return> <Keypad Enter> <Do> Completes the response to the prompt. <Delete> <Backspace> Deletes the character behind the cursor. <Gold> <Return> Inserts a CR/LF pair in the prompt buffer. <Left Arrow> Moves the cursor one character left. <Right Arrow> Moves the cursor one character right. <Up Arrow> If typed before any other character will recall the previous response to a prompt. Successive <Up Arrow>s will move throught the last 10 responses. <Down Arrow> If <Up Arrow> has recalled previous responses, <Down Arrow> will move forward towards the last response. Other control characters will be inserted at the cursor position. Function keys will insert the programming of the keys at the cursor. 2.8 Repeating Commands Most commands can be repeated by typing first <Gold> and then the number of times you want the command repeated on the normal typewriter keyboard before typing the command. A few commands do not accept such a repeat count, either because it makes no sense, or because the number is used for other purposes. As you type the number it will be shown on the message line of the display. If you happen to mistype the number you can delete it digit by digit with the <Delete> key. 2.9 Cursor Movement Cursor movement commands come in two flavors. Some take the direction of movement from the direction flag, which is displayed in the first field of the mode line, whereas others always move in a fixed direction. The direction determined by the direction flag is called the DEFAULT DIRECTION. The direction flag is controlled with the following commands: <Gold> + <Gold> > <Keypad 4> Set the direction flag to forward: toward the end of the text in the buffer. <Keypad 4> changes the direction permanently. <Gold> + and <Gold> > only changes it for the next command. <Gold> - <Gold> < <Keypad 5> Set the direction flag to reverse: toward the beginning of the text in the buffer. <Keypad 5> changes the direction permanently. <Gold> - and <Gold> < only changes it for the next command. Most movement commands can be repeated by typing <Gold> and then typing the number of times you want the command repeated immediately before you type the command. The number must be typed on the normal typewriter keyboard. Commands that move the cursor are: <Gold> . Moves the cursor to a previously set mark. There are 9 different marks that you can set. To move to mark number 1 type <Gold> . . To move to any of the other marks type <Gold> followed by the number of the mark (1 to 9) on the normal typewriter keyboard and then <Gold> . . Marks are useful for jumping back and forth between different points in the buffer. <Gold> B <Gold> <Keypad 4> Moves the cursor to the position just after the last character of text in the buffer. <Gold> M Sets a mark at the current position of the cursor. To set mark number 1 type <Gold> M. To set other marks (1 to 9) type <Gold> followed by the number of the mark on the normal typewriter keyboard and then <Gold> M. <Gold> T <Gold> <Keypad 5> Moves the cursor to the first character in the buffer. <Gold> U If you type <Gold> U as the first input after a movement command the cursor will be moved back to the position it was at before the move. This command is very useful to undo undesired moves. Several commands that delete text can also be undone with <Gold> U. If the last command cannot be undone you will receive an error message. <Control> H Will move the cursor to the beginning of a line. If the cursor already is at the beginning of a line it will be moved to the beginning of the previous line. <Find> <PF3> Will search in the default direction for the string given in the last <Gold> <Find> or <Gold> <Keypad 9> command. The <Find> command is insensitive to the case of the string. <Prev Screen> Moves up by one fewer lines than there are in the window. The cursor is positioned at the start of the line. <Next Screen> Moves down by one fewer lines than there are in the window. The cursor is positioned at the start of the line. <Up Arrow> Moves one line up and tries to keep the cursor at the same column as it was at before a sequence of up and down arrow moves. <Left Arrow> Moves one character backward. <Down Arrow> Moves one line down and tries to keep the cursor at the same column as it was at before a sequence of up and down arrow moves. <Right Arrow> Moves one character forward. <Keypad 0> Moves in the default direction to the next beginning of line. <Keypad 1> Moves in the default direction to the next beginning of a word. Spaces before a word are skipped. A word is either a single non-alphanumeric character or a word composed of alphanumeric characters. <Keypad 2> Moves in the default direction to the next end of line. If the cursor already is at the end of a line it will move to the end of the next line. <Keypad 3> Moves one character in the default direction. <Keypad 7> Moves in the default direction to the next start of page. The start of page is determined by an ASCII FF character (Which is inserted with <Gold> P). If there are no more ASCII FF characters the cursor will be moved to the end of the buffer. <Keypad 8> Moves in the default direction to the next start of a paragraph. Paragraphs are delimited by a minimum of one empty line. The cursor is placed over the first non-blank character in the paragraph. <Gold> <F19> Moves to bracketing character that matches the one under the cursor. Matching characters are ', ", <, >, [, ], {, }, (, and ). ' and " are searched for in the current direction, all other characters are serched for in the direction that the character implies. If the cursor is not placed over one of the above characters an error message will be displayed. <Gold Find> <Gold> <PF3> Prompts for a string on the bottom line of the display and then searches in the default direction for an occurrence of the string. The search is independent of the case of any alphabetic characters in the string. If an empty response is given to the prompt the string entered in response to the last <Gold> <Find> or <Gold> <Keypad 9> will be used. <Gold> <Left Arrow> Moves continuously backward through the buffer until the beginning of the buffer is reached or a command is typed. <Gold> <Right Arrow> Moves continuously forward through the buffer until the end of buffer is reached or a command is typed. 2.10 Text Insertion All insertion happens at the the cursor position. To insert at a different position from the one you see the cursor flashing at you have to move the cursor there first. See the section on cursor movement for directions on how to move around. The regular typewriter keys will cause the character on the key to be inserted in the file you are editing. If your keyboard has been programmed for a national character set Sedt will use that programming. A number of other keys will also cause text insertion: <Tab> The cursor will be advanced to the next tab stop on the ruler by inserting spaces or ASCII HT characters. If the mode is set to Tabs:Expanded only space characters will be inserted. Otherwise a mixture of HT and space characters will be used. If an indentation point has been set and the cursor is to the left of it it will space over intermediate tab stops to the indentation point. <Return> A new line will be started at the cursor position and the cursor will be advanced according to the following rules: If an A is shown on the ruler line the cursor will be advanced to the column of the first printable character on the line just terminated. If an L is shown on the ruler line the cursor will be advanced to the column shown by the L. The cursor is advanced by inserting space and ASCII HT characters. If the mode is set to Tabs:Expanded only space characters will be inserted. <Escape> <F11> Inserts an ASCII ESC character. <Gold> <Control> I Prompts for a key and will insert the definition of the key into the file at the current cursor position. The key can be a function key, control character, gold function key, gold control key or gold character from the typewriter keyboard. <Gold> G Prompts for a file name and includes the contents of the file at the cursor position. <Gold> P Inserts an ASCII FF character, which starts a new page. <Insert Here> <Gold> <Keypad 6> Inserts the contents of the paste buffer at the current cursor position. <Gold> <Keypad 0> Inserts a new line at the cursor position and does not advance the cursor. <Gold> <Keypad 3> Allows insertion of an arbitrary ASCII character. Type <Gold> followed by the decimal value of the character (typed on the regular typewriter keyboard) followed by <Gold> <Keypad 3>. You cannot enter a newline character (ASCII LF) using this method. <Gold> <Keypad ,> Inserts the last deleted character at the cursor position. <Gold> <Keypad -> Inserts the last deleted word at the cursor position. <Gold> <PF4> Inserts the last deleted line at the cursor position. 2.11 Selecting Text Ranges Several commands operate with a selected region. The following commands are used to select an arbitrary region of text. Whenever a region of text is selected it will be displayed in reverse video on the screen. <Select> <Keypad .> Anchors the cursor position as one end of a selected region. When the cursor is moved in front of the select point the select region will be all characters from the select point up to the character behind the cursor. When the cursor is moved behind the select point the region will be all characters from the cursor up to the character behind the select point. <Gold> <Select> <Gold> <Keypad .> Cancels the select region. 2.12 Deleting Text <Linefeed> <Control> J <F13> Deletes from the character behind the cursor position back to the previous start of a word. The deleted text can be retrieved with the <Gold> <Keypad -> command. <Control> U Deletes from the character behind the cursor position back to the beginning of the line. The deleted text can be retrieved with the <Gold> <PF4> command. <Delete> <Backspace> Deletes the character behind the cursor position. The deleted character can be retrieved with the <Gold> <Keypad ,> command. <Gold> Z Clears the contents of the buffer. The previous contents cannot be retrieved. <F4> Appends the contents of the selected text range to the paste buffer. The selected text range is not deleted from the buffer. <Remove> <Keypad 6> Removes the selected text range from the buffer and inserts it in the paste buffer. <Keypad ,> Deletes the character at the cursor position. The character can be retrieved with the <Gold> <Keypad ,> command. <Keypad -> Deletes from the cursor position up the the next start of a word. The deleted text can be retrieved with the <Gold> <Keypad -> command. <PF4> Deletes from the cursor position through the line end. The deleted text can be retrieved with the <Gold> <PF4> command. <Gold> <Remove> Copies from the selected text range into the paste buffer without deleting from the buffer. <Gold> <Keypad 2> Deletes from the cursor position up to the end of the line. The deleted text can be retrieved with the <Gold> <PF4> command. 2.13 Substitution <Keypad 9> Searches in the current direction for an occurrence of the last search string given and, if the string is found, replaces it with the last replace string given. The Search string is set with the <Gold> <PF3> or <Gold> <Keypad 9> commands. The replace string is set with the <Gold> <Keypad 9> command. <Gold> <Keypad 9> Prompts for a search and a replace string and then searches in the current direction for an occurrence of the search string and , if it is found, replaces it with the replace string. If an empty response is given to any of the prompts the previous value of the string will be used. 2.14 Windows and Buffers Sedt allows you to edit up to 4 different files at the same time. At any given moment you can choose between having one or two of these displayed on the screen. The following commands allow you to switch between the four files and change the way they are displayed. Each of the 4 files you can edit are held in a buffer. The current buffer, which all commands operate on, is the one you see on the screen when a single window is displayed, or the one shown in the top window when two are displayed. <Gold> <Up Arrow> Scrolls the display so that the line with the cursor is on the second line of the display. This command has no effect if the operation would place the first line of the file below the first line of the display. <Gold> <Down Arrow> Scrolls the display so that the line with the cursor is on the second last of the display. This command has no effect if the operation would place the first line of the file below the first line of the display. <Gold> D Toggles between displaying one or two files on the screen. When two files are displayed the screen will be split horizontally with the two files shown one above the other. <Gold> E Prompts for a file name to be loaded into the current buffer. The original contents of the buffer are discarded. You will, however, be given a chance to save the original contents of the buffer if it has been modified. <Gold> F <F10> Saves the contents of the current buffer. All other than ATARI GEM and Microsoft Windows versions will terminate the edit session if no unmodified buffers exist, or ask whether you intend to terminate if there are unsaved changes. <Gold> Q <F8> Terminates execution of Sedt without saving any buffers. You will be asked to confirm that you really intend to quit if any buffers have been modified. On ATARI GEM and Microsoft Windows versions only the current window will be closed and Sedt will terminate when the last window is closed. Advanced Guide <Gold> S Prompts for a file name and then saves the buffer into the file. The file name associated with the buffer will be changed to the new file. <Gold> X Switches to the previously selected buffer. If no other buffer has been selected it will switch to buffer 1. <F6> Saves the contents of the current buffer into the file associated with it. The save is not done if no modifications have been made. <F17> Selects buffer number 0. <F18> Selects buffer number 1. <F19> Selects buffer number 2. <F20> Selects buffer number 3. 2.15 Text Formatting <Control> A Sets the indentation level to the column number that the cursor is at. Typing <Tab> when the cursor is to the left of the indentation level will insert space characters to bring the cursor up to the indentation level. <Control> D Decreases the indentation level by one column. <Control> E Increases the indentation level by one column. <Control> T Adjusts all text within the select range by one tab stop. <Control> T will move the select range right if the direction flag is forward and left if the direction flag is reverse. <Gold> - <Control> T will always move a tab stop left. <Gold> + <Control> T will always move a tab stop right. <Gold> C Centers the line containing the cursor between the left (L on the ruler line) and right (R or J on the ruler line) margins. <Gold> J Reformats from the previous beginning of line to the end of the current paragraph. Reformatting requires that a right margin has been set on the ruler line. An R will set a ragged right margin and a J will set a justified right margin. <Gold> _ Inserts a hyphen and a space at the cursor position and reformats from the previous beginning of line to the end of the current paragraph. This command allows you the break a word if the automatic reformatting looks bad. <Gold> <Keypad 8> Reformats from the cursor position to the end of the current paragraph. 2.16 Programming Keys The effect of a keyboard command is not fixed in Sedt. You can change the functions of most keys in a variety of ways. Permanently by editing the keyboard definition file or temporarily during a session with commands that change the keyboard programming. <Control> K Prompts for you to type the key you want to program and for a command string that you want to program the key with. Valid commands that you can program the key with are documented in the reference section of this manual. <Gold> <Control> I Prompts for you to type a keystroke and then inserts the programming of the key into the current buffer at the cursor position. <Gold> <Control> L Prompts for you to type the key that you want to program and then loads the contents of the current buffer into the key. Valid commands that you can program the key with are documented in the reference section of this manual. <Gold> <F17> Causes learning of keystrokes into ^Z until learning is completed by typing <Control> Z. The keystrokes learned can be "replayed" by typing ^Z. <Gold> <F18> Prompts for a keystroke and then stores sunsequent keystokes into that key until it is typed again. To "replay" the keystrokes type the key at any time after learning was terminated. 2.17 Changing Options Sedt supports a variety of toggles and options that change the behavior of the editor. Many can be set for a session by providing command switches when you call Sedt or they can be modified dynamically during the editing session. <Gold> A Toggles automatic screen shifting. When automatic screen shifting is on the screen will scroll horizontally to ensure that the cursor is always visible within the margins on your screen. The mode indicator "Screen Shift=" indicates how many characters to the right that the screen is shifted. When screen shifting is off the leftmost character on the screen always corresponds to the leftmost character on each line in the file. <Gold> I Toggles expansion of tabs. Then tabs are expanded only space characters will be used when indenting text in moving to a tab stop on the ruler. When tabs are inserted Sedt will attempt to use ASCII HT characters for these operations, thus saving file space. The latter condition may lead to undesired effects when you delete and insert text containing ASCII HT characters. The state of the tab insertion mode is shown by the "Tabs:" mode indicator. <Gold> L Toggles block cut and paste. When block cut and paste is in effect a cut operation (<Remove> or <Keypad 6>) will remove a rectangle of text bounded by the select point and the cursor position. In line mode a cut operation will remove all text in the select region. When block cut and paste is in effect the word "Block" will appear on the mode line and only a reverse video column will show the select region. When line cut and paste is in effect "Line" will be shown on the mode line and the entire select region will be shown in reverse video. <Gold> O Toggles overstrike/insert mode. In insert mode typed text, inserted text and undeleted text will be inserted at the cursor position and any existing text will be pushed to the right of the inserted text. The delete operation will remove the text and collapse text around the region that was deleted. "Insert" will also be displayed on the mode line. In replace mode typed, inserted and undeleted text will overwrite existing text in the buffer. Delete operations will cause the deleted text to be replaced by blank space. "Replace" will also be shown on the mode line. This mode is useful for editing tabular types of text. <Gold> W Toggles between 80 and 132 character displays. This is only supported on systems and displays that can toggle between these modes. 2.18 Miscellaneous Commands <Control> P Prompts for a file name and writes the contents of the current buffer onto the file with page breaks at every 60 lines. <Control> W Refreshes the entire display. <Gold> <Return> <Do> Prompts for an operating system command and then executes it in a subprocess. If no command is entered the command parser will be executed. This command is not supported on all operating systems. <Gold> H <Help> <PF2> Displays a series of help screens on the terminal. <Gold> R Enters ruler definition mode. See the chapter on modifying the ruler for an explanation. <F7> <F9> <Keypad Enter> <Gold> <Resume> Dead key. This is useful for terminating a continuously scrolling operation started by <Gold> <Right Arrow> or <Gold> <Left Arrow>. <Gold> <F4> Prompts for a file and loads the contents of the file into the paste buffer. <Gold> <Do> <Gold> <Keypad 7> Prompts for a sequence of internal Sedt commands and then executes them. A description of internal Sedt commands is contained in the reference section of this manual. <Gold> <Keypad 1> Changes the case of alphabetic characters in a range of text given by the following rule: The select region if one is active, otherwise if the last command was a search operation the string that was found, otherwise the character at the cursor position. <Gold> <Keypad Enter> Swaps the character at the cursor position and the following character and advances the cursor by one character. Copyright (c) Anker Berg-Sonne, 1985,1986,1987,1988 Sedt Version 3.3 3 Using the MS-DOS version of Sedt The MS-DOS version of Sedt follows the generic description given in the previous two chapters, but adds support for a mouse if a Microsoft mouse compatible driver is installed. 3.1 Support of the Microsoft mouse driver If Sedt recognizes the presense of a mouse it will display a block cursor within the window. The cursor will move around the window if you move the mouse. NOTE: Mouse movement and clicking is not recorded in the journal file. If you do crash and try to recover from a session where the mouse was used, you will probably get unpredictable results. Clicking the left mouse button will move the text cursor to the position you clicked at. Any active select region is cancelled. If the mouse is dragged with the left mouse button held down the cursor will move with the mouse and the region between the point where the cursor was originally pressed and the current cursor will be selected. Clicking the right mouse button will select the text between the mouse cursor and the text cursor. Copyright (c) Anker Berg-Sonne, 1985,1986,1987,1988 Sedt Version 3.3 4 Using the Microsoft Windows version of Sedt WSEDT.EXE is special version of Sedt running as a class A application under Microsoft Windows. In addition to the functionality described elsewhere in this manual it offers mouse control, menus, sizable and movable windows and an interface to the Windows clipboard. Keystroke journaling is not available because of the complex editing environment. Because of the multitasking environment Sedt cannot take full control of the keyboard or even assume that the keyboard state is known. Therefore Sedt does not support the Num Lock and Scroll Lock keys as normal editing keys. 4.1 Window Control When you run Sedt is displays a normal MS window with a menu bar, a size box and a vertical scroll bar. All of these controls work exactly as with any other Windows application. When the window is resized you will notice that Sedt adapts to the new windows size so that horizontal shifting and vertical scrolling work exactly the same. The initial window will display buffer 0. As you open other buffers, they will be displayed in new windows. You can display the contents of several buffers at a time. As with the stand alone version, you can have four concurrently open windows. These are displayed in independent MS-Windows windows that can be moved and controlled independently. 4.2 Mouse Control The mouse cursor is an I-bar text cursor when it moves within the file display. Outside the file display it changes into an arrow pointer. Apart from the normal mouse controls of the windows and menus, you can also use the mouse to position the text cursor within the visible window and to select a region of text. To position the cursor, place the mouse pointer at the character position you want the cursor at, and click the left button. The cursor will move to the selected position unless the position is further to the right than the last character on the line, or past the end of the buffer. If the selected position is further to the right than the end of the line the cursor will be placed over the last character on the line. If it is past the end of the buffer you will get an error message. If you select a point on the first or last line of the buffer the window will scroll one line. To select a region of text you can use the mouse in two different ways. If you drag the cursor after clicking it the region from the initially selected cursor position to the point where you release the mouse button will be the selected region. If you accidentally select a region by dragging, you can cancel the select region by moving the mouse cursor to the block cursor and clicking the right mouse button. Alternately, a region can be selected by moving the mouse cursor to the end of the select region and clicking the right mouse button. In either case the selected region will change to reverse video. 4.3 Menu Control The menu bar will display five titles: File, Window, Edit, Ruler and Help. To select any of these move the mouse cursor to the title and a drop down menu will appear. To select an item move the mouse cursor to the item and click the left mouse button. A drop down menu will appear as long as you hold down the left mosue button. To select a menu item drag the cursor till the item you want is highlighted and release the mouse button. 4.3.1 File This menu is used to control the file being edited in the window. 4.3.1.1 New Clears the current window. If the window contains an unsaved file a dialog box will appear and you will be asked for confirmation before the unsaved edits are removed. 4.3.1.2 Open.. Displays a file selector dialog box. The file you select in the box is loaded into the current buffer. 4.3.1.2 Save Saves the file in the current buffer onto the file displayed after "File:" in the top line of the window. 4.3.1.3 Save as.. Displays a file selector dialog box. The contents of the buffer are saved onto the file you select. The file name displayed after "File:" in the top line of the window is also changed to the name of the file you selected. 4.3.1.4 Insert.. Displays a file selector dialog box. The file selected is included in the buffer at the current cursor position. 4.3.1.5 Quit Closes the current window. If there are unchanged buffers you will be asked for confirmation before the session is terminated. Sedt will terminate when the last window is closed. 4.3.2 Window The window menu allows you to switch between buffers and to clear the contents of a window. 4.3.2.1 Untitled Unused <File name> Makes the window containing the indicated buffer the currently selected window. The menu item shows the current state of the window. Untitled is an open window with no file associated with it. <File name> is the name of the file being edited, and Unused is a closed window. 4.3.2.2 Switch Selects the window you were in when you last selected a new window. 4.3.3 Edit The edit menu allows you to control the select region. 4.3.3.1 Clear Clears the select region. This is useful when you have accidentally activated a select region by moving the mouse while holding the button down. 4.3.3.2 Cut Cuts the selected region and saves it in the paste buffer. 4.3.3.3 Paste Inserts the contents of the paste buffer at the text cursor position. 4.3.4 Ruler Loads a saved ruler. 4.3.4.1 Load <X> Load saved ruler number <X> 4.3.5 Help The help menu displays the interactive help menus in the current window. Copyright (c) Anker Berg-Sonne, 1985,1986,1987,1988 Sedt Version 3.3 5 Using the ATARI GEM version of Sedt Under the ATARI GEM environment GSEDT.PRG offers the functionality described elsewhere in this manual with the addition of sizable and movable windows, mouse control, menu access to some functions and access to desk accessories while using Sedt. The only functions not available are journaling and recovery of keystrokes and spawning of subprocesses. 5.1 Window Control When you first enter Sedt it will display a single window with a menu bar, a move bar, a scroll bar, a full box and a size box. You can use any of these controls to move or resize the window. You will notice that every time the window has been resized Sedt will ensure that the cursor is within the new window and that no clipping takes place. Sedt will not allow any portion of the window to be outside the visible portion of the screen, and if you try, it will resize the window to prevent this from happening. The initial window will display buffer 0. As you open other buffers, they will be displayed in new windows that also are initialized to full screen size. You can display the contents of several buffers by resizing them and moving them to different screen areas. 5.2 Mouse Control Normally the mouse cursor is not visible. You can make it visible at any time by moving the mouse, and it will remain visible until you execute the next keyboard command. Apart from the normal mouse controls of the ATARI GEM windows and menus, you can also use the mouse to position the text cursor within the visible window and to select a region of text. To position the cursor, place the mouse pointer at the character position you want the cursor at, and click the left button. The cursor will move to the selected position unless the position is further to the right than the last character on the line, or past the end of the buffer. If the selected position is further to the right than the end of the line the cursor will be placed over the last character on the line. If it is past the end of the buffer you will get an error message. If you select a point on the first or last line of the buffer the window will scroll one line. To select a region of text move the mouse cursor to the place where you want the text cursor to be after the selection then push the left button on the mouse and, while holding the button down, drag the mouse cursor to the end of the region you want to select and release the button. You can clear the select region by clicking the cursor on the select point. 5.3 Menu Control The menu bar will display five titles: Desk, File, Window, Select and Help. To select any of these move the mouse cursor to the title and a drop down menu will appear. To select an item move the mouse cursor to the item and click the left mouse button. 5.3.1 Desk This is the normal desk accessory menu with a selection at the top titled "About Sedt". 5.3.1.1 About Sedt Displays in a dialog box the version of Sedt you are using. 5.3.2 File Allows you to control the file shown in the currently selected window. 5.3.2.1 Load.. Displays a file selector dialog box. The file you select in the box is loaded into the current buffer. 5.3.2.2 Save Saves the file in the current buffer onto the file displayed after "File:" in the top line of the window. 5.3.2.3 Save as.. Displays a file selector dialog box. The contents of the buffer are saved onto the file you select. The file name displayed after "File:" in the top line of the window is also changed to the name of the file you selected. 5.3.2.4 Insert.. Displays a file selector dialog box. The file selected is included in the buffer at the current cursor position. 5.3.2.5 Quit Closes the current window. If there are unchanged buffers you will be asked for confirmation before the session is terminated. Sedt will terminate when the last window is closed. 5.3.3 Window The window menu allows you to switch between buffers and to clear the contents of a window. 5.3.3.1 Untitled Unused <File name> Makes the window containing the indicated buffer the currently selected window. The menu item shows the current state of the window. Untitled is an open window with no file associated with it. <File name> is the name of the file being edited, and Unused is a closed window. 5.3.3.2 Switch Selects the window you were in when you last selected a new window. 5.3.3.3 Clear Erases the contents of a window. If the window contains unsaved changes you will be asked whether you want to save the changes before clearing the window. 5.3.4 Select The select menu allows you to control the select region. 5.3.4.1 Clear Clears the select region. This is useful when you have accidentally activated a select region by moving the mouse while holding the button down. 5.3.4.2 Cut Cuts the selected region and saves it in the paste buffer. 5.3.4.3 Paste Inserts the contents of the paste buffer at the text cursor position. 5.3.5 Ruler Loads a saved ruler. 5.3.5.1 Load <X> Load saved ruler number <X> 5.3.6 Help The help menu displays the interactive help menus in the current window. 5.3.6.1 Show Show the interactive help menus in the currently active window. Copyright (c) Anker Berg-Sonne, 1985,1986,1987,1988 Sedt Version 3.3 Sedt hints and tricks 6.1 Using Sedt for programming A number of features in Sedt are designed to make programming easier. This section describes these features and how best to take advantage of them. Autoindentation By setting the ruler for automatic indentation (type A anywhere on the ruler when in ruler definition mode) Sedt is set up to indent automatically to the level of the line you just terminated after you type a <Return>. This facility makes it easy to write programs in a structured fashion with the indentation level proportional to the level of nesting. Matching bracketing characters When programming, especially in C and LISP, nesting is often hard to get right. Sedt will locate a matching bracket (', ", <, >, [, ], {, }, (, or )) if you position the cursor over the character and type <Gold> <F19>. This facility can also be used to move over sections of the program. Compiling from within Sedt By defining a key to save the current file and spawn a compiler you can compile a program without leaving Sedt. If the compiler generates a listing of error messages, you can define the key to also load the listing in another buffer. Defining templates By using the lean key feature, you can define a series of keys in such a way that they insert templates for key language constructs. 6.2 Using Sedt for text and documents Formatting Use word wrap and right margin, either ragged ot justified to format paragraphs as you type. If you make changes to an already formatted paragraph, reformat the paragraph with <Gold> J. It is a good idea to have multiple stored rulers for different levels of indentation. Post processing Sedt is not a word processor and does not support many features such as bolding and underlining. There are, however, a number of post processors that together with Sedt will provide a more than acceptable word processing environment. Define a key to save the file, post process it and then print the final output. Spelling checkers Sedt works very well with resident spelling checkers such as Turbo Lightning on PC/DOS and Thunder on the ATARI ST. With a spelling checker and thesaurus, you have a superb environment for producing documents. 6.3 Repetitive tasks A number of tricks can be used to facilitate tasks that require repetition of a task many times. The techniques are based on the ability to dynamically change key definitions. Usually a combination of the techniques described lead to the optimal effort reduction. Using learned key sequences The standard technique for reexecuting a key sequence is to type <Gold> <F17> st the start of the sequence and terminate the sequence with ^Z. The sequence can then be replayed once by typing ^Z and many times by typing <Gold> <Number> ^Z. <Number> is the number of times you want to repeat the sequence and must be typed on the regular typewriter keyboard. More advanced use of learned key sequences You can learn keystrokes into other keys than ^Z by starting the process by typing <Gold> <F18> and then typing the key you want to learn into when prompted. To exit learning mode type the key you are learning into. The learned keystroke sequence can be replayed by typing the same key again. Redefining complex keystroke sequences A very simple technique is to redefine a command that is tied to a complex key sequence to a single keystroke. You can very easily redefine a gold key sequence to a single keystroke by typing ^K, then the single key you will tie the command to, <Return>, the old keystroke sequence, and finally <Return>. Using commands not tied to keys by default The default key definitions only use a subset of Sedt's capabilities. You can often simplify tasks by taking advantage of the more extensive capabilities of the basic command set. Turning screen updates off When a repetitive sequence generates extensive screen updates it can be simplified by taking advantage of the ability to turn screen updates off. Copyright (c) Anker Berg-Sonne, 1985,1986,1987,1988 Sedt Version 3.3 Reference Manual 7.1 Interpreting Keyboard Input Whenever a control character, a function key or a key preceded by <Gold> is typed Sedt will translate the keystroke into a series of internal commands. The mapping of keys to internal commands is defined by a key definition file and can be modified during the editing session. This chapter describes the syntax for internal commands and describes the sequence of events between typing a key and the effect of the command being displayed on the terminal. Sedt understands a large variety of commands and command combinations that have not been tied to any keys. To take full advantage of Sedt's power you will need to understand the internal command structure. 7.2 Translating Keystrokes When a key is typed the commands tied to the key will be written to an internal buffer. If the command string is not terminated by a period the command sequence will be stored and a new key will be read. This continues until a key with a definition terminated by a period is typed. This facilitates the use of multiple keystrokes to input a command sequence. The next step is to scan the command string for tokens and prompts. Tokens are replaced by the value of the token at the time of scanning and prompts will be displayed and then replaced by the response to the prompts. The recognized tokens and prompt strings are: ? will cause SEDT to expect the following syntax: ?<delimiter><string><delimiter> where <delimiter> is any ASCII character. SEDT will display <string> on the bottom line of the display and then accept input from the keyboard. ! will cause SEDT to expect the following syntax: !<delimiter><string><delimiter> where <delimiter> is any ASCII character. SEDT will display <string> on the bottom line of the display and wait for a key or <Gold> followed by a key to be struck. A unique ASCII representation for the key will be inserted in the command string instead of the above construct. The key representation is a code that identifies the class and value of the key. It consists of an alphabetic code that identifies the class followed by a three digit decimal number that defines the value. Valid classes are: A ASCII character. GA <Gold> ASCII character. F Function key. GF <Gold> function key. Key values: For ASCII characters the value is the ASCII value of the character. For function keys the value identifies the key as follows on all but scancode mapped layouts: 001 <F1> 002 <F2> 003 <F3> 004 <F4> 005 <F5> 006 <F6> 007 <F7> 008 <F8> 009 <F9> 010 <F10> 011 <F11> 012 <F12> 013 <F13> 014 <F14> 015 <F15> 016 <F16> 017 <F17> 018 <F18> 019 <F19> 020 <F20> 021 <Find> 022 <Insert Here> 023 <Remove> 024 <Select> 025 <Prev Screen> 026 <Next Screen> 027 <Up Arrow> 028 <Left Arrow> 029 <Down Arrow> 030 <Right Arrow> 031 <Keypad 0> 032 <Keypad 1> 033 <Keypad 2> 034 <Keypad 3> 035 <Keypad 4> 036 <Keypad 5> 037 <Keypad 6> 038 <Keypad 7> 039 <Keypad 8> 040 <Keypad 9> 041 <Keypad ,> 042 <Keypad -> 043 <Keypad .> 044 <Keypad PF1> 045 <Keypad PF2> 046 <Keypad PF3> 047 <Keypad PF4> 048 <Keypad Enter> 049 <Backspace> For scancode mapped keyboard layouts the values are: 000 Ctrl Break (*) 001 Alt Esc (*) 003 Null character 014 Alt Backspace (*) 015 Tab 016 Alt Q 017 Alt W 018 Alt E 019 Alt R 020 Alt T 021 Alt Y 022 Alt U 023 Alt I 024 Alt O 025 Alt P 026 Alt [ (*) 027 Alt ] (*) 028 Alt Ctrl (*) 030 Alt A 031 Alt S 032 Alt D 033 Alt F 034 Alt G 035 Alt H 036 Alt J 037 Alt K 038 Alt L 039 Alt ; (*) 040 Alt ' (*) 041 Alt ~ (*) 043 Alt \ (*) 044 Alt Z 045 Alt X 046 Alt C 047 Alt V 048 Alt B 049 Alt N 050 Alt M 051 Alt , (*) 052 Alt . (*) 053 Alt / (*) 055 Alt * (*) 059 F1 060 F2 061 F3 062 F4 063 F5 064 F6 065 F7 066 F8 067 F9 068 F10 071 Home 072 Up Arrow 073 Page Up 074 Alt Keypad - (*) 075 Left Arrow 076 Center Key (*) 077 Right Arrow 078 Alt Keypad + (*) 079 End 080 Down Arrow 081 Page Down 082 Insert 083 Delete 084 Uppercase F1 085 Uppercase F2 086 Uppercase F3 087 Uppercase F4 088 Uppercase F5 089 Uppercase F6 090 Uppercase F7 091 Uppercase F8 092 Uppercase F9 093 Uppercase F10 094 Control F1 095 Control F2 096 Control F3 097 Control F4 098 Control F5 099 Control F6 100 Control F7 101 Control F8 102 Control F9 103 Control F10 104 Alt F1 105 Alt F2 106 Alt F3 107 Alt F4 108 Alt F5 109 Alt F6 110 Alt F7 111 Alt F8 112 Alt F9 113 Alt F10 114 Control Print Screen 115 Control Left Arrow 116 Control Right Arrow 117 Control End (Erase to end of line) 118 Control Page Down 119 Control Home (Clear screen) 120 Alt 1 121 Alt 2 122 Alt 3 123 Alt 4 124 Alt 5 125 Alt 6 126 Alt 7 127 Alt 8 128 Alt 9 129 Alt 0 130 Alt - 131 Alt = 132 Control Page Up 133 F11 (*) 134 F12 (*) 135 Shift F11 (*) 136 Shift F12 (*) 137 Ctrl F11 (*) 138 Ctrl F12 (*) 139 Alt F11 (*) 140 Alt F12 (*) 141 Ctrl Up Arrow (*) 142 Ctrl Keypad - (*) 143 Ctrl Center (*) 144 Ctrl Keypad + (*) 145 Ctrl Down Arrow (*) 146 Ctrl Ins (*) 147 Ctrl Del (*) 148 Ctrl Tab (*) 149 Ctrl / (*) 150 Ctrl * (*) 151 Alt Home (*) 152 Alt Up (*) 153 Alt PageUp (*) 155 Alt Left (*) 157 Alt Right (*) 159 Alt End (*) 160 Alt Down (*) 161 Alt PageDown (*) 162 Alt Insert (*) 163 Alt Delete (*) 164 Alt / (*) 165 Alt Tab (*) 166 Alt Enter (*) (*) Enhanced keyboard % must be followed by one of the following characters: %, #, F, N, E, L, C, T, D or P. %% is replaced by a single %. %#<Letter> is replaced by the current value of the counters controlled by :CNS, :CNI and :CNP. <Letter> must be in the range A to Z. %F is replaced by the name of the output file of the current buffer being edited. %N is replaced by the name of the output file of the current buffer being edited, up to, but not including, the first period. %T is replaced by the file type, including the leading period, of the output file of the current buffer. %D is replaced by the device and directory specification of the output file of the current buffer. %E is only supported on VMS and MS-DOS. On VMS it will be replaced by the string Sedt$Dir:, and on MS-DOS by the value of the SEDT environment variable. %L is replaced by the current line number. %C is replaced by the current character position. %P is replaced by the contents of the paste buffer 7.3 Command Syntax Once the command string has been preprocessed it is interpreted as a series of commands. This chapter describes all SEDT commands. For some examples of how keys are programmed study the keyboard definition file supplied with Sedt. If an error occurs during execution of a command string all commands following the one that the error occurred in will be skipped. Also, if the command was in a series of commands enclosed in parentheses preceded by a count the parentheses are exited and further iterations skipped. SEDT commands may be grouped by placing them in parentheses. A count in front of a group of commands in parentheses causes the group to be repeated the number of times given in the count. It is also possible to execute commands conditionally. ^C(<Commands>) causes <Commands> to be executed only if the current buffer contains unsaved changes. ^C(<Commands1>|<Commands2>) causes <Commands1> to be executed if the buffer contains unsaved changes and <Commands2> to executed if the buffer is unchanged. ^E(<Commands1>)(<Commands2>) causes <Commands1> to be executed. If any error occurs during the execution the rest of <Commands1> will be skipped and <Commands2> will be executed. <Commands2> string is ignored if no error occurs. ^E(<Commands1>)(<Commands2>|<Commands3>) will execute <Commands1>. If an error occurs the rest of <Commands1> will be skipped and then <Commands2> will be executed, otherwise <Commands3> is executed after completion of <Commands1>. ^S(<Commands>) causes <Commands> to be executed only if there is a select region active. ^S(<Commands1>|<Commands2>) causes <Commands1> to be executed if a select region is active. If no select region is active <Commands2> will be executed>. To save a flag and have it restored after a command sequence you bracket the command sequence and precede it with one of the following commands: ^TD(<commands>) Saves the direction flag and restores it after <commands> have been executed. ^TI(<commands>) Saves the replace/insert mode flag and restores it after <commands> have been executed. ^TB(<commands>) Saves the block/line mode flag and restores it after <commands> have been executed. ^TT(<commands>) Saves the the tab insert/expand flag and restores it after <commands> have been executed. SEDT commands are alphanumeric strings preceded by either the symbol @ or :. Commands preceded by @ define a cursor position and normally move the cursor to the position the command defines. Commands preceded by : are action commands that perform a change on the file being edited or change the editing environment. Some action commands must be followed by a position command that defines the range of text that the command acts on. All commands can be preceded by a direction indicator and/or a count. Not all commands use the direction indicator or count. Those that do have the direction indicator or count in the syntactical description. The direction indicator is one of +, -, < or >. + and > set the current direction to be forward, toward the last character in the buffer. - and < set the current direction to be backward, toward the first character in the buffer. If no direction indicator is provided the command will use the default direction, which initially is forward but can be changed with the commands :A and :B. Count is either a string of decimal digits optionally followed by a dollar sign, $, and another string of decimal digits, or a dollar sign, $, followed by a string of decimal digits. If no dollar sign is in the count, or it starts with a dollar sign, it is interpreted as the decimal value defined by the string. If the count contains a dollar sign between two decimal strings it is interpreted at the decimal value defined by the first string. If no count is given the command will use a count of one. This feature allows you to program a key to have a default count by starting the definition with $<count>; If the user supplies a count, it will override the one after $. $10 returns the count 10 20$30 returns the count 20 40 returns the count 40 7.4 Commands 7.4.1.1 @AC Absolute Character Syntax: {<Count>}@AC Semantics: Move the cursor to the absolute character position <Count> in the current buffer. 7.4.1.2 @AL Absolute Line Syntax: {<Count>}@AL Semantics: Move the cursor to the start of absolute line <Count> in the current buffer. 7.4.1.3 @BB Beginning of Buffer Syntax: @BB Semantics: Move the cursor to the first character in the current buffer. 7.4.1.4 @BM Matching Bracketing Character Syntax: @BM Semantics: Move the cursor to the matching character if the character under the cursor is one of: ', ", <, >, [, ], {, }, (, or ). ' and " are searched for in the current direction, the others in the direction the character implies. 7.4.1.5 @EB End of Buffer Syntax: @EB Semantics: Move the cursor to the end of the current buffer. The cursor position will be right after the last character in the buffer. 7.4.1.6 @EL End of Line Syntax: <Count>@EL Semantics: Move the cursor to the next end of line in the current direction. The end of line is the position to the immediate right of the last character in the line. 0+@EL is a special case which always stays at the end of the current line. 7.4.1.7 @C Character Syntax: {+|-|<|>}{<Count>}@C Semantics: Move the cursor <Count> characters in the current direction. The end of line terminator is counted as a character. 7.4.1.8 @F Find Syntax: {+|-|<|>}{<Count>}@F<Delimiter><String><Delimiter> Semantics: If the <String> is not empty load it into an internal buffer called the current search string. The search for an occurrence of the current search string in the current direction and place the cursor over the first character in the occurrence. The search is case insensitive. 7.4.1.9 @L Line Syntax: {+|-|<|>}{<Count>}@L Semantics: Move the cursor to the <Count>'th start of line in the current direction. The start of line is the first character on the line, blank or non-blank. 0-@L is a special case, which stays at the beginning of the current line. 7.4.1.10 @M Mark Syntax: {<Count>}@M Semantics: Move the cursor to the position in the file where the cursor was when a :M command with the same count was executed last. Valid counts are 1 through 10. An error message is displayed if an invalid count is given or a :M command has not previously been executed with the same count. 7.4.1.11 @N Next Syntax: {+|-|<|>}{<Count>}@N Semantics: Move the cursor to the <Count>'th occurrence in the current direction of the string last given in an @F command. The cursor is placed over the first character of the string. The search is case insensitive. 7.4.1.12 @PAG Page Syntax: {+|-|<|>}{<Count>}@PAG Semantics: Move the cursor to the first character after the <Count>'th ASCII <FF> in the current direction. If there are <Count>-1 ASCII <FF>'s in the current direction the cursor will be placed at the beginning of the file if the direction is backwards or at the end of the file if the direction is forward. 7.4.1.13 @PAR Paragraph Syntax: {+|-|<|>}{<Count>}@PAR Semantics: Move the cursor to the <Count>'th start of paragraph in the current direction. If there are exactly <Count>-1 beginning of paragraphs the cursor will be placed at the beginning of the file if the direction is backward or at the end of the file if the direction is forward. A beginning of paragraph is a sequence of ASCII space, tab and line feeds containing at least two line feeds. The cursor is placed on the first character after the string of spaces, tabs and line feeds. 7.4.1.14 @SCR Screen Syntax: {+|-|<|>}{<Count>}@SCR Semantics: Move <Count> times one less than the number of lines in the current window lines in the current direction. 7.4.1.15 @SEN Sentence Syntax: {+|-|<|>}{<Count>}@SEN Semantics: Move to the <Count>'th start of sentence in the current direction. A start of sentence is the first character after a string of ASCII spaces, tabs, line feeds, <.>, <;>, <?>, <!>, or <:> containing exactly one line feed, <.>, <;>, <?>, <!>, or <:> . If there are exactly <Count>-1 sentences the cursor will be placed at the start of the file if the direction is backwards or at the end of the file if the direction is forward. 7.4.1.16 @SR Select Range Syntax: @SR Semantics: Move the cursor to the point the cursor was at the last time a :SEL command was executed. An error message is displayed if a :SEL command has not been executed. 7.4.1.17 @V Vertical Syntax: {+|-|<|>}{<Count>}@V Semantics: Move the cursor <Count> lines in the current direction. SEDT attempts to position the cursor at the same column as the cursor was at before a series of @V commands were issued. The cursor is never placed further to the right than one column to the right of the last character on a line. If the line contains ASCII tab characters or characters that SEDT represents with multi-character sequences it may not be able to position at exactly the same column. A series of these commands will attempt to keep the cursor at the column it was at when the first command was executed. 7.4.1.18 @W Word Syntax: {+|-|<|>}{<Count>}@W Semantics: Move the cursor <Count> words in the current direction. A word is either an alphanumeric string containing underscores <_> or printable ASCII characters or a single non-alphanumeric, printable ASCII character. The cursor is positioned over the first character in the word. 7.4.1.19 @XNM Next Mark Syntax: @XNM Semantics: Move to the next marked position. The next mark is the closest in the current directlion. An error is caused if there are no more marks in ht current direction. 7.4.1.20 @XSR Select Range with no clear Syntax: @XSR Semantics: Exactly the same as @SR, but the select region is not cleared. 7.4.2.1 :A Advance Syntax: :A Semantics: Set the default direction for cursor-movement commands to be forward toward the end of the file. The default direction is displayed on the mode line of the display. 7.4.2.2 :B Backward Syntax: :B Semantics: Set the default direction for cursor-movement commands to be backward toward the start of the file. The default direction is displayed on the mode line of the display. 7.4.2.3 :CB Cursor at Bottom Syntax: :CB Semantics: Scrolls the current window to place the cursor line at the next to last line in the window. Is only available in full screen editing mode. 7.4.2.4 :CC Change Case Syntax: :CC<@ command> Semantics: Switch all lower case characters to upper case and all upper case characters to lower case from the current cursor position to the position defined by the @ command. 7.4.2.5 :CD Change to Lower case Syntax: :CD<@ command> Semantics: Change all upper case characters to lower case from the current cursor position to the position defined by the @ command. 7.4.2.6 :CE Change Case Edt Style Syntax: <Count>:CE Semantics: Change the case of alphabetic characters according to the following rules: If a select range is active change the case within the select range. Otherwise, if the last command was a search command change the case of the string found by the search. Otherwise change the case of <Count> characters from the cursor position. 7.4.2.7 :CH Insert ASCII Character Syntax: <Count>:CH Semantics: Insert an ASCII character of decimal value <Count> at the cursor position. 7.4.2.8 :CL Center Line Syntax: :CL Semantics: Center the line containing the cursor between the left and right margins (denoted by L and R or J in the ruler line). 7.4.2.9 :CM Cursor at Middle Syntax: :CM Semantics: Scrolls the current window to place the cursor line on the middle line in the window. Is only available in full screen editing mode. 7.4.2.10 :CNA Add number to counter Syntax: :CNA{#<Letter>} Semantics: Add the contents of the buffer, starting at the current cursor position as an integer up to the first non-numeric character, to the value of the counter. The value can be preceeded by a + or - character. If #<Letter> is included the value will be taken from the variable <Letter>. Omitting #<Letter> has the same effects as #A. <Letter> must be in the range A to Z. 7.4.2.11 :CNG Get counter from buffer Syntax: :CNG{#<Letter>} Semantics: Interpret the contents of the buffer, starting at the current cursor position as an integer up to the first non-numeric character and place the value in the counter. The value can be preceeded by a + or - character. If #<Letter> is included the value will be taken from the variable <Letter>. Omitting #<Letter> has the same effects as #A. <Letter> must be in the range A to Z. 7.4.2.12 :CNI Increment or Decrement Counter Syntax: {+|-}{<Count>}:CNI{#<Letter>} Semantics: Increment or decrement the value of Sedt's internal counter by <Count>. If #<Letter> is included the value will be taken from the variable <Letter>. Omitting #<Letter> has the same effects as #A. <Letter> must be in the range A to Z. 7.4.2.13 :CNP Insert Value of Counter in Buffer Syntax: :CNP{#<Letter>} Semantics: Insert the decimal value of Sedt's internal counter into the current buffer at the cursor location. If #<Letter> is included the value will be taken from the variable <Letter>. Omitting #<Letter> has the same effects as #A. <Letter> must be in the range A to Z. 7.4.2.14 :CNS Set Value of Counter Syntax: {+|-|}{<Count>}:CNS{#<Letter>} Semantics: Set the value of Sedt's internal counter to <Count>. If #<Letter> is included the value will be taken from the variable <Letter>. Omitting #<Letter> has the same effects as #A. <Letter> must be in the range A to Z. 7.4.2.15 :CS Save Buffer Context Syntax: :CS Semantics: Save the cursor position, all marks and the current ruler in a file with the same file name as the output file of the current buffer, but with the extention .CTX. If the option CONTEXT=SAVED is set these setting will be restored when the file is opened for editing. 7.4.2.16 :CT Cursor at Top Syntax: :CT Semantics: Scrolls the current window to place the cursor line at the second line in the window. Is only available in full screen editing mode. 7.4.2.17 :CU Change to Upper Case Syntax: :CU<@ command> Semantics: Change all lower case characters to upper case from the current cursor position to the position defined by the @ command. 7.4.2.18 :D Delete Syntax: :D<@ command> Semantics: Delete all characters from the current position to the position defined by the @ command and place the deleted text in an internal buffer. Separate buffers exist for different @ commands; The relationship between @ commands and delete buffers is: @AC Unknown @AL Unknown @BB Unknown @EB Unknown @EL Line @C Char @F Find @L Line @M Unknown @N Find @PAG Pag @PAR Par @SEN Sen @SR Paste @V Unknown @W Word In insert mode the text will be removed entirely and the text after the block removed will immediately follow the text before the block. In replace mode the block removed will be replaced with space characters, preserving any line terminators. 7.4.2.19 :EAP Delete and Append Syntax: :EAP<@ command> Semantics: Delete all characters from the current position to the position defined by the @ command and appends the text to the contents of an internal buffer. Separate buffers exist for different @ commands; The relationship between @ commands and delete buffers is: @AC Unknown @AL Unknown @BB Unknown @EB Unknown @EL Line @C Char @F Find @L Line @M Unknown @N Find @PAG Pag @PAR Par @SEN Sen @SR Paste @V Unknown @W Word In insert mode the text will be removed entirely and the text after the block removed will immediately follow the text before the block. In replace mode the block removed will be replaced with space characters, preserving any line terminators. 7.4.2.20 :EK Execute Key Syntax: :EK<Key> Semantics: Execute the definition of <Key> exactly as if it had been typed on the keyboard. This includes prompting for input and replacement of tokens. <Key> is a code that identifies the class and value of the key. It consists of an alphabetic code that identifies the class followed by a three digit decimal number that defines the value. Valid classes are: A ASCII character. GA Gold ASCII character. F Function key. GF Gold function key. Key values: For ASCII characters the value is the ASCII value of the character. For function keys the value identifies the key as follows: 001 <F1> 002 <F2> 003 <F3> 004 <F4> 005 <F5> 006 <F6> 007 <F7> 008 <F8> 009 <F9> 010 <F10> 011 <F11> 012 <F12> 013 <F13> 014 <F14> 015 <F15> 016 <F16> 017 <F17> 018 <F18> 019 <F19> 020 <F20> 021 <Find> 022 <Insert Here> 023 <Remove> 024 <Select> 025 <Prev Screen> 026 <Next Screen> 027 <Up Arrow> 028 <Left Arrow> 029 <Down Arrow> 030 <Right Arrow> 031 <Keypad 0> 032 <Keypad 1> 033 <Keypad 2> 034 <Keypad 3> 035 <Keypad 4> 036 <Keypad 5> 037 <Keypad 6> 038 <Keypad 7> 039 <Keypad 8> 040 <Keypad 9> 041 <Keypad ,> 042 <Keypad -> 043 <Keypad .> 044 <Keypad PF1> 045 <Keypad PF2> 046 <Keypad PF3> 047 <Keypad PF4> 048 <Keypad Enter> 049 <Backspace> For scancode mapped keyboard layouts the values are: 000 Ctrl Break (*) 001 Alt Esc (*) 003 Null character 014 Alt Backspace (*) 015 Tab 016 Alt Q 017 Alt W 018 Alt E 019 Alt R 020 Alt T 021 Alt Y 022 Alt U 023 Alt I 024 Alt O 025 Alt P 026 Alt [ (*) 027 Alt ] (*) 028 Alt Ctrl (*) 030 Alt A 031 Alt S 032 Alt D 033 Alt F 034 Alt G 035 Alt H 036 Alt J 037 Alt K 038 Alt L 039 Alt ; (*) 040 Alt ' (*) 041 Alt ~ (*) 043 Alt \ (*) 044 Alt Z 045 Alt X 046 Alt C 047 Alt V 048 Alt B 049 Alt N 050 Alt M 051 Alt , (*) 052 Alt . (*) 053 Alt / (*) 055 Alt * (*) 059 F1 060 F2 061 F3 062 F4 063 F5 064 F6 065 F7 066 F8 067 F9 068 F10 071 Home 072 Up Arrow 073 Page Up 074 Alt Keypad - (*) 075 Left Arrow 076 Center Key (*) 077 Right Arrow 078 Alt Keypad + (*) 079 End 080 Down Arrow 081 Page Down 082 Insert 083 Delete 084 Uppercase F1 085 Uppercase F2 086 Uppercase F3 087 Uppercase F4 088 Uppercase F5 089 Uppercase F6 090 Uppercase F7 091 Uppercase F8 092 Uppercase F9 093 Uppercase F10 094 Control F1 095 Control F2 096 Control F3 097 Control F4 098 Control F5 099 Control F6 100 Control F7 101 Control F8 102 Control F9 103 Control F10 104 Alt F1 105 Alt F2 106 Alt F3 107 Alt F4 108 Alt F5 109 Alt F6 110 Alt F7 111 Alt F8 112 Alt F9 113 Alt F10 114 Control Print Screen 115 Control Left Arrow 116 Control Right Arrow 117 Control End (Erase to end of line) 118 Control Page Down 119 Control Home (Clear screen) 120 Alt 1 121 Alt 2 122 Alt 3 123 Alt 4 124 Alt 5 125 Alt 6 126 Alt 7 127 Alt 8 128 Alt 9 129 Alt 0 130 Alt - 131 Alt = 132 Control Page Up 133 F11 (*) 134 F12 (*) 135 Shift F11 (*) 136 Shift F12 (*) 137 Ctrl F11 (*) 138 Ctrl F12 (*) 139 Alt F11 (*) 140 Alt F12 (*) 141 Ctrl Up Arrow (*) 142 Ctrl Keypad - (*) 143 Ctrl Center (*) 144 Ctrl Keypad + (*) 145 Ctrl Down Arrow (*) 146 Ctrl Ins (*) 147 Ctrl Del (*) 148 Ctrl Tab (*) 149 Ctrl / (*) 150 Ctrl * (*) 151 Alt Home (*) 152 Alt Up (*) 153 Alt PageUp (*) 155 Alt Left (*) 157 Alt Right (*) 159 Alt End (*) 160 Alt Down (*) 161 Alt PageDown (*) 162 Alt Insert (*) 163 Alt Delete (*) 164 Alt / (*) 165 Alt Tab (*) 166 Alt Enter (*) (*) Enhanced Keyboard 7.4.2.21 :EL Set error level Syntax: <Count>:EL Semantics: Set the error level to ring the bell at <count> 3: All errors 2: All errors except entity errors (default) 1: Only serious and fatal errors 0: never 7.4.2.22 :ERC Clear Edit Region Syntax: :ERC Semantics: Cancels any edit region in effect. 7.4.2.23 :ERS Set Edit Region Syntax: :ERS<@ Command> Semantics: Sets the edit region of the current buffer to go from the current cursor position to the point defined by <@ Command>. As long as an edit region is in effect the cursor cannot be moved outside it, thus limiting any editing operations be happen within the region. 7.4.2.24 :FE Edit File Syntax: :FE<Delimiter><File Name><Delimiter> Semantics: If the current buffer contains modified text the user is asked whether the current contents should be saved. If affirmative, the contents are saved in the current output file, otherwise the contents are discarded. The contents of the buffer are then cleared. The <File Name> argument is assigned to the input file name and output file name of the current buffer and the file is read into the buffer if it exists. A new journal file is opened. The cursor is placed at the first character of the file. 7.4.2.25 :FG Get File Syntax: :FG<Delimiter><File Name><Delimiter> Semantics: Read the contents of the file into the current buffer at the current cursor position. The cursor is placed at the first character read in. 7.4.2.26 :FNL Font Larger Syntax: :FNL Semantics: Select the next larger font that the system can display. 7.4.2.27 :FNS Font Smaller Syntax: :FNS Semantics: Select the next smaller font that the system can display. 7.4.2.28 :FS Save File Syntax: :FS<Delimiter><File Name><Delimiter> Semantics: Save the contents of the current buffer in the file given in the <File Name> argument. If the argument is empty, save in the output file of the current buffer. A new journal file is opened. Recovery of a session using a journal file opened after :FS may not work because the editing environment (delete buffers, cursor position) may be different when recovery is attempted. 7.4.2.29 :FW Write File Syntax: :FW<Delimiter><File Name><Delimiter> Semantics: Write the contents of the current buffer to the file given in the <File Name> argument. 7.4.2.30 :FX Execute File Syntax: :FX<Delimiter><File Name><Delimiter> Semantics: Read the file given in <File Name> and execute each line as SEDT commands. ?, ! and % expansion is done before execution of each line. 7.4.2.31 :GAP Get and append Syntax: :GAP<@ command> Semantics: Append the text between the current cursor position and the position defined by the @ command to the contents of an internal buffer. The text is not deleted from the current buffer. Several buffers are used for different @ commands as follows: @AC Unknown @AL Unknown @BB Unknown @EB Unknown @EL Line @C Char @F Find @L Line @M Unknown @N Find @PAG Pag @PAR Par @SEN Sen @SR Paste @V Unknown @W Word 7.4.2.32 :GE Get Syntax: :GE<@ command> Semantics: Place the text between the current cursor position and the position defined by the @ command and place it in an internal buffer. The text is not deleted from the current buffer. Several buffers are used for different @ commands as follows: @AC Unknown @AL Unknown @BB Unknown @EB Unknown @EL Line @C Char @F Find @L Line @M Unknown @N Find @PAG Pag @PAR Par @SEN Sen @SR Paste @V Unknown @W Word 7.4.2.33 :GR Get ruler Syntax: <Count>:GR Semantics: Read the contents of the file RULER<Count>.TXT and define the ruler from the contents of the file. The file should have been written by a save ruler command within the :RL command. On PC versions the file should be located in SEDT's master directory. Under VMS the file is should be placed in the directory defined by the logical variable SEDT$DIR. 7.4.2.34 :H Help Syntax: :H Semantics: Read the help and display it page by page on the screen. On PC versions the help file is in SEDT's master directory. Under VMS the file is defined by the logical name SEDT$HELP. The naming convention for the help file is as follows: System Keyboard File Rainbow LK201 RBHLP.TXT IBM PC IBM PCHLP.TXT IBM PC/XT IBM XTHLP.TXT IBM PC/AT IBM ATHLP.TXT ANY IBM PC NEW IBM ATHLP.TXT VAX VT100 SEDT$VT100HELP: VAX VT200 SEDT$VT200HELP: ATARI ST STHLP.TXT 7.4.2.35 :I Insert Syntax: :I<Delimiter><Any text><Delimiter> Semantics: Insert the text in the current buffer. The cursor is placed after the last inserted character. 7.4.2.36 :K Define key Syntax: :K<Key><Delimiter><Definition><Delimiter> Semantics: Program the key given in <Key> to perform the commands given in <Definition>. If <Definition> ends with a period the commands will be executed when the key is pressed, otherwise the execution is stored and executed when a key ending with a period is struck. <Key> is a code that identifies the class and value of the key. It consists of an alphabetic code that identifies the class followed by a three digit decimal number that defines the value. Valid classes are: A ASCII character. GA Gold ASCII character. F Function key. GF Gold function key. Key values: For ASCII characters the value is the ASCII value of the character. For function keys the value identifies the key as follows: 001 <F1> 002 <F2> 003 <F3> 004 <F4> 005 <F5> 006 <F6> 007 <F7> 008 <F8> 009 <F9> 010 <F10> 011 <F11> 012 <F12> 013 <F13> 014 <F14> 015 <F15> 016 <F16> 017 <F17> 018 <F18> 019 <F19> 020 <F20> 021 <Find> 022 <Insert Here> 023 <Remove> 024 <Select> 025 <Prev Screen> 026 <Next Screen> 027 <Up Arrow> 028 <Left Arrow> 029 <Down Arrow> 030 <Right Arrow> 031 <Keypad 0> 032 <Keypad 1> 033 <Keypad 2> 034 <Keypad 3> 035 <Keypad 4> 036 <Keypad 5> 037 <Keypad 6> 038 <Keypad 7> 039 <Keypad 8> 040 <Keypad 9> 041 <Keypad ,> 042 <Keypad -> 043 <Keypad .> 044 <Keypad PF1> 045 <Keypad PF2> 046 <Keypad PF3> 047 <Keypad PF4> 048 <Keypad Enter> 049 <Backspace> For scancode mapped keyboard layouts the values are: 000 Ctrl Break (*) 001 Alt Esc (*) 003 Null character 014 Alt Backspace (*) 015 Tab 016 Alt Q 017 Alt W 018 Alt E 019 Alt R 020 Alt T 021 Alt Y 022 Alt U 023 Alt I 024 Alt O 025 Alt P 026 Alt [ (*) 027 Alt ] (*) 028 Alt Ctrl (*) 030 Alt A 031 Alt S 032 Alt D 033 Alt F 034 Alt G 035 Alt H 036 Alt J 037 Alt K 038 Alt L 039 Alt ; (*) 040 Alt ' (*) 041 Alt ~ (*) 043 Alt \ (*) 044 Alt Z 045 Alt X 046 Alt C 047 Alt V 048 Alt B 049 Alt N 050 Alt M 051 Alt , (*) 052 Alt . (*) 053 Alt / (*) 055 Alt * (*) 059 F1 060 F2 061 F3 062 F4 063 F5 064 F6 065 F7 066 F8 067 F9 068 F10 071 Home 072 Up Arrow 073 Page Up 074 Alt Keypad - (*) 075 Left Arrow 076 Center Key (*) 077 Right Arrow 078 Alt Keypad + (*) 079 End 080 Down Arrow 081 Page Down 082 Insert 083 Delete 084 Uppercase F1 085 Uppercase F2 086 Uppercase F3 087 Uppercase F4 088 Uppercase F5 089 Uppercase F6 090 Uppercase F7 091 Uppercase F8 092 Uppercase F9 093 Uppercase F10 094 Control F1 095 Control F2 096 Control F3 097 Control F4 098 Control F5 099 Control F6 100 Control F7 101 Control F8 102 Control F9 103 Control F10 104 Alt F1 105 Alt F2 106 Alt F3 107 Alt F4 108 Alt F5 109 Alt F6 110 Alt F7 111 Alt F8 112 Alt F9 113 Alt F10 114 Control Print Screen 115 Control Left Arrow 116 Control Right Arrow 117 Control End (Erase to end of line) 118 Control Page Down 119 Control Home (Clear screen) 120 Alt 1 121 Alt 2 122 Alt 3 123 Alt 4 124 Alt 5 125 Alt 6 126 Alt 7 127 Alt 8 128 Alt 9 129 Alt 0 130 Alt - 131 Alt = 132 Control Page Up 133 F11 (*) 134 F12 (*) 135 Shift F11 (*) 136 Shift F12 (*) 137 Ctrl F11 (*) 138 Ctrl F12 (*) 139 Alt F11 (*) 140 Alt F12 (*) 141 Ctrl Up Arrow (*) 142 Ctrl Keypad - (*) 143 Ctrl Center (*) 144 Ctrl Keypad + (*) 145 Ctrl Down Arrow (*) 146 Ctrl Ins (*) 147 Ctrl Del (*) 148 Ctrl Tab (*) 149 Ctrl / (*) 150 Ctrl * (*) 151 Alt Home (*) 152 Alt Up (*) 153 Alt PageUp (*) 155 Alt Left (*) 157 Alt Right (*) 159 Alt End (*) 160 Alt Down (*) 161 Alt PageDown (*) 162 Alt Insert (*) 163 Alt Delete (*) 164 Alt / (*) 165 Alt Tab (*) 166 Alt Enter (*) (*) Enhanced Keyboard 7.4.2.37 :LD Decrease indentation Syntax: {<Count>}:LD Semantics: Reduce the indentation level by <Count>, which defaults to 1. The :TAB command moves the cursor to the indentation level if the cursor is placed to the left of the indentation level. The indentation level is shown with an I on the ruler display. 7.4.2.38 :LI Increase indentation Syntax: {<Count>}:LI Semantics: Increase the indentation level by <Count>, which defaults to 1. The :TAB command moves the cursor to the indentation level if the cursor is placed to the left of the indentation level. The indentation level is shown with an I on the ruler display. 7.4.2.39 :LK Load key definition Syntax: :LK<Key><@ Command> Semantics: Program the key given in <Key> to contain the contents of the given entity. See :K for the valid codes for <Key>. 7.4.2.40 :LNE Execute keystrokes stored in key Syntax: {<Count>}:LNE<Key> Semantics: Interpret the programming of the key defined by <Key> as a sequence of keystrokes. The key is assumed to have been programmed through the use of the :LNL command. See :K for a description of valid codes for <Key>. 7.4.2.41 :LNL Store keystrokes in key Syntax: :LNL<Key> Semantics: Store subsequent keystrokes in the programming of the key defined by <Key> until that key is struck. The keystrokes are executed as they are stored. The commands :LNL and :LNE are used to store the keystrokes required to perform a repeated task and then perform the task without having to repeat the keystroke sequence. See :K for a description of valid codes for <Key>. The stored keystrokes are encoded as a code for the class of the key followed by either an ASCII character or a 3 digit ASCII value for the key. Codes are: A ASCII character G Gold ASCII character F Function key B Gold function key For printable ASCII characters, except digits, the code is followed by the character. Otherwise the code is followed by a 3 digit function key number, see :K for valid values, or an ASCII character value. 7.4.2.42 :LNX End learning Syntax: :LNX Semantics: Terminate keystroke learning if it is in effect. This command has no effect if keystroke learning is not in effect. 7.4.2.43 :LS Set indentation level Syntax: :LS Semantics: Set the indentation level to the current cursor position. The :TAB command moves the cursor to the indentation level if the cursor is placed to the left of the indentation level. The indentation level is shown with an I on the ruler display. 7.4.2.44 :M Mark cursor position Syntax: {-}{<Count>}:M Semantics: Store the current cursor position in one of 9 marks. <Count>, which defaults to 1, specifies the mark to save the position in. Valid marks are 1 through 9. As text is inserted and deleted from the buffer marks are adjusted to point to the same logical positions in the file. -<Count>:M clears mark number <Count>. 7.4.2.45 :NL New line Syntax: {<Count>}:NL Semantics: Insert a new line at the cursor position and advance the cursor to the beginning of the new line. If the ruler line has automatic margin control set the margin is set to the leftmost character position not containing spaces and tabs in the line the cursor was on. If the old line had only spaces or tabs the automatic margin is set to column 1. Finally insert spaces and tabs to advance the cursor to the automatic margin just defined. The result will be that left margins will line up at any column position. If a non-automatic left margin is set spaces and tabs are inserted to advance the cursor to the left margin. 7.4.2.46 :NS Substitute next Syntax: {+|-|<|>}{<Count>}:NS Semantics: Search in the current direction for the current search string and if it is found replace the occurrence with the current substitute string. If the cursor is placed on the first character of an occurrence the first substitution will be made on that occurrence. The current search string is set with @F. :SL or :SUB. The current substitute string is set with :SUB. The search is case insensitive. 7.4.2.47 :OE Output error message Syntax: <Count>:OE<Delimiter><Message><Delimiter> Semantics: Output <Message> exactly as an internal error message from SEDT and perform the normal error skipping of commands. Count is used to set the error level. 7.4.2.48 :OL Open line Syntax: {<Count>}:OL Semantics: Insert <Count>, which defaults to 1, line feeds after the current cursor position. 7.4.2.49 :OM Output message Syntax: :OM<Delimiter><Message><Delimiter> Semantics: Output <Message> on the message line of the display. 7.4.2.50 :OS Toggle over-strike mode Syntax: :OS Semantics: Switch between insert and replace mode. In insert mode typed input and characters inserted with :I are inserted at the cursor position and the cursor position is advanced, thus pushing the text after the cursor in front of it. In replace mode the character at the cursor position is replaced by the character being inserted. If the cursor is at the end of the line the character will be inserted rather than replaced. If the cursor is at a tab character the tab will be expanded to spaces before the replacement takes place. The current replace/insert mode is displayed on the mode line of the display. 7.4.2.51 :OW Switch to previous buffer Syntax: :OW Semantics: Switch to displaying the buffer that was selected before switching to the current. In two window display mode the displays in the top and bottom windows will be switched. If no buffer has been selected switch to buffer number 1. 7.4.2.52 :PD Insert current date Syntax: :PD Semantics: Insert the current system date in the format: DD-MMM-YYYY. This command has no effect on systems that do not maintain the current date. 7.4.2.53 :PL Load paste buffer Syntax: :PL<Delimiter><File name><Delimiter> Semantics: Insert the contents of the file given in <File name> in the paste buffer. This command is normally used in conjunction with the :PS command to preserve the contents of the paste buffer across multiple sessions. 7.4.2.54 :PR Print current buffer Syntax: :PR<Delimiter><File name><Delimiter> Semantics: Save the current buffer in the file given in <File name>. After every 61 lines of output and at the end of the file a form feed character is inserted. If any character is typed on the keyboard during the process the save will be terminated. 7.4.2.55 :PS Save paste buffer Syntax: :PS<Delimiter><File name><Delimiter> Semantics: Save the contents of the paste buffer in the file given in <File name>. This command is normally used in conjunction with :PL to preserve paste buffers across multiple edit sessions. 7.4.2.56 :PT Insert current time Syntax: :PT Semantics: Insert the current system time in the format: HH-MM-SS. This command has no effect on systems that do not maintain the current date. 7.4.2.57 :Q Quit Syntax: :Q Semantics: Terminate the Sedt session if no buffers contain modified text. If a buffer has been modified ask for confirmation and, if positive, terminate the session. ATARI GEM and Microsoft Windows versions will only close the current window. 7.4.2.58 :REP Replace Syntax: :REP Semantics: If the last command was @F or @N remove the occurrence found and insert it in the unknown delete buffer. Then insert the contents of the paste buffer. 7.4.2.59 :RF Refresh display Syntax: :RF Semantics: Clear and reinitialize the display and rewrite it. This command is used to recover from corruption of the display. 7.4.2.60 :RK Redefine key as character Syntax: <Count>:RK<Key> Semantics: Redefine the key given in <Key> to insert the character whose value is given in <Count>. <Key> is a code that identifies the class and value of the key. It consists of an alphabetic code that identifies the class followed by a three digit decimal number that defines the value. Valid classes are: A ASCII character. GA Gold ASCII character. F Function key. GF Gold function key. Key values: For ASCII characters the value is the ASCII value of the character. For function keys the value identifies the key as follows: 001 <F1> 002 <F2> 003 <F3> 004 <F4> 005 <F5> 006 <F6> 007 <F7> 008 <F8> 009 <F9> 010 <F10> 011 <F11> 012 <F12> 013 <F13> 014 <F14> 015 <F15> 016 <F16> 017 <F17> 018 <F18> 019 <F19> 020 <F20> 021 <Find> 022 <Insert Here> 023 <Remove> 024 <Select> 025 <Prev Screen> 026 <Next Screen> 027 <Up Arrow> 028 <Left Arrow> 029 <Down Arrow> 030 <Right Arrow> 031 <Keypad 0> 032 <Keypad 1> 033 <Keypad 2> 034 <Keypad 3> 035 <Keypad 4> 036 <Keypad 5> 037 <Keypad 6> 038 <Keypad 7> 039 <Keypad 8> 040 <Keypad 9> 041 <Keypad ,> 042 <Keypad -> 043 <Keypad .> 044 <Keypad PF1> 045 <Keypad PF2> 046 <Keypad PF3> 047 <Keypad PF4> 048 <Keypad Enter> 049 <Backspace> For scancode mapped keyboard layouts the values are: 000 Ctrl Break (*) 001 Alt Esc (*) 003 Null character 014 Alt Backspace (*) 015 Tab 016 Alt Q 017 Alt W 018 Alt E 019 Alt R 020 Alt T 021 Alt Y 022 Alt U 023 Alt I 024 Alt O 025 Alt P 026 Alt [ (*) 027 Alt ] (*) 028 Alt Ctrl (*) 030 Alt A 031 Alt S 032 Alt D 033 Alt F 034 Alt G 035 Alt H 036 Alt J 037 Alt K 038 Alt L 039 Alt ; (*) 040 Alt ' (*) 041 Alt ~ (*) 043 Alt \ (*) 044 Alt Z 045 Alt X 046 Alt C 047 Alt V 048 Alt B 049 Alt N 050 Alt M 051 Alt , (*) 052 Alt . (*) 053 Alt / (*) 055 Alt * (*) 059 F1 060 F2 061 F3 062 F4 063 F5 064 F6 065 F7 066 F8 067 F9 068 F10 071 Home 072 Up Arrow 073 Page Up 074 Alt Keypad - (*) 075 Left Arrow 076 Center Key (*) 077 Right Arrow 078 Alt Keypad + (*) 079 End 080 Down Arrow 081 Page Down 082 Insert 083 Delete 084 Uppercase F1 085 Uppercase F2 086 Uppercase F3 087 Uppercase F4 088 Uppercase F5 089 Uppercase F6 090 Uppercase F7 091 Uppercase F8 092 Uppercase F9 093 Uppercase F10 094 Control F1 095 Control F2 096 Control F3 097 Control F4 098 Control F5 099 Control F6 100 Control F7 101 Control F8 102 Control F9 103 Control F10 104 Alt F1 105 Alt F2 106 Alt F3 107 Alt F4 108 Alt F5 109 Alt F6 110 Alt F7 111 Alt F8 112 Alt F9 113 Alt F10 114 Control Print Screen 115 Control Left Arrow 116 Control Right Arrow 117 Control End (Erase to end of line) 118 Control Page Down 119 Control Home (Clear screen) 120 Alt 1 121 Alt 2 122 Alt 3 123 Alt 4 124 Alt 5 125 Alt 6 126 Alt 7 127 Alt 8 128 Alt 9 129 Alt 0 130 Alt - 131 Alt = 132 Control Page Up 133 F11 (*) 134 F12 (*) 135 Shift F11 (*) 136 Shift F12 (*) 137 Ctrl F11 (*) 138 Ctrl F12 (*) 139 Alt F11 (*) 140 Alt F12 (*) 141 Ctrl Up Arrow (*) 142 Ctrl Keypad - (*) 143 Ctrl Center (*) 144 Ctrl Keypad + (*) 145 Ctrl Down Arrow (*) 146 Ctrl Ins (*) 147 Ctrl Del (*) 148 Ctrl Tab (*) 149 Ctrl / (*) 150 Ctrl * (*) 151 Alt Home (*) 152 Alt Up (*) 153 Alt PageUp (*) 155 Alt Left (*) 157 Alt Right (*) 159 Alt End (*) 160 Alt Down (*) 161 Alt PageDown (*) 162 Alt Insert (*) 163 Alt Delete (*) 164 Alt / (*) 165 Alt Tab (*) 166 Alt Enter (*) (*) Enhanced keyboard 7.4.2.61 :RL Ruler Syntax: :RL Semantics: Switch into ruler definition mode. The cursor is placed on the first character on the ruler display in the second line of the screen. Commands that affect the ruler are: Right arrow Moves the cursor one character to the right. The column number can be read on the status line. Left arrow Moves the cursor one column to the left. - Removes a tab stop at the current position. Tab Moves to next tab stop ^H Moves to column 1 T Inserts a tab stop at the current position L Sets the left margin to the current position. When a Return is entered the cursor will be indented to the left margin. R Sets the right margin to the current position. If the right margin is reached when entering text, a new line will be entered before the word being typed and the word will be indented to the word wrap margin. J Sets the right margin to the current position. If the right margin is reached when entering text, a new line will be entered before the word being typed and the word will be indented to the word wrap margin after adjustment of the text to the right margin. W Sets the word wrap margin to the current position. W fixes the word wrap position. A Sets automatic margin control. The margin is always the leftmost non-blank position on the current line. I Sets the indentation at the current position. Space Removes all formatting controls at the current position. Digit Load saved ruler number digit. The rulers are saved in SEDT's master directory under MS-DOS and in the directory pointed to by the logical name SEDT$Dir under VMS. The name of the ruler file is RulerN.Txt where N is the number of the ruler. Gold Digit Save current ruler in saved ruler number digit. Return Returns from ruler definition mode to normal edit mode. If more than one ruler setting is commonly used, much time can be saved by storing the settings in rulers 0 through 9. Ruler 0 is loaded by default and any of the other rulers can be called up with four key strokes: Gold R Digit Return. The ruler line controls both left and right margins. Several options exist for controlling the margins. No margin control is done if L, W, R and I are set in column 1. Lines can be infinitely long and the cursor is always positioned in column 1 after a Return is typed. If L is set in a column different from 1 and W is set in column 1 a Return will cause SEDT to indent to the column defined by L. If I is set in a column different from 1 and the cursor is positioned to the left of the column a Tab will indent to the column defined by I. The left and right margin controls work as follows: W and R: When a non-blank character is typed to the right of R SEDT will insert a Return in front of the first word that extends to the right of R and indent to the W column. The effect will be that text will be filled between W and R. The fill command, Gold Keypad 8 will fill text from the current cursor position to the end of the current paragraph. Text to the left of W will be left unaffected. W and J: When a non-blank character is typed to the right of J SEDT will change the spacing between the current position and W so that spacing after punctuation characters will be exactly 2 and after non-punctuation characters will be 1. A return will then be inserted before the first word that extends to the right of J, after which spaces will be inserted between words until the right margin is justified to J. Finally the wrapped word will be indented to W. Text to the left of W will be left unaffected. A and R: When a non-blank character is inserted to the right of R a return will be inserted in front of the first word that extends to the right of R. The text after the return will be indented to the same level as the line just terminated. A and J: When a non-blank character is typed to the right of J SEDT will change the spacing between all words to the left of the current position so that spacing after punctuation characters will be exactly 2 and after non-punctuation characters will be 1. A return will then be inserted before the first word that extends to the right of J, after which spaces will be inserted between words until the right margin is justified to the same level as the line just terminated. W to the right of, or at J/R: No filling or justification will occur. A to the right of or at J/R: When a Return is typed the cursor will be indented to the same level as the line just terminated. If the terminated line is empty the indentation level will remain unchanged. This mode is particularly useful for structured programming. 7.4.2.62 :RMCHA Clear character delete buffer Syntax: :RMCHA Semantics: Clear the contents of the character delete buffer. 7.4.2.63 :RMHEL Clear help buffer Syntax: :RMHEL Semantics: Clear the contents of the help buffer. 7.4.2.64 :RMLIN Clear line delete buffer Syntax: :RMLIN Semantics: Clear the contents of the line delete buffer. 7.4.2.65 :RMPAG Clear page delete buffer Syntax: :RMPAG Semantics: Clear the contents of the page delete buffer. 7.4.2.66 :RMPAR Clear paragraph delete buffer Syntax: :RMPAR Semantics: Clear the contents of the paragraph delete buffer. 7.4.2.67 :RMPAS Clear paste buffer Syntax: :RMPAS Semantics: Clear the contents of the paste buffer. 7.4.2.68 :RMSEA Clear search buffer Syntax: :RMSEA Semantics: Clear the contents of the search buffer. 7.4.2.69 :RMSEN Clear sentence delete buffer Syntax: :RMSEN Semantics: Clear the contents of the sentence delete buffer. 7.4.2.70 :RMSUB Clear substitute buffer Syntax: :RMSUB Semantics: Clear the contents of the substitute buffer. 7.4.2.71 :RMUNK Clear unknown delete buffer Syntax: :RMUNK Semantics: Clear the contents of the unknown delete buffer. 7.4.2.72 :RMWOR Clear word delete buffer Syntax: :RMWOR Semantics: Clear the contents of the word delete buffer. 7.4.2.73 :RS Reset select range Syntax: :RS Semantics: Remove the select point and repaint the current window. 7.4.2.74 :RTAB Replace tabs with spaces Syntax: :RTAB<@ command> Semantics: Within the given entity replace all tab characters with multiple spaces. 7.4.2.75 :RUL Load ruler from entity Syntax: :RUL<@ command> Semantics: Interpret the text within the @ command as a ruler definition string in the same format as the ruler files. 7.4.2.76 :RUS Save ruler in buffer Syntax: :RUS Semantics: Write the contents of the ruler into the current buffer in the same format as a ruler definition file. 7.4.2.77 :SAVK Save key definitions in file Syntax: :SAVK<Delimiter><File name><Delimiter> Semantics: Saves the definitions of all defined keys (loaded at startup, defined later and learned) in the given file. The definitions are saved in the format for key definition files. 7.4.2.78 :SC Show current column Syntax: :SC Semantics: Display the column that the cursor is currently placed at on the bottom line of the display. 7.4.2.79 :SEL Select Syntax: :SEL Semantics: Set the select point to be the current cursor position. 7.4.2.80 :SETB Set block/line mode toggle Syntax: <Count>:SETB Semantics: Sets the value of the block/line mode toggle to the value of <Count>. A value of 0 sets line mode. 1 sets block mode. 7.4.2.81 :SETD Set direction toggle Syntax: <Count>:SETD Semantics: Sets the value of the direction toggle to the value of <Count>. A value of 0 sets it to reverse. 1 sets it to forward. 7.4.2.82 :SETR Set replace/insert toggle Syntax: <Count>:SETR Semantics: Sets the value of the replace/insert mode toggle to the value of <Count>. A value of 0 sets it to insert. 1 sets it to replace. 7.4.2.83 :SETT Set tab insert/expand toggle Syntax: <Count>:SETT Semantics: Sets the value of the tab insert/expand toggle to the value of <Count>. A value of 0 sets it to inserted. 1 sets it to expand. 7.4.2.84 :SK Save key definition Syntax: :SK<Key> Semantics: Insert the definition of <Key> in the current buffer. For valid codes for <Key> see :K. This command is used in conjunction with :LK to edit key definitions. 7.4.2.85 :SL Load search buffer Syntax: :SL<@ command> Semantics: Copy the contents of the buffer between the cursor position and the position defined by the @ command into the search buffer. The search buffer is used by the @F, @N and :SUB commands. 7.4.2.86 :STAB Replace multiple spaces with tabs Syntax: :STAB<@ command> Semantics: Replace multiple spaces within the given entity with tab characters where possible. 7.4.2.87 :STRP Strip trailing spaces Syntax: :STRP<@ command> Semantics: Strip all trailing space and tab characters within the given entity. Trailing spaces are those after the last printable character on the line. 7.4.2.88 :SUB Substitute Syntax: {+|-|<|>}{<Count>}:SUB<Delimiter><Target><Delimiter><Object><Delimiter> Semantics: Find the next occurrence of <Target> in the current direction and replace it with <Object>. If the cursor is placed on the first character of <Target> and the direction is forward make the substitution. If <Target> is empty use the current search string, set by @F or :SL. If <Object> is empty use the current substitute string. If Target is non-empty insert it in the current search string. If <Object> in non-empty insert it in the current substitute string. If the direction is forward, place the cursor at the end if the inserted string, end if it is backward place the cursor at the beginning. The search is case insensitive. 7.4.2.89 :SV Show Version Syntax: :SV Semantics: Show the version number of Sedt on the message line. 7.4.2.90 :SYQ Spawn with no output Syntax: :SYQ<Delimiter><Command><Delimiter> Semantics: The :SYQ is the same as the :SYS command with the exception that it does not clear the screen and refresh it after the spawn. This command is used to execute programs that accept no input and provide no output. 7.4.2.91 :SYR Swawn with redirected output Syntax: :SYR<Delimiter><New stdout><Delimiter><New stderr> <Delimiter><Command><Delimiter> Semantics: The :SYR command is similar to the :SYQ command, but redirects standard outout and error output for the child process to the given file names. 7.4.2.92 :SYS Spawn to operating system Syntax: :SYS<Delimiter><Command><Delimiter> Semantics: Execute <Command> and a command to the operating system. Before the command is executed the screen is cleared and the modes reset to the default modes. If <Command> is empty call the command processor. On return prompt for input of a single keystroke if <Command> was non-empty. Then refresh the display. On MS-DOS systems COMSPEC is used to locate the command interpreter which is spawned when the argument to :SYS is empty. SEDT uses free memory to contain buffers and other working areas. Whether enough memory is available to actually perform the :SYS command depends on the largest memory requirement that SEDT has had during the session. It is not possible to return memory once it has been claimed and used by SEDT. 7.4.2.93 :TAB Move to next tab stop Syntax: {<Count>}:TAB Semantics: If the current indentation level is to the right of the cursor insert tab and space characters until the cursor is placed at the indentation level. Otherwise insert tab and space characters until the cursor is at the next tab stop. If no tab stops are to the right of the cursor do nothing. Only space characters will be inserted if the current tab expansion mode is to expand tabs. The tab expansion is changed with the :TT command and displayed on the mode line of the display. In overstrike mode :TAB will space over any characters already on the line. 7.4.2.94 :TAD Adjust text by one tab stop Syntax: {+|-|<|>}{<Count>}:TAD<@ command> Semantics: Move all lines fully contained between the current cursor position and the position defined by the @ command <Count> tab stops left if the current direction is backward or right if the current direction is forward. Left adjustment is not performed further than to the first non space or tab character. 7.4.2.95 :TB Toggle Block Mode Syntax: :TB Semantics: Toggle between block and line cut and paste. In line mode (shown by line on the mode line), the select region is all characters between the cursor and the select point. Cut operations will remove the entire select region. Paste operations will insert the entire paste region at the cursor position. In block mode a cut operation will remove all characters that are within the rectangle delimited by the cursor and the select point. A paste operation will insert the paste buffer, line by line in the buffer starting at the cursor position and at the cursor column, thus inserting a rectangle of text into the buffer. The select region will only have the column at the select point shown in reverse video. 7.4.2.96 :TC Toggle Control Character Display Syntax: :TC Semantics: Toggles between display of control characters as single reverse video characters with control C shown as a reverse video C, or as strings in the format <name> when name is the ASCII mnemonic for the character. 7.4.2.97 :TD Toggle Direction Syntax: :TD Semantics: Toggle the direction flag shown on the mode line. Most cursor movement commands work in the direction shown by the direction flag. 7.4.2.98 :TF Fill Syntax: :TF<@ command> Semantics: Fill or justify all text between the current cursor position and the point defined by the @ command. If the ruler contains an R to the right of column 1 the text will be filled (jagged right margin). If it contains a J to the right of column 1 the text will be justified (straight right margin). The left margin is defined by the position of either A or W in the ruler. To justify text SEDT packs the text as closely as possible with single spaces between words except after punctuation, where two spaces are used. It then inserts extra spaces until the text lines up with the right margin. 7.4.2.99 :TI Test for input Syntax: :TI Semantics: Set SEDT's internal error flag if the internal type-ahead buffer contains any characters. This command is used to terminate a command loop by typing a character. 7.4.2.100 :TM Toggle buffer markers Syntax: :TM Semantics: Toggle between showing the beginning and end of buffers with bold, reverse video BOF and EOF markers. Default is not to show the markers. 7.4.2.101 :TP Toggle Cursor Line Syntax: :TP Semantics: Toggles between full screen display where the cursor line will float within the display window to minimize screen updates, and mid-line editing where the cursor is always on the center line of the window. 7.4.2.102 :TR Toggle ruler display Syntax: :TP Semantics: Toggles display of the current ruler at the top of the window. 7.4.2.103 :TS Toggle automatic screen shifts Syntax: :TS Semantics: Toggle shifting the screen image horizontally to keep the current cursor position within the screen margins. When screen shifting is toggled off the leftmost column on the screen will always correspond to the leftmost column in the file. The current state of the toggle is shown on the mode line of the display. 7.4.2.104 :TT Toggle tab expansion Syntax: :TT Semantics: Toggle between inserting tab characters in the buffer and expanding them into space characters. The current state of the toggle is displayed on the mode line of the display. 7.4.2.105 :UC Undelete character Syntax: {<Count>}:UC Semantics: Insert the contents of the character undelete buffer at the current cursor position. 7.4.2.106 :UL Undelete line Syntax: {<Count>}:UL Semantics: Insert the contents of the line delete buffer at the current cursor position. 7.4.2.107 :UM Undo last command Syntax: :UM Semantics: Attempt to negate the effect of the last command. Commands for which :UM has been implemented are: All @ commands. :SUB :D Attempting to undo any other command will cause an error do be displayed. 7.4.2.108 :UOFF Turn off screen updates Syntax: :UOFF Semantics: Prevents screen updating until a :UON, :WC, :WI or :RL command is executed. This command is used to prevent excessive screen updating processes with complex command sequences; 7.4.2.109 :UON Turn on screen updates Syntax: :UON Semantics: Restores screen updating and repaint the screen to reflect any changes made while updates were turned off. 7.4.2.110 :UPAG Undelete page Syntax: {<Count>}:UPAG Semantics: Insert the contents of the page delete buffer at the current cursor position. 7.4.2.111 :UPAR Undelete paragraph Syntax: {<Count>}:UPAR Semantics: Insert the contents of the paragraph delete buffer at the current cursor position. 7.4.2.112 :UPD Update screen header Syntax: :UPD Semantics: Update the first line of the display. This is normally done only when SEDT is ready for input and there are no characters in the type-ahead buffer. 7.4.2.113 :USEN Undelete sentence Syntax: {<Count>}:USEN Semantics: Insert the contents of the sentence delete buffer at the current cursor position. 7.4.2.114 :USR Paste Syntax: {<Count>}:USR Semantics: Insert the contents of the paste buffer at the current cursor position. 7.4.2.115 :UU Undelete unknown Syntax: {<Count>}:UU Semantics: Insert the contents of the unknown delete buffer at the current cursor position. 7.4.2.116 :UW Undelete word Syntax: {<Count>}:UW Semantics: Insert the contents of the word delete buffer at the current cursor position. 7.4.2.117 :WC Toggle windows Syntax: :WC Semantics: Toggle between one and two window displays. The bottom window will be empty if :WC is used before :WI is used. If :WI has been used the two window display will show the buffer selected as the current buffer before the last :WI command was executed. 7.4.2.118 :WD Toggle width Syntax: :WD Semantics: Toggle between 80 and 132 column display formats. This command has no effect on systems that cannot support 132 character displays. 7.4.2.119 :WI Select buffer Syntax: <Count>:WI Semantics: Select the buffer given in <Count> as the current buffer. Valid buffers are 1 through 4. Each buffer has a unique edit environment including: Input file Output file Current position Ruler Marks Select point 7.4.2.120 :X Exit Syntax: :X Semantics: Save the current buffer in it's output file. Then exit unless other buffers contain unsaved changes. If unsaved changes exist prompt the user for confirmation before exiting. 7.4.2.121 :YN Prompt for Confirmation Syntax: :YN<Delimiter><String><Delimiter> Semantics: Display the string on the bottom line of the display with the string <Y/N>: appended and wait for the user to enter either a Y or an N from the keyboard. If the response is Y the error flag will be set, otherwise it will be cleared. :YN is used in conjunction with ^E conditional execution. For example ^E(:YN/Question?/)(:OM/Yes/|:OM/No/) will output a Yes if Y is typed in reponse. 7.4.2.122 :Z Zap buffer Syntax: :Z Semantics: Clear the current buffer. If unsaved changes have been made prompt the user for confirmation before clearing. Copyright (c) Anker Berg-Sonne, 1985,1986,1987,1988 Sedt Version 3.3 Appendix A Keyboard translation Key LK201/LK250 <Escape> <Backspace> <Return> <Return> <Linefeed> <Delete> <<X> <Control> <Ctl> <Tab> <Tab> <Space> <Spacebar> <F1> <F1> <F2> <F2> <F3> <F3> <F4> <F4> <F5> <F5> <F6> <F6> <F7> <F7> <F8> <F8> <F9> <F9> <F10> <F10> <F11> <F11> <F12> <F12> <F13> <F13> <F14> <F14> <Help> <Help> <Do> <Do> <F17> <F17> <F18> <F18> <F19> <F19> <F20> <F20> <Find> <Find> <Insert Here> <Insert Here> <Remove> <Remove> <Select> <Select> <Prev Screen> <Prev Screen> <Next Screen> <Next Screen> <Up arrow> <Up Arrow> <Left arrow> <Left Arrow> <Down arrow> <Down Arrow> <Right arrow> <Right Arrow> <Keypad 0> <Keypad 0> <Keypad 1> <Keypad 1> <Keypad 2> <Keypad 2> <Keypad 3> <Keypad 3> <Keypad 4> <Keypad 4> <Keypad 5> <Keypad 5> <Keypad 6> <Keypad 6> <Keypad 7> <Keypad 7> <Keypad 8> <Keypad 8> <Keypad 9> <Keypad 9> <Keypad ,> <Keypad ,> <Keypad -> <Keypad -> <Keypad .> <Keypad .> <Gold> <Keypad PF1> <PF2> <Keypad PF2> <PF3> <Keypad PF3> <PF4> <Keypad PF4> <Keypad Enter> <Keypad Enter> Key IBM PC IBM PC/AT Enhanced IBM <Escape> <Backspace> <Return> <Enter> <Enter> <Enter> <Linefeed> <Delete> <<-> <<-> <Backspace> <Control> <Ctrl> <Ctrl> <Ctrl> <Tab> <->|> <->|> <Tab> <Space> <Spacebar> <Spacebar> <Spacebar> <F1> <F1> <F1> <F1> <F2> <F2> <F2> <F2> <F3> <F3> <F3> <F3> <F4> <F4> <F4> <F4> <F5> <F5> <F5> <F5> <F6> <F6> <F6> <F6> <F7> <F7> <F7> <F7> <F8> <F8> <F8> <F8> <F9> <F9> <F9> <F9> <F10> <F10> <F10> <F10> <F11> <Shift> <F1> <Shift> <F1> <F11> <F12> <Shift> <F2> <Shift> <F2> <F12> <F13> <Shift> <F3> <Shift> <F3> <Shift> <F3> <F14> <Shift> <F4> <Shift> <F4> <Shift> <F4> <Help> <Shift> <F5> <Shift> <F5> <Shift> <F5> <Do> <Shift> <F6> <Shift> <F6> <Shift> <F6> <F17> <Shift> <F7> <Shift> <F7> <Shift> <F7> <F18> <Shift> <F8> <Shift> <F8> <Shift> <F8> <F19> <Shift> <F9> <Shift> <F9> <Shift> <F9> <F20> <Shift> <F10> <Shift> <F10> <Shift> <F10> <Find> <Shift> <Home> <Shift> <Home> <Home> <Insert Here> <Shift> <Ins> <Shift> <Ins> <Insert> <Remove> <Shift> <Del> <Shift> <Del> <Delete> <Select> <Shift> <End> <Shift> <End> <End> <Prev Screen> <Shift> <Pg Up> <Shift> <Pg Up> <Page Up> <Next Screen> <Shift> <Pg Dn> <Shift> <Pg Dn> <Page Down> <Up arrow> <Shift> <Up Arrow> <Shift> <Up Arrow> <Up Arrow> <Left arrow> <Shift> <Left Arrow> <Shift> <Left Arrow> <Left Arrow> <Down arrow> <Shift> <Down Arrow> <Shift> <Down Arrow> <Down Arrow> <Right arrow> <Shift> <Right Arrow> <Shift> <Right Arrow> <Right Arrow> <Keypad 0> <Keypad 0> <Keypad 0> <Keypad 0> <Keypad 1> <Keypad 1> <Keypad 1> <Keypad 1> <Keypad 2> <Keypad 2> <Keypad 2> <Keypad 2> <Keypad 3> <Keypad 3> <Keypad 3> <Keypad 3> <Keypad 4> <Keypad 4> <Keypad 4> <Keypad 4> <Keypad 5> <Keypad 5> <Keypad 5> <Keypad 5> <Keypad 6> <Keypad 6> <Keypad 6> <Keypad 6> <Keypad 7> <Keypad 7> <Keypad 7> <Keypad 7> <Keypad 8> <Keypad 8> <Keypad 8> <Keypad 8> <Keypad 9> <Keypad 9> <Keypad 9> <Keypad 9> <Keypad ,> <Shift> <Keypad -> <Keypad -> <Keypad +> <Keypad -> <Keypad -> <Prt Sc> <Shift> <Keypad +> <Keypad .> <Keypad .> <Keypad .> <Keypad .> <Gold> <Esc>,<Num Lock><Esc> <Esc>,<Num Lock> <PF2> <Shift> <Num Lock> <Num Lock> <Keypad /> <PF3> <Scroll Lock> <Scroll Lock> <Keypad *> <PF4> <Shift> <Scroll Lock> <Sys Req> <Keypad -> <Keypad Enter> <Keypad +> <Keypad +> <Keypad Enter> Key IBM Convert. ATARI ST <Escape> <Backspace> <Backspace> <Return> <Enter> <Return> <Linefeed> <Delete> <Bksp> <Delete> <Control> <Ctrl> <Control> <Tab> <->|> <Tab> <Space> <Spacebar> <Spacebar> <F1> <F1> <F1> <F2> <F2> <F2> <F3> <F3> <F3> <F4> <F4> <F4> <F5> <F5> <F5> <F6> <F6> <F6> <F7> <F7> <F7> <F8> <F8> <F8> <F9> <F9> <F9> <F10> <F10> <F10> <F11> <Shift> <F1> <Shift> <F1> <F12> <Shift> <F2> <Shift> <F2> <F13> <Shift> <F3> <Shift> <F3> <F14> <Shift> <F4> <Shift> <F4> <Help> <Shift> <F5> <Shift> <F5> <Do> <Shift> <F6> <Shift> <F6> <F17> <Shift> <F7> <Shift> <F7> <F18> <Shift> <F8> <Shift> <F8> <F19> <Shift> <F9> <Shift> <F9> <F20> <Shift> <F10> <Shift> <F10> <Find> <Fn> <Home> <Shift> <Clr Home> <Insert Here> <Ins> <Insert> <Remove> <Del> <Clr Home> <Select> <Fn> <End> <Shift> <Insert> <Prev Screen> <Fn> <PgUp> <Shift> <Up Arrow> <Next Screen> <Fn> <PgDn> <Shift> <Down Arrow> <Up arrow> <Up Arrow> <Up Arrow> <Left arrow> <Left Arrow> <Left Arrow> <Down arrow> <Down Arrow> <Down Arrow> <Right arrow> <Right Arrow> <Right Arrow> <Keypad 0> <Fn> <Keypad 0> <Keypad 0> <Keypad 1> <Fn> <Keypad 1> <Keypad 1> <Keypad 2> <Fn> <Keypad 2> <Keypad 2> <Keypad 3> <Fn> <Keypad 3> <Keypad 3> <Keypad 4> <Fn> <Keypad 4> <Keypad 4> <Keypad 5> <Fn> <Keypad 5> <Keypad 5> <Keypad 6> <Fn> <Keypad 6> <Keypad 6> <Keypad 7> <Fn> <Keypad 7> <Keypad 7> <Keypad 8> <Fn> <Keypad 8> <Keypad 8> <Keypad 9> <Fn> <Keypad 9> <Keypad 9> <Keypad ,> <Fn> <Keypad *> <Keypad +> <Keypad -> <Fn> <Keypad /> <Keypad -> <Keypad .> <Fn> <Keypad .> <Keypad .> <Gold> <Num Lock> <Esc>,<Keypad (> <PF2> <Scroll Lock> <Keypad )> <PF3> <Fn> <Keypad -> <Keypad /> <PF4> <Fn> <Keypad +> <Keypad *> <Keypad Enter> <Keypad Enter> Copyright (c) Anker Berg-Sonne, 1985,1986,1987,1988 Sedt Version 3.3 Appendix B Installation ATARI ST Your first action should be to make backup copies of the Sedt disks. Use the backup copies from now on and only use the Sedt disks to create new backup copies. You can either use the backup copy to run Sedt from or copy it's contents onto another disk or into a folder. When you run Sedt from the ATARI GEM desktop you should run it from the directory containing all of the files. Under ATARI GEM this is done simply by opening a window to the directory and double clicking the program. If you intend to run Sedt from a shell processor, such as the Mark Williams msh, you can install Sedt so that it can be called from any directory without copying the files. Install the directory that contains SEDT.TTP into the PATH environment variable and also create a new environment variable, called SEDT, that points to the directory containing STKEY.TXT and STHLP.TXT. The command "setenv SEDT=C:\SEDT\" will cause Sedt to pick the files out of directory \SEDT on drive C. Do not forget the last backslash! When Sedt cannot use more RAM memory it will overflow onto a temporary disk file. If you have defined the environment variable TEMP Sedt will use the value if it to determine the drive and directory on which to place the temporary file. The command "setenv TEMP=D:\" will place the temporary file in the root directory of drive D. The program SEDT.TTP is intended to be run from a shell processor. You can run it from ATARI GEM and supply arguments, but it will not use windows, the mouse or menus. GSEDT.PRG is intended to be run from the ATARI GEM desktop and uses windows, mouse and menus. Sedt Version 3.3 Appendix B Installation Rainbow CP/M Your first action should be to make a backup copy of the Sedt disk. Use the backup copy from now on and only use the Sedt disk to create a new backup copy. Copy the contents of the Sedt disk onto your system disk in user area 0. When you use Sedt you must have the system disk as your default disk. Sedt Version 3.3 Appendix B Installation Instructions MS-DOS Rainbow, IBM PC, IBM PC/XT, IBM PC/AT With Hard Disk Your first action should be to make a backup copy of the Sedt disk. Use the backup copy from now on and only use the Sedt disk to create a new backup copy. Create a directory for the SEDT files using the DOS MD command in the format "CD <drive>:\<directory>". E.g. MD C:\SEDT In this example C is the name of the drive and SEDT the name of the directory that is being created. Ensure that the directory you just created is your default directory with the DOS CD command in the format "CD \<directory>". E.g. C: CD \SEDT Copy the all files from the backup disk into the current directory. E.g. COPY A:*.* If you are familiar with Sedt you can use it for the next two steps. Add the directory that contains the SEDT files to the PATH command in AUTOEXEC.BAT on your boot drive in the format ";\<directory>". If there is no PATH command in AUTOEXEC.BAT create one that contains the root directory on your boot drive and the SEDT directory. E.g. PATH C:\;C:\SEDT Add a command to create an environment variable called SEDT that points to the directory containing the SEDT files to AUTOEXEC.BAT on your boot drive. E.g. SET SEDT=C:\SEDT\ An example of a complete installation follows: A>C: C>MD \SEDT C>CD \SEDT C>COPY A:*.* CD \ COPY CON: AUTOEXEC.BAT DATE TIME PATH C:\;C:\SEDT SET SEDT=C:\SEDT\^Z C> Using this installation procedure you can run Sedt from any disk or directory. When Sedt cannot use more RAM memory it will overflow onto a temporary disk file. If you have defined the environment variable TEMP Sedt will use the value if it to determine the drive and directory on which to place the temporary file. The command "SET TEMP=D:\" will place the temporary file in the root directory of drive D. Sedt Version 3.3 Appendix B Installation Rainbow, IBM PC, IBM PC/XT, IBM PC/AT Without Hard Disk Your first action should be to make a backup copy of the Sedt disk. Use the backup copy from now on and only use the Sedt disk to create a new backup copy. When you use Sedt the default drive must be the drive with the Sedt backup disk in it. Sedt Version 3.3 Appendix B Installation Instructions VMS Copy Sedt.Exe, Sedt.Com, *.Edt and *.Gld to a directory. Define the logical name Sedt$Library to point to the directory, the symbol Se*dt:==$Sedt$Library:Sedt and KSe*dt:==@Sedt$Library:Sedt. You do not need write access to Sedt$Library. Define the logical names Sedt$VT1XXkeys as Sedt$Library:VT1XXkeys.Edt Sedt$VT1XXhelp as Sedt$Library:VT1XXhelp.Edt Sedt$VT2XXkeys as Sedt$Library:VT2XXkeys.Edt Sedt$VT2XXhelp as Sedt$Library:VT2XXhelp.Edt Sedt$VK100keys as Sedt$Library:VK100keys.Edt Sedt$VK100help as Sedt$Library:VK100help.Edt Define the logical name Sedt$Dir to point to a directory which you have write access to. Saved rulers will be stored in this directory. Until you have saved ruler 0 in this directory you will get the message "Could not find ruler file" every time you enter Sedt. Enter ruler mode, define your default ruler settings and save them by typing Gold 0. Example: Assign Sys$Disk:[Mydir] Sedt$Library Assign Sys$Disk:[Mydir] Sedt$Dir Se*dt:==$Sedt$Library:Sedt Assign Sedt$Library:VT1XXkeys.Edt Sedt$VT1XXkeys Assign Sedt$Library:VT1XXhelp.Edt Sedt$VT1XXhelp Assign Sedt$Library:VT2XXkeys.Edt Sedt$VT2XXkeys Assign Sedt$Library:VT2XXhelp.Edt Sedt$VT2XXhelp Assign Sedt$Library:VK100keys.Edt Sedt$VK100keys Assign Sedt$Library:VK100help.Edt Sedt$VK100help Using this installation procedure you can run Sedt from any disk or directory. Sedt Version 3.3 Appendix C Error Messages Error messages fall into four classes: Fatal error messages that cause Sedt to abort execution, and three levels of non-fatal errors. Fatal errors cause Sedt to abort the edit session. Any journal files are closed and saved so that when you have corrected the error condition you will be able to recommence the edit session and recover up to the point of failure. Fatal errors: Attempt to get before beginning Internal Sedt error. This is caused by a bug in Sedt. Please report the failure and supply a copy of the data file and associated journal file. Could not open key definition file Sedt could not fin the key definition file due to improper installation or improper operation of Sedt . Error creating buffer file Sedt was unable to create a temporary file on disk due to a lack of disk space available. Correct the situation and restart the edit session for a recovery. Error reading data from buffer Internal Sedt error. This is caused by a bug in Sedt. Please report the failure and supply a copy of the data file and associated journal file. Error writing data from buffer Sedt was unable to write to a temporary file on disk due to a lack of disk space available. Correct the situation and restart the edit session for a recovery. More files than buffers You attempted to call Sedt with a command that requested editing more than 4 different files. Too many file arguments For each buffer you can only request an input and an output file. You supplied more than two file arguments to the buffer. Other errors are non-fatal and can optionally ring the bell to get your attention. This is done with the :EL command.