Copyright (c) Anker Berg-Sonne, 1985,1986,1987,1988 Sedt Version 3.3 (233) 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 -a 2.2.2 -p 2.2.3 -l 2.2.4 -j 2.2.5 -e 2.2.6 -f 2.2.7 -b 2.2.8 -r 2.2.9 -pc 2.2.10 -xt 2.2.11 -at 2.2.12 -rb 2.2.13 -mo 2.2.14 -co 2.2.15 - 2.2.16 -k 2.2.17 -s 2.2.18 -ega 2.2.19 -v 2.2.20 -edt 2.2.21 -wps 2.2.22 -scn 2.2.23 -i 2.2.24 -wi 2.3 Sedt's Data Files 2.3.1 Configuration File 2.3.1.1 AUTOSAVE 2.3.1.2 BACKUPFILE 2.3.1.3 COLUMN 2.3.1.4 CONTEXT 2.3.1.5 CONTROLZ 2.3.1.6 CURSORLINE 2.3.1.7 EGA43 2.3.1.8 FIRMWARE 2.3.1.9 FONTSIZE 2.3.1.10 GOLD 2.3.1.11 JOURNALING 2.3.1.12 KEYBOARD 2.3.1.13 MAPPING 2.3.1.14 MAXSCROLL 2.3.1.15 MODE 2.3.1.16 MOUSE 2.3.1.17 NUMLOCK 2.3.1.18 PALETTE 2.3.2.17 REMEMBER 2.3.1.19 RETURN 2.3.1.20 RULER 2.3.1.21 SCREEN 2.3.1.22 SCREENSHIFT 2.3.1.23 SYSTEM 2.3.1.24 TAB 2.3.1.25 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 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 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 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 :CK Checkpoint buffer 7.4.2.9 :CL Center Line 7.4.2.10 :CM Cursor at Middle 7.4.2.11 :CNA Add number to counter 7.4.2.12 :CNG Get counter from buffer 7.4.2.13 :CNI Increment or decrement counter 7.4.2.14 :CNP Insert value of counter in buffer 7.4.2.15 :CNS Set counter value 7.4.2.16 :CS Save buffer context 7.4.2.17 :CT Cursor at Top 7.4.2.18 :CU Change to Upper Case 7.4.2.19 :D Delete 7.4.2.20 :EAP Delete and Append 7.4.2.21 :EK Execute key 7.4.2.22 :EL Set error level 7.4.2.23 :ERC Clear edit region 7.4.2.24 :ERS Set edit region 7.4.2.25 :FE Edit File 7.4.2.26 :FG Get File 7.4.2.27 :FNL Larger Font 7.4.2.28 :FNS Smaller Font 7.4.2.29 :FS Save File 7.4.2.30 :FW Write File 7.4.2.31 :FX Execute File 7.4.2.32 :GAP Get and append 7.4.2.33 :GE Get 7.4.2.34 :GR Get ruler 7.4.2.35 :H Help 7.4.2.36 :I Insert 7.4.2.37 :K Define key 7.4.2.38 :LD Decrease indentation 7.4.2.39 :LI Increase indentation 7.4.2.40 :LK Load key definition 7.4.2.41 :LNE Execute keystrokes stored in key 7.4.2.42 :LNL Store keystrokes in key 7.4.2.43 :LNX End learning 7.4.2.44 :LS Set indentation level 7.4.2.45 :M Mark cursor position 7.4.2.46 :NL New line 7.4.2.47 :NS Substitute next 7.4.2.48 :OE Output error message 7.4.2.49 :OL Open line 7.4.2.50 :OM Output message 7.4.2.51 :OS Toggle overstrike mode 7.4.2.52 :OW Switch to previous buffer 7.4.2.53 :PD Insert current date 7.4.2.54 :PL Load paste buffer 7.4.2.55 :PR Print current buffer 7.4.2.56 :PS Save paste buffer 7.4.2.57 :PT Insert current time 7.4.2.58 :Q Quit 7.4.2.59 :REP Replace 7.4.2.60 :RF Refresh display 7.4.2.61 :RK Refefine key as character 7.4.2.62 :RL Ruler 7.4.2.63 :RMCHA Clear character delete buffer 7.4.2.64 :RMHEL Clear help buffer 7.4.2.65 :RMLIN Clear line delete buffer 7.4.2.66 :RMPAG Clear page delete buffer 7.4.2.67 :RMPAR Clear paragraph delete buffer 7.4.2.68 :RMPAS Clear paste buffer 7.4.2.69 :RMSEA Clear search buffer 7.4.2.70 :RMSEN Clear sentence delete buffer 7.4.2.71 :RMSUB Clear substitute buffer 7.4.2.72 :RMUNK Clear unknown delete buffer 7.4.2.73 :RMWOR Clear word delete buffer 7.4.2.74 :RS Reset select range 7.4.2.75 :RTAB Replace tabs with spaces 7.4.2.76 :RUL Load ruler from entity 7.4.2.77 :RUS Save ruler in buffer 7.4.2.78 :SAVK Save key definitions in a file 7.4.2.79 :SC Show current column 7.4.2.80 :SEL Select 7.4.2.81 :SETB Set block/line mode toggle 7.4.2.82 :SETD Set direction toggle 7.4.2.83 :SETR Set replace/insert toggle 7.4.2.84 :SETT Set tab insert/expand toggle 7.4.2.85 :SK Save key definition 7.4.2.86 :SL Load search buffer 7.4.2.87 :STAB Replace multiple spaces with tabs 7.4.2.88 :STRP Strip trailing spaces 7.4.2.89 :SUB Substitute 7.4.2.90 :SV Show Version 7.4.2.91 :SYQ Spawn with no output 7.4.2.92 :SYR Spawn with redirected output 7.4.2.93 :SYS Spawn to operating system 7.4.2.94 :TAB Move to next tab stop 7.4.2.95 :TAD Adjust text by one tab stop 7.4.2.96 :TB Toggle Block Mode 7.4.2.97 :TC Toggle Control Character Display 7.4.2.98 :TD Toggle Direction 7.4.2.99 :TF Fill 7.4.2.100 :TI Test for input 7.4.2.101 :TM Toggle buffer markers 7.4.2.102 :TP Toggle Cursor Line 7.4.2.103 :TR Toggle ruler display 7.4.2.104 :TS Toggle automatic screen shifts 7.4.2.105 :TT Toggle tab expansion 7.4.2.106 :UC Undelete character 7.4.2.107 :UL Undelete line 7.4.2.108 :UM Undo last command 7.4.2.109 :UOFF Turn off screen updating 7.4.2.110 :UON Turn on screen updating 7.4.2.111 :UPAG Undelete page 7.4.2.112 :UPAR Undelete paragraph 7.4.2.113 :UPD Update screen header 7.4.2.114 :USEN Undelete sentence 7.4.2.115 :USR Paste 7.4.2.116 :UU Undelete unknown 7.4.2.117 :UW Undelete word 7.4.2.118 :WC Toggle windows 7.4.2.119 :WD Toggle width 7.4.2.120 :WI Select buffer 7.4.2.121 :X Exit 7.4.2.122 :YN Prompt for confirmation 7.4.2.123 :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 (233) 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 . 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 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 is entered by typing the key first, then releasing it and typing . A sequence described as is typed by holding down the key while is typed. The 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 (233) Tutorial 1.0 Getting Started To start editing a file with Sedt you type the command "Sedt " 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 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 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 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. moves the cursor straight down. Just as with 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 . You can enter an arbitrary ASCII character by typing , then the decimal value of the character on the normal typewriter keyboard and then and finally . 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 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: and the F key. If you decide not to keep the changes you can type 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 file you are editing. These saves are only done if you have made changes to the file. 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 (233) 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 { {}} {