home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.update.uu.se
/
ftp.update.uu.se.2014.03.zip
/
ftp.update.uu.se
/
pub
/
rainbow
/
msdos
/
misc
/
sedt.lzh
/
SEDTMAN.TXT
< prev
Wrap
Text File
|
1985-03-24
|
29KB
|
768 lines
Sedt Users Guide
Screen EDiTor Version 1.1
Sedt is an interactive "what you see is what you get" editor for
VAX/VMS and the Rainbow 100 under MS-DOS V2.05 or higher. Sedt is very
compatible with EDT for VAX, PDP-11 and DEC-20, the world's most popular
screen editor. The keyboard layout for Sedt is very similar to EDT's,
and may be reprogrammed by the user.
Sedt supports multiple edit buffers with up to two windows into
the buffers.
Getting Started
Sedt is called with the command line:
SEDT {<Input File>} {<Output File>} {-<Line Number>}
<Input File> and <Output File> are optional file names.
If only one file name is given, it will be assigned to
both the input and output files. Sedt will read the input
file into buffer number 0 and set the default output for
buffer number 0 to the output file.
<Line Number> is an optional line number which Sedt will
position the cursor at after loading the input file.
The initialization sequence for Sedt is as follows:
On non-PC versions determine the terminal type.
Load the input file and display the file on the
screen.
Load a key definition file (MS-DOS: Sedtkeys.Txt.
VMS: Sedt$Keys:). Sedt will abort if it cannot
find the key definition file.
Load default ruler file (MS-DOS: Ruler0.Txt. VMS:
Sys$Login:Ruler0.Txt). If no default ruler file
is found, Sedt will set up a standard ruler with
tab stops at every 8 columns and margins at
column 1 and column 80.
If the user has supplied an optional starting
line number in the command line, Sedt will
position the cursor at the command line.
Look for an initialization file on disk (MS-DOS:
Sedtcom.Txt. VMS: Sedt$Commands:). If the
initialization file is found Sedt will read all
the input in the file and execute them as basic
Sedt commands.
Look for a journal file with the same name as the
input file except for the file extention .JOU.
If the journal file is present Sedt will read all
characters in the journal file as if they had
been typed on the keyboard. Sedt will create
journal files for all files edited and remove the
journal files when the file is written to disk or
the user quits the edit session. Journal files
will not recreate the correct file if you have
moved data between windows.
Screen layout
The Sedt screen is divided into a number of fields. It can
display either one or two windows into your edit buffers. In single
window mode the layout is as follows:
The top line on the screen (in reverse video) is a status line.
It shows you the contents and status of your current buffer.
The first character on the status line indicates
whether there have been changes to the file in the
current edit buffer. An * indicates that changes have
been made, a space that the file is unchanged.
The second field indicates what the output file for the
current buffer is. The contents of the buffer is
initially the disk contents of the input file.
The third field tells you what the default direction
is, either forward or reverse.
The fourth field (Line=<Number>) tells you what line
number in the buffer Sedt is positioned at.
The final field (Buf=<Number>) tells you the number of
the current buffer.
The second line is the ruler line. It shows the
current settings of left and right margins, the word
wrap margin and the tab stop settings. L is the
position of the left margin, W the position of the
word wrap margin, R the position of the right margin,
I the current indentation setting, and T tab stop
settings. If a position marks several of the above it
will only show one. The order of precedence is L over
W over I over T.
The next 20 lines are in normal video and display a
window into the current buffer. All text is shown
exactly as it is and how will be written to the file.
The cursor is always on line 12 and shows the current
position within the buffer. If the select point is
within the current window the character in that
position will be shown in reverse video.
The 23'd, or second line from the bottom, is in reverse
video and separates the text from the message line.
The 24'th, or bottom line, is the message line. It is
used to display informational and error messages, and
also for accepting command arguments.
In two window mode a second status line is added on
line 14. It has the same format as line 1 and shows
the status of the buffer displayed in lines 15 through
22. The current buffer is displayed in lines 3
through 13. The Cursor position is always on line 8.
Typing text
Text is entered at the cursor position by typing the desired
data. Text keys are all the printable ASCII characters plus Return and
Space. All other keys cause either an error message or make Sedt
execute a series of commands programmed into the key.
Tab will insert tab and space characters in the text and
position the cursor at the indentation setting if it is to the right of
the cursor, otherwise at the next tab setting on the ruler.
Return will insert an LF (ASCII 12) character in the text. If
you wish to search for a string including a new line insert an LF (F13)
in the search string.
Gold Keypad 0 will insert a new line in front of the current
cursor position.
To insert an arbitrary ASCII character enter Gold, the decimal
value of the character and Gold Keypad 3.
Commands
Commands are coded into ASCII control characters and the
function keys on the keyboard.
PF1 (Gold) has a special meaning. It does not cause any
commands to be executed, but modifies the effect of the next key to be
typed. When in this text the term Gold is used before a key it means
that you have to type PF1 before typing the key. Gold also causes the
normal ASCII characters to be modified to execute Sedt commands instead
of entering text.
Some commands require arguments from the keyboard. These
commands will prompt for the argument and wait for you to type it in.
As you type the argument it is echoed at the end of the prompt on the
message line. Argument entry is terminated by typing Return, Do or
Enter. Mistakes can be corrected by deleting a character at a time
with Rubout (above Return). The entire command can be cancelled by
typing Control U.
Most commands can be repeated by typing Gold, inputting the
number of times the command should be repeated, and the key sequence
for the command. While entering the number you see it echoed on the
message line. Mistakes can be corrected by typing Rubout to delete a
character. Entry of the number can be aborted by typing Control U.
Help
To get help within an edit session type Gold H, Help or PF2.
Sedt will display a help screen and ask you whether you want to see the
next help screen. typing Return will display the next help screen.
Typing Space will return to the edit session. The help text is found
in a disk file (CP/M: Sedthelp.Txt. VMS: Sedt$Help:). If the help
file cannot be found an error message will be displayed.
Moving
The most simple moving commands to use are the arrow keys.
Left arrow moves the cursor one character backwards in the text. Right
arrow moves one character forward in the text. Up arrow moves one line
up and attempts to keep the cursor at the same relative position within
the line. If the line is too short the cursor will be positioned at
the end of the line. If the character at the previous line has a
representation longer than one character (Tab or other control
characters) the cursor will be positioned at the end of the
representation. Down arrow works as up arrow, but moves one line down.
Previous Screen moves 10 lines up the text and places the
cursor at the start of the line. Next Screen moves 10 lines down in
the text and places the cursor at the beginning of the line.
Gold T moves the cursor to the top of the text. Gold B moves
the cursor to the bottom of the text.
More complicated moving commands are:
Backspace (F12) Moves to the previous beginning of line
* Find Moves to the next occurrence of the
current search string.
* Keypad 0 Moves to the next beginning of line.
* Keypad 1 Moves one word.
* Keypad 2 Moves to the next end of line.
* Keypad 3 Moves one character.
* Keypad 7 Moves one page.
* Keypad 8 Moves one paragraph.
* PF3 Moves to the next occurrence of the
current search string.
* Gold Find Moves to the next occurrence of the
current search string which is entered as
a command argument on the message line.
Entering an empty argument causes Sedt to
use the old search string.
Gold Up Arrow Moves to the top of the text.
Gold Down Arrow Moves to the end of the text.
Gold Keypad 4 Moves to the end of the text.
Gold Keypad 5 Moves to the start of the text.
* Gold PF3 Moves to the next occurrence of the
current search string which is entered as
a command argument on the message line.
Entering an empty argument causes Sedt to
use the old search string.
Keypad 4 Causes commands marked by * to move
backwards in the text.
Keypad 5 Causes commands marked by * to move
forward in the text.
Gold Left Arrow Scrolls continuously up through the text
till a key is hit. (Enter is dead key)
Gold Right Arrow Scrolls continuously down through the
text till a key is hit. (Enter is dead
key)
To undo a move you type Gold U as the next command.
Marks
Marks are points in the text that you may want to return to.
You can mark a point in the text by entering Gold, the number of the
mark to be set, and Gold M. You can set mark number 1 by entering Gold
M.
To return to a mark you enter Gold, the number of the mark, and
. (dot). You can return to mark 1 by entering Gold . (dot).
Valid mark numbers are in the range 1 to 10.
Deleting text
The character immediatly before the cursor position may be
deleted with Rubout. The word immediatly before the current position
may be deleted with Line Feed (F13). The line up to the current
position may be deleted with Control U.
The character after the current position is deleted with Keypad
, (comma), the next word with Keypad -, and the next line with PF4.
Gold Keypad 2 deletes up to the end of the current line.
To delete arbitrary text move to one end of the text and enter
either Select or Keypad ., then move to the other end of the text and
enter either Remove or Keypad 6.
Gold Remove will move the text between the current position and
the select point into the paste buffer, but will not delete the text.
This command is useful for copying text from one position to another.
The select point may be cancelled with Gold Keypad . (dot).
It is not necessary to delete a character to change the case.
Simply place the cursor over the character and enter Gold Keypad 1. If
a select point is active the whole select range will change case,
otherwise, if the last command was a search command the found string
will change case.
Undeletion
Any deleted text can be undeleted until a similar type of text
is deleted. Gold Keypad , (comma) undeletes the last deleted
character, Gold Keypad - undeletes the last deleted word, and Gold PF4
undeletes the last deleted line.
Insert Here or Gold Keypad 6 undelete the paste buffer which is
filled with Remove, Gold Remove or Keypad 6.
Search and substitute
Gold Keypad 9 accepts a search and a substitute string and
replaces the next occurrence of the search string with the substitute
string. If an empty argument is entered either for the search or
substitute strings the old values will be used.
Keypad 9 replaces the next occurrence of the current search
string by the substitute string.
To undo a substitution type Gold U as the next command. Gold U
will insert the search string exactly as you typed it after deleting
the substitute string.
Edit buffers
Sedt can concurrently edit up to four different files. Each
file is contained in a buffer. One of these is the current buffer on
which all commands have effect. F17 to F20 change the current buffer.
F17 makes buffer 0 the current, F18 buffer 1, F19 buffer 2, and F20
buffer 3.
Whenever F17 to F20 are entered Sedt will change into two
window mode with the previously current buffer contents displayed in
the lower window and the current buffer in the upper window. If the
current and previous buffer are the same the lower window will not
reflect changes in the buffer unless the screen is refreshed with a
Control W, which causes the two window contents to become identical.
Windows
Gold D will toggle between one and two window mode. The upper
window always contains the current buffer and the lower window the
previous buffer.
Gold W will toggle between 80 and 132 column display format.
Session control
Gold F causes the current buffer to be written to it's output
file. If all buffers have been written to disk Sedt will exit. If
there are still unwritten buffers Sedt will ask you whether you intend
to terminate the edit session without saving the buffers.
Gold S is used to save the contents of the buffer in any file
and continue the edit session. The filename is accepted from the
keyboard. If no filename is entered the buffer is saved into the
buffer's output file.
Gold E causes the current buffer to be loaded with a new file.
If the current buffer holds an unsaved file Sedt will ask you whether
you want to save the old file. If you confirm, Sedt will save the old
file in the output file before loading the new file.
Gold Q will terminate the edit session if all buffers have been
written to disk. If unsaved buffers exist Sedt will ask for
confirmation before exiting.
Gold Z clears the current buffer.
Gold G will load the contents of a file into the current buffer
at the current cursor position.
Control W will refresh the screen.
Word processing
The basic text formatting commands allow Sedt to be used as a
simple word processing system. The format is controlled with the ruler
displayed on line 2 of the display.
Gold R allows you to change the ruler. The cursor will be
positioned at the first column of line 2 after which you can modify the
layout with the following commands.
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.
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.
W Sets the word wrap margin to the current
position.
I Sets the indentation at the current position.
Digit Load saved ruler number digit.
Gold Digit Save current ruler in saved ruler number
digit.
Return Returns from ruler definition mode to
normal edit mode.
Gold Keypad 8 will reformat from the current position to the
end of the paragraph.
Gold C will center the text on the current line between the
left and right margins.
Gold P will insert a page mark at the current position.
Control P will print the current buffer on the CPM device LST:.
Defining keys
Control K will allow you to define keys differently from the
default settings. When the Key: prompt appears type the key you wish
to define. When the As: prompt appears type the definition of the key
either by typing the sequence of command keys to be executed or by
entering the basic Sedt commands. If the string is terminated with a .
the key will take effect immediatly when hit, otherwise it will be
stacked up for execution when some other key is struck.
Gold control I will insert a key definition into the current
buffer. When the Key: prompt appears type the key you want to save the
definition of.
Gold control L will load the contents of the current buffer
into a key definition. When the Key: prompt appears type the key you
want to load the definition of.
Miscellaneous commands
Gold Keypad 7 accepts a string of basic Sedt commands from the
keyboard and executes them.
Quick command guide
Control A Set indentation to current column
Control D Decrease indentation
Control E Increase Indentation
Backspace Move to beginning of line
Tab Enter tab or space characters to next tab
stop
Line Feed (F13) Delete to beginning of word
Control K Define key
Return Insert a new line character
Control P Print current buffer
Control U Delete to beginning of line
Control W Refresh screen
Rubout Delete character before current position
Gold Control I Insert key definition in current buffer
Gold Control L Load key definition from current buffer
Gold . Go to mark
Gold B Go to end of text
Gold C Center current line
Gold D Toggle between one and two window display
Gold E Edit new file in current buffer
Gold F File current buffer and quit Sedt if all
buffers saved
Gold G Insert contents of file at current position
Gold H Display help text
Gold M Set mark
Gold P Set page mark
Gold Q Quit Sedt
Gold R Display and change ruler
Gold S Save current buffer in file different from
output file
Gold T Move to top of text
Gold W Toggle between 80 and 132 character display
Gold U Undo move or substitute
Gold Z Zero buffer
Help Display help text
F17 Select buffer 0 as current buffer
F18 Select buffer 1 as current buffer
F19 Select buffer 2 as current buffer
F20 Select buffer 3 as current buffer
Find Find next occurrence of current search string
Insert Here Insert contents of paste buffer
Remove Remove text between current position and
select point and place in paste buffer
Select Set current position as select point
Prev Screen Move 10 lines up
Next Screen Move 10 lines down
Up Arrow Move 1 line up vertically
Left Arrow Move 1 character back
Down Arrow Move 1 line down vertically
Right Arrow Move 1 character forward
Keypad 0 Move 1 line
Keypad 1 Move 1 word
Keypad 2 Move to end of line
Keypad 3 Move 1 character
Keypad 4 Advance
Keypad 5 Reverse
Keypad 6 Remove text between current position and
select point and place in paste buffer
Keypad 7 Move 1 page
Keypad 8 Move 1 paragraph
Keypad 9 Substitute next occurrence of search string
by substitute string
Keypad , Delete 1 character
Keypad - Delete 1 word
Keypad . Set current position as select point
PF2 Display help text
PF3 Move to next occurrence of search string
PF4 Delete 1 line
Gold Find Accept and move to search string
Gold Remove Copy text between current position and
select point into paste buffer
Gold Up Arrow Move to top of text
Gold Left Arrow Scroll up through text
Gold Down Arrow Move to end of text
Gold Right Arrow Scroll down through text
Gold Keypad 0 Open line
Gold Keypad 1 Change case of current character
Gold Keypad 2 Delete to end of line
Gold Keypad 3 Insert ASCII character value Count
Golf Keypad 4 Move to end of text
Gold Keypad 5 Move to top of text
Gold Keypad 6 Paste
Gold Keypad 7 Accept and execute Sedt basic command
Gold Keypad 8 Fill to end of current paragraph
Gold Keypad 9 Accept search and substitute strings and
replace next occurrence of search string
by substitute string
Gold Keypad , Undelete character
Gold Keypad - Undelete word
Gold Keypad . Reset select point
Gold PF3 Accept and move to search string
Gold PF4 Undelete line
Basic Sedt commands
Command structure
{+|-}{<Count>}:<Command>{<Arguments>}
Performs an action within the editor
{+|-}{<Count>}@<Entity>{<Arguments>}
Defines a range within the buffer
Entities that are not command arguments cause the
current position to move to the point defined by the
entity.
Entities preceeded by a - always work backwards from the
current position. When preceeded by a + they always work
forward from the current position. Unsigned entotoes
work forward or backward depending upon the current
direction.
An entity working backward starts with the character
immediatly before the current cursor position. When
working forward the entity includes the current cursor
position.
Count normally causes the command or entity to be
repeated.
A - causes the command or entity to work backwards in
the buffer.
A + causes the command or entity to work forwards in the
buffer.
Command sequences may be repeated by following a count
with the commands to be repeated in parenthesis. If
count is zero the command sequence will be repeated
until an error occurs or :TI senses type ahead
Entities
@BB Top of buffer
@EB End of buffer
@EL End of line
@C Character
@F<Delimiter><String><Delimiter>
Start of next occurrence of <String>
@L Next beginning of line
<Count>@M Point number <Count>. Point 0 is the
select point
@N Start of next occurrence of same search
string
@PAG Start of next page
@PAR Start of next paragraph
@SEN Start of next sentence
@SR Select point
@V Same position within next line
@W Start of next word
Commands
:A Make entities default forward
:B Make entities default backward
:CC<Entity> Change case within entity
:CD<Entity> Change to lower case within entity
:CE Changes case EDT style. Select range if
set, otherwise search string, else char
<Count>:CH Insert character with ASCII value <Count>
:CL Center text of current line
:CU<Entity> Change to upper case within entity
:D<Entity> Delete entity
:EAP<Entity> Delete entity and append to delete buffer
:FE<Delimiter><Name><Delimiter>
Edit file named <Name>
:FG<Delimiter><Name><Delimiter>
Insert file named <Name> at current position
:FS<Delimiter><Name><Delimiter>
Save current buffer in file named <Name>
:FX<Delimiter><Name><Delimiter>
Execute basic Sedt commands in file
<Name>
:GE<Entity> Get entity into delete buffer but do not
remove from text
:H Display help message contained in
SEDTHELP.TXT
:I<Delimiter><Text><Delimiter>
Insert <Text> at current position
:K{G}{F|A}NNN<Delimiter><Commands><Delimiter>
Define key as <Commands>
G Gold
F Function key
A Ascii character
NNN 3 digit decimal number
:LD Decrease indentation by 1
<Count>:LD Decrease indentation by <Count>
:LI Increase indentation by 1
<Count>:LI Increase indentation by <Count>
:LK{G}{F|A}NNN Load key definition from current buffer
G Gold
F Function key
A Ascii character
NNN 3 digit decimal number
:LS Set current column position as indentation
:M Save current position in point 1
<Count>:M Save current position in point <Count>
:NL Insert a new line character
:NS Substitute using save object and target
:OL Open line
:PL<Delimiter><Name><Delimiter>
Load the paste buffer from file named <Name>
:PR Print current buffer on devive LST:
:PS<Delimiter><Name><Delimiter>
Save the paste buffer in file named <Name>
:REP Replace search string by contents of
paste buffer
:RF Refresh the screen
:RL Change to ruler definition mode
:RS Remove select point
:SEL Save current position in select point
:SK{G}{F|A}NNN Save key definition in current buffer
G Gold
F Function key
A Ascii character
NNN 3 digit decimal number
:SUB<Delimiter><Object><Delimiter><Target><Delimiter>
replace next occurrence of <Object> with
<Target>
:SYS<Delimiter><Command><Delimiter>
Spawns <Command> to the operating system
:TAB Enter tab and space characters to advance
to next tab stop
:TF<Entity> Fill within entity
:TI Return an error condition if type ahead
:UC Undelete last deleted character
:UL Undelete last deleted line
:UM Undo last command. Commands that can be
undone are moves and substitutes
:UPAG Undelete last deleted page
:UPAR Undelete last deleted paragraph
:USEN Undelete last deleted sentence
:USR Paste
:UU Undelete last unknown entity
:UW Undelete last deleted word
:Q Abort without saving file
:WC Toggle between one and two window display
:WD Toggle screen width between 80 and 132
columns
<Count>:WI Select buffer <Count>
:X Exit and save file after creating backup
file
:Z Zero current buffer
Key definition file
Each line in the key definition file SEDTKEYS.TXT programs one
key. The format is a one or two letter key type, followed by a three
digit decimal key number, followed by the string to program the key
with.
Key types:
A ASCII character
GA Gold ASCII character
F Function key
GF Gold function key
Ascii character numbers are the decimal values of the ASCII character.
Function key numbers
000 Compose
001 Hold Screen
002 Print Screen
003 Setup
004 F4
005 Break
006 Interrupt
007 Resume
008 Cancel
009 Main Screen
010 Exit
011 ESC
012 BS
013 LF
014 Additional Options
015 Help
016 Do
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