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.DOC
< prev
next >
Wrap
Text File
|
1985-05-23
|
27KB
|
786 lines
[Sysop's Note: Version's of SEDT for VAX/VMS, CP/M-86 and MS-DOS exist, all
of which have identical user interface. This manual does not as yet reflect
the existence of the MS-DOS version. One installation requirement not stated
here for MS-DOS is to define two "environment" variables with the MS-DOS "SET"
command containing pointers to the appropriate SEDTKEYS and SEDTHELP files.
for example - to emulate EDT use:
SET SEDTKEYS=d:\pathname\SEDTKEYS.EDT
SET SEDTHELP=d:\pathname\SEDTHELP.EDT
Where "d:" is the drive letter and "pathname" is the directory name where the
SEDTKEYS.EDT and SEDTHELP.EDT files reside on your system. To emulate the WPS
wordprocessing editor, use the .WPS files instead.]
Sedt Users Guide
Screen EDiTor Version X.03
Sedt is an interactive "what you see is what you get"
editor for VAX/VMS and the Rainbow 100 under CP/M version 2.0.
Sedt is highly 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 from CP/M 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.
Lines 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:
Load the input file and display the file on the
screen.
Load a key definition file (CP/M: Sedtkeys.Txt.
VMS: Sedt$Keys:). Sedt will abort if it cannot
find the key definition file.
Load a default ruler file (CP/M: 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.
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.
Look for an initialization file on disk (CP/M:
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.
If the user has supplied an optional starting
line number in the command line, Sedt will
position the cursor at the command line.
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 input file
for the current buffer is. The contents of the buffer is
initially the disk contents of the input file.
The third 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.
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 sunstitute 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
<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
: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>
: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>
:LE Increase indentation by 1
<Count>:LE 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
:PR Print current buffer
: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
: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