Trailing-Edge
-
PDP-10 Archives
-
tops20tools_v6_9-jan-86_dumper
-
tools/sed2/sedhelp.hlp
There are 2 other files named sedhelp.hlp in the archive. Click here to see a list.
01 SED
! SED.RNH - Processed by RUNOFF 14:11 April 12, 1984
! Written: 21-Sep-82/SLP
! Updated: 11-May-83/MEH
!
! 27-Dec-82/SLP Added /SCROLL.
! 11-Apr-83/MEH Added updates on /TERM and /KEYPAD.
! 11-May-83/MEH More updates on /TERM and /PROG.
!
Invokes SED, a full screen-oriented text editor. The format of the SED
command is [items enclosed in square brackets are optional]:
SED [filespec[=][/qualifier(s)]]
SED is documented in the SED tutorial (SYS$DOC:SED.MAN) and SED
reference (SYS$DOC:SED.DOC) manuals.
02 Overview
SED is a full screen text editor. It is easier and more natural to
use than line or character editors like SOS or TECO, and is generally
faster too. SED lets your display terminal's screen become a window
through which you can see and edit a text file. The window is
updated immediately as you make changes, so you always see exactly
what your file looks like.
SED is easy to use. To enter text into your file, just type. To
change existing text, just type over it. There are commands to move
around on the screen, move around in the file, insert or delete lines
or spaces, move text from one place to another, search, edit two
files at the same time, get help, and other useful things. For
sophisticated users, SED has a "macro" facility, too.
02 Restrictions
This VAX version of SED was written and is still under development
here at BYU. It is based on the DEC-10 version of SED written by
Christopher Hall, a DEC employee. SED was so popular on our DEC-10
that we decided to make it available on our new VAX system. Most of
the commands and features of DEC-10 SED have been implemented; the
rest are coming!
The current version of SED runs on the following terminal types: A
true DEC VT52, Infoton 200, Ramtek 6211 graphics terminal, DEC VT100,
Televideo 910, and Visual 200 in VT52+ mode. However, SED can be
configured to run on many other terminals too. Please contact a
Consultant, 424 CB, 378-4941, for more information.
As previously stated, SED is still under development. Please report
any bugs in SED to MANAGER via the MAIL command. The following is a
list of known deficiencies or problems in VAX SED. We plan to fix
all of them (eventually).
1. Don't type Control-Ys (the <ROLL-FORWARD-PAGE> command) too fast.
If you type two <ROLL-FORWARD-PAGE> commands in succession such
that you type the second <ROLL-FORWARD-PAGE> before the first
<ROLL-FORWARD-PAGE> finishes, SED will drop to DCL command level.
This is intentional. SED is still under development. We need a
way to stop SED when a newly discovered bug puts SED in a loop!
If you do type Control-Ys too fast and find yourself at DCL
level, you can still return to SED without losing anything. Just
type "CONTINUE" and press return (then type a <REWRITE-SCREEN>
command).
2. Certain commands will clear the pick buffer: <HELP> and reading
an execute command file indirectly (<ENTER>@file.xct<EXECUTE>).
3. SED's "looking through a list of files" option, described in
Appendix B of SED.DOC, is not implemented.
4. The SED reference manual (SYS$DOC:SED.DOC) describes the DEC-10
version of SED. It hasn't been edited for the VAX yet. However,
you can still use it. The only noticeable difference between SED
on the DEC-10 and on the VAX is in the way you specify a file
name. All the commands (that are implemented) still work the
same.
The SED tutorial manual (SYS$DOC:SED.MAN) has been edited for the
VAX. Where the SED tutorial and reference manuals disagree, the
tutorial is correct.
02 Parameters
filespec
The name of the file you wish to create or edit.
There are three ways to specify the filespec when you start up the
SED editor. At DCL command level type:
SED filespec= SED will find or create (if the file doesn't exist
yet) the specified file. SED's editing window is
positioned to the beginning of the file.
SED filespec SED will find the specified file. SED's editing
window is positioned to the beginning of the file.
If SED can't find the file, a "file not found"
error message is displayed. SED will then return
you to the previous file you were editing (if
there was one). If you haven't edited a file yet,
SED will display a cheery welcoming message.
SED SED will return you to the last file you edited
with SED. SED's editing window is positioned to
the same place in the file as where you left off
last time.
If you haven't edited a file yet, SED will display
a cheery welcoming message.
02 Commands
SED has over 50 built-in commands (you can also define your own).
They are summarized below. The commands are grouped by the function
they perform. For complete SED command descriptions, see the SED
tutorial (SYS$DOC:SED.MAN) and reference (SYS$DOC:SED.DOC) manuals.
Or try SED's built-in HELP facility.
COMMANDS to MOVE the CURSOR
----------------------------------------------------------------
CURSOR-UP Move the cursor up
CURSOR-DOWN Move the cursor down
CURSOR-LEFT Move the cursor to the left
CURSOR-RIGHT Move the cursor to the right
CURSOR-HOME Move the cursor to the upper left
CARRIAGE-RETURN Move the cursor to start of next line
TAB Move cursor to the next tab stop
BACKTAB Move cursor to the previous tab stop
UP-TAB Up-tab (6 cursor-ups)
DOWN-TAB Down-tab (6 cursor-downs)
LINE Move to beginning or end of line
BEGIN-LINE Move to beginning of line
END-LINE Move to end of line
COMMANDS to MOVE the WINDOW
----------------------------------------------------------------
ROLL-FORWARD-PAGES Move window forward some pages
ROLL-FORWARD-LINES Move window forward some lines
ROLL-BACK-PAGES Move window back some pages
ROLL-BACK-LINES Move window back some lines
SLIDE-LEFT Move viewing window to the left
SLIDE-RIGHT Move viewing window to the right
PERCENT-GOTO Move window a percentage into the file
COMMANDS to INSERT and DELETE
----------------------------------------------------------------
INSERT-SPACES Add some spaces at the cursor
DELETE-SPACES Remove some characters from a line
INSERT-LINES Add some blank lines at the cursor
DELETE-LINES Remove some lines at the cursor
ERASE-LINE Erase from cursor to end of the line
DELETE-CHARACTER Delete the character to left of cursor
ERASE-WORD Delete previous word
INSERT-MODE Insert/replace mode toggle
ENTER-CONTROL-CHARACTER Make the next character typed a control char
REAL-TAB Insert a real tab (Same as <E-C-C>I)
PICK Load buffer with text from the file
PUT Add text to the file from a buffer
MARK Mark position for PICK or DELETE-LINES
COMMANDS to ENTER or EDIT PARAMETERS
----------------------------------------------------------------
ENTER Set up an argument for a command
RECALL Recall latest argument
RESET Cancel argument; rewrite cursor, line,
or screen
COMMANDS to SEARCH and SUBSTITUTE
----------------------------------------------------------------
SEARCH-FORWARD Search from cursor toward end of file
SEARCH-BACKWARD Search from cursor toward start of file
SUBSTITUTE Search for a string & substitute another
COMMANDS to EXIT, SAVE, or SELECT a FILE
----------------------------------------------------------------
EXIT Save file and exit
ABORT Exit, forgetting changes
SAVE-FILE Save file without exiting
SET-FILE Set up a new file for editing
MISCELLANEOUS COMMANDS
----------------------------------------------------------------
CASE Change case of letter at cursor
EXECUTE Set up or execute a sequence of commands
HELP Give help (individual command summaries)
PUSH Spawn a subprocess to execute DCL commands
REWRITE Rewrite screen (Same as <ENTER>^<RESET>)
SWITCH Set/query operating switches
TAB-SET/CLEAR Set or clear settable tabs
WINDOW Set or clear split screen windowing
03 Executing_SED_Commands
About half of SED's commands are executed by typing a CONTROL
CHARACTER. The rest are executed by typing a two character ESCAPE
SEQUENCE or (if your terminal has them) by pressing a FUNCTION KEY.
Therefore, what you type may vary somewhat from terminal to
terminal.
04 Control_Character_Commands
Typing a CONTROL CHARACTER means to momentarily hold down the
CONTROL key (usually labelled 'CTRL') while you press one of the
other keys (usually a letter) on the keyboard. This is similar
to the way you use the SHIFT key on a typewriter. You'll find
the CONTROL key on the left side of the keyboard, near the SHIFT
key. Thirty-two characters can be typed as control characters:
A-Z, [, @, _, ], ^, and \. For alphabetical control characters,
no distinction is made between upper and lower case: CONTROL-A
is the same as CONTROL-a.
Reguardless of the terminal you use, SED commands invoked by the
alphabetical control characters are assigned as shown below. The
location and commands assigned to the [, @, _, ], ^ and \ keys
vary.
.___________________________________________________________.
| ROLL-BACK | SEARCH |ROLL-FORWRD| TAB |ENTER|PRCNT|
|PAGES LINES|BKWRD FORWD|LINES PAGES|BKWRD FORWD|C-CH |GOTO |
| q w | e r | t y | u i | o | p |
|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|
|INSRT DELET|INSRT DELET|PUT | CURSOR |
| SPACES | LINES | |LEFT DOWN UP RIGHT|
| a s | d f | g | h j k l |
|_____|_____|_____|_____|_____|_____|_____|_____|_____|
|EXIT |EXE- |ABORT|PICK |SET |SWTCH|RE- |
| |CUTE | | |FILE | |TURN |
| z | x | c | v | b | n | m |
|_____|_____|_____|_____|_____|_____|_____|
Notice how the commands are grouped. There is no mnemonic
relationship (except by coincidence) between the name of a
command and the key it is on. Instead, commands with similar
functions are placed near each other. Most SED users agree that
this system is better than a mnemonic placement which would
chaotically scatter the commands all over the keyboard.
04 Escape_Sequence_Commands
Typing an ESCAPE SEQUENCE means to type two keys in succession
(not simultaneously). The first key you type is always an
ESCAPE. The second key you type is usually a letter. If your
terminal doesn't have a lot of function keys, you'll probably
have to type some SED commands as escape sequences. (Note: the
Visual 200, DEC VT52 and VT100 terminals have function keys.
Therefore, these terminals DO NOT use the escape sequences
described in this section.)
SED commands invoked by an escape sequence are assigned as shown
below. Note: it doesn't matter whether the second character of
the sequence is typed in upper or lower case.
._________________________________________________________________.
|ENTER|REWRT|ERASE|END |SLIDE|REAL |TAB |UP |INSRT|WIN- |PUSH |
|PARAM|SCREN|WORD |LINE |RIGHT|TAB |SET/C|TAB |MODE |DOW | |
| esc | q | w | e | r | t | y | u | i | o | p |
|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|
|RECAL|SAVE |DELET| | |CURSR|DOWN |ERASE|SLIDE|
| |FILE |CHAR | | |HOME |TAB |LINE |LEFT |
| a | s | d | f | g | h | j | k | l |
|_____|_____|_____|_____|_____|_____|_____|_____|_____|_______.
|RESET|LINE |CASE | |BEGIN|IN- |MARK | | |HELP |
| | | | |LINE |VERT | | < | > | ? |
| z | x | c | v | b | n | m | , | . | / |
|_____|_____|_____|_____|_____|_____|_____|_____|_____|_____|
Unlike the CONTROL CHARACTER commands, notice that there is (as
much as possible) a mnemonic relationship between the name of an
ESCAPE SEQUENCE command and the key to which it is assigned.
04 Function_Key_Commands
Typing a FUNCTION KEY means to press a specially labelled key.
Function keys are provided for convenience. Pressing one is
equivalent to typing a control character or an escape sequence.
All terminals minimally have
DELETE Also labelled: DEL, RUBOUT, RUB or RO
Equivalent to: (no equivalent)
SED command: DELETE-CHARACTER
ESCAPE Also labelled: ESC, ALTMODE, ALT, SELECT, SEL
Equivalent to: CONTROL-[
SED command: ENTER-PARAMETER (press twice)
HELP (press four times)
LINE FEED Also labelled: LF
Equivalent to: CONTROL-J
SED command: CURSOR-DOWN
RETURN Also labelled: CR, RET, or NEW LINE
Equivalent to: CONTROL-M
SED command: RETURN
Most terminals will also have
BACKSPACE Also labelled: BS, BACK
Equivalent to: CONTROL-H
SED command: CURSOR-LEFT
TAB Also labelled: (no other label)
Equivalent to: CONTROL-I
SED command: TAB-FORWARD
Many terminals have additional function keys. Cursor mover keys
are labelled with directional arrows. Other function keys are
usually labelled F1, F2, F3, etc.; or perhaps PF1, PF2, PF3,
etc. They are commonly placed across the top and/or down the
side of the keyboard. On some terminals, the numeric keypad
doubles as an extra set of function keys.
When pressed, these additional function keys send a control
character or an escape sequence. Unfortunately, the code sent
varies from one terminal model to another. So does the location
and number of function keys. Therefore, the SED command invoked
by pressing a function key depends on which terminal model you
are using.
The only terminals with "additional" function keys used by the
current version of SED are: Visual 200, DEC VT52 and VT100.
Therefore, these terminals DO NOT use the escape sequences
defined in the previous section, "ESCAPE SEQUENCE COMMANDS."
02 Qualifiers
Qualifiers (switches) tailor SED's operation to your liking. They
can be given as part of the file name in the DCL level SED command,
in your SED.INI file, or via the <SWITCH> and <SET-FILE> commands
while within SED.
You only have to type enough of the qualifier name to make it unique
("/T" is good enough for TABS).
You can set more than one switch by separating them with slashes, for
example /TABS=6/CASE/BACK
Each qualifier and its default setting is listed below.
/Qualifier Default
---------- -------
/AGAIN[=n]
/ALT[=n]
/[NO]APPND /NOAPPND
/[NO]BACKUP /BACKUP
/[NO]BEEP /NOBEEP
/[NO]CASE /NOCASE
/[NO]COMMENT=ab,cd /NOCOMMENT
/[NO]CREATE /NOCREATE
/[NO]DELIM[=abc] /NODELIM
/[NO]DTABS /NODTABS
/GOTO=n /GOTO=0
/[NO]HELP /HELP
/[NO]ICR /NOICR
/[NO]ID /NOID
/[NO]IMODE /NOIMODE
/[NO]INVRT /INVRT
/[NO]ISAVE[=n] /NOISAVE (/ISAVE=0)
/[NO]ITABS /ITABS
/[NO]JOURN /NOJOURN
/[NO]KEYPAD /KEYPAD
/LENG=n /LENG=24
/LMAR=n /LMAR=1
/[NO]MESSAGE /MESSAGE
/OUT=filespec
/[NO]PAGE /NOPAGE
/[NO]PROG=filespec /NOPROG
/[NO]QUICK /NOQUICK
/[NO]RAISE /RAISE
/[NO]RCUR /NORCUR
/[NO]READ /WRITE (/NOREAD)
/[NO]RECOV /NORECOV
/[NO]RESET /RESET
/[NO]RMAR=n /RMAR=80
/[NO]ROLL /ROLL
/[NO]SAVE[=n] /NOSAVE (/SAVE=0)
/[NO]SCROLL /NOSCROLL
/[NO]SHOW /NOSHOW
/[NO]SLIDE[=n] /SLIDE=8
/[NO]TABS[=n] /TABS=8
/[NO]TSET=n
/[NO]UPPER /NOUPPER
/WIDTH=n /WIDTH=80
/[NO]WRITE /WRITE (/NOREAD)
/X[=name]=txt
/TERM=type
/AGAIN
/AGAIN
/AGAIN=n
/AGAIN may be given in a <SET-FILE> command. If you are editing
FILE.FOO, typing <ENTER>/AG<SET-FILE> acts the same as if the
parameter were "FILE.FOO". This qualifier is useful when you want to
make the current and alternate file be the same file -- allowing you
to toggle back and forth between two places in the same file. Do not
use explicit filespecs with /AGAIN.
/AGAIN=n acts the same as /AGAIN/GOTO=n -- the numeric argument is a
percentage of the way into the file.
/ALT
/ALT
/ALT=n
/ALT may be given on the DCL level SED command. It swaps the current
and alternate files you were editing last time.
/ALT=n acts the same as /ALT/GOTO=n - the numeric argument is a
percentage of the way into the file.
/APPND
/APPND
/NOAPPND (D)
Controls whether <PICK> appends to the PICK buffer, or overwrites it.
/APPND causes <PICK>s to append to the PICK buffer until /NOAPPND or
another /APPND is typed.
/NOAPPND causes <PICK>s to overwrite the PICK buffer. This is the
default.
/BACKUP
/BACKUP (D)
/NOBACKUP
Controls whether SED overwrites or creates a new version of the file
you are editing.
/BACKUP causes SED to create a new version of your file each time it
is edited. This is the default.
/NOBACKUP causes SED to overwrite the file each time it is edited.
This saves disk space, but you lose the original version of the file.
/BEEP
/BEEP
/NOBEEP (D)
Controls whether your terminal beeps or displays a message when SED
is in INSERT mode.
/BEEP causes the terminal to beep once when entering INSERT mode and
twice when entering REPLACE mode.
/NOBEEP causes an "INSERT MODE" message to appear on the bottom line
of the terminal when SED is in INSERT mode. No message is displayed
when SED is in REPLACE mode. This is the default.
/CASE
/CASE
/NOCASE (D)
Controls whether searches are case-dependent.
/CASE makes searches case-dependent, i.e., the key "THE" is different
from the key "the".
/NOCASE makes searches independent of case, i.e., the key "THE" will
match the first occurrence of "THE", "the", "tHe", etc. This is the
default.
/COMMENT
/COMMENT=c1
/COMMENT=c1,c2
/NOCOMMENT (D)
/COMMENT defines the characters to be used on comment lines inserted
by SED. The only comment lines inserted by SED are the "This file
is..." message (if the message has not been turned off with
/NOMESSAGE) and the edit-history lines that are inserted if the /ID
switch has been set. C1 defines the string to be inserted at the
beginning of the comment, and C2, if specified, specifies the string
to be appended to the end of the comment. If /NOCOMMENT is in
effect, SED will insert default characters determined by the file
type.
/CREATE
/CREATE
/NOCREATE (D)
Controls whether an equal sign (=) is needed after the name of a file
you want to create.
/CREATE frees you from having to type an equal sign (=) after the
name of the file you want to create with SED. (SED will first still
try to find the file you specified, including trying default file
extensions, before it gives up and creates the new file.)
/NOCREATE causes SED to create a new file only if the file name is
followed with an equal sign (=). This is the default.
/DELIM
/DELIM=ABC
/NODELIM (D)
Sets or clears a string of extra delimiters to use when in word-wise
tab mode. ABC represent additional delimiters to be used in addition
to the standard delimiters (tab and space). SED will position the
cursor on the position following any of the specified delimiters.
Use /NODELIM to clear the set of delimiters.
/DTABS
/DTABS
/NODTABS (D)
Controls whether TABS in a file are highlighted.
/DTABS causes tabs to identify themselves. Each tab displays as a
highlighted "I" followed by one fewer space than usual (so the
columns on the screen are still aligned properly).
/NODTABS inhibits any special indication of TABs in your file. This
is the default.
/GOTO
/GOTO=n /GOTO=n may be used when running SED or doing a <SET-FILE>.
The file will be displayed starting n percent of the way into the
file. If your specify /GOTO without an argument, SED will use the
current percent value (default is n=0).
/HELP
/HELP (D)
/NOHELP
Controls what key(s) you type to get help about SED commands.
/HELP enables on-line help when <ENTER><ENTER> is typed, as well as
<HELP>. This is the default.
/NOHELP inhibits on-line help when <ENTER><ENTER> is typed. The only
way to get help is with <HELP>.
/ICR
/ICR
/NOICR (D)
Controls what happens when you press <RETURN> in INSERT mode.
/ICR causes a <RETURN> typed in INSERT mode to insert a carriage
return, linefeed into your text. If you are in the middle of a line,
the line is broken into two lines.
/NOICR causes a <RETURN> typed in INSERT mode just to position the
cursor to the beginning of the next line. This is the same way
<RETURN> works in REPLACE mode. This is the default.
/ID
/ID
/NOID (D)
Controls whether an identifying line is added to the beginning of a
file each time it is edited.
/ID causes an identifying line to be inserted at the beginning of a
file when it is saved. The line contains the filespec, the date and
time, and the name of the user who edited the file.
/NOID prevents an identifying line from being inserted in the file.
This is the default.
/IMODE
/IMODE
/NOIMODE (D)
Controls whether SED is in replace or insert mode. This qualifier
performs the same function as the <INSERT-MODE> command.
/IMODE puts SED in insert mode. This qualifier can also be used in
execute buffers ($IM^SW).
/NOIMODE puts SED in replace mode. This is the default.
/INVRT
/INVRT (D)
/NOINVRT
Controls the action of the <CASE> command.
/INVRT causes <CASE> to invert the case of a letter. "S" becomes
"s", "p" becomes "P", etc. This is the default.
/NOINVRT causes <CASE> to use the setting of the /RAISE qualifier.
See /RAISE.
/ISAVE
/ISAVE=n
/NOISAVE or /ISAVE=0 (D)
Causes an incremental save of your file every n commands. Default is
n=0 (i.e., no incremental saves).
/ISAVE and /SAVE can be used together. When the counter for either
one reaches its limit, the file is saved, and both counters are
reset.
/ITABS
/ITABS (D)
/NOITABS
Controls whether SED can use tab characters to extend a line.
/NOITABS - If you type something beyond the end of a line SED will
insert only spaces so the character is properly positioned.
/ITABS - If you type something beyond the end of a line, SED will use
tabs where possible instead of spaces so the character is properly
positioned. This is the default.
/JOURN
/JOURN
/NOJOURN (D)
Controls whether SED makes a journal of your editing session.
/JOURN starts a journal into which SED logs all the commands and text
typed during an editing session. The journal file (SEDJRN.TMP) can
be used to recover your work after a system crash. See /RECOV.
/NOJOURN stops journaling, if it was in effect. This is the default.
/KEYPAD
/KEYPAD (D)
/NOKEYPAD
This qualifier applies only to VT100 and VT52 terminals.
/KEYPAD tells SED to put your terminal's keypad in alternate keypad
mode. This is the default on VT100 terminals. The keypad to the
right of the keyboard is then used as a set of function keys, rather
than a numeric keypad.
/NOKEYPAD takes your terminal's keypad out of alternate keypad mode.
The keys can then be used as a numeric keypad.
/LENG
/LENG=n (D=24, usually)
Causes SED to think your terminal is n lines long. Good for limiting
the amount of information written on a slow terminal. The default
for n is the number of lines displayable on your terminal, usually
24.
/LMAR
LMAR=n (D=1)
/LMAR=n - Sets the left margin to be column n. Default is 1.
/MESSAGE
/MESSAGE (D)
/NOMESSAGE
/MESSAGE causes an identifying "; This is file ..." line to be
inserted automatically as the first line of a new file.
/NOMESSAGE suppresses the identifying line (and the cheery "Hi! This
is SED..." message normally displayed when there is no file to edit).
/OUT
/OUT=filespec
Changes the name of the file being edited (or being set to, if the
qualifier is given in a <SET-FILE> or DCL level SED command) to be
FILESPEC.
/PAGE
/PAGE
/NOPAGE (D)
Controls how the <SWITCH> command displays the current line number.
/PAGE causes <SWITCH> to output your position as PAGE-LINE from the
start of file. Pages are delimited by formfeeds (^L).
/NOPAGE causes <SWITCH> to output your position as the total number
of LINES from the start of file. This is the default.
/PROG
/PROG=filespec
The /PROG qualifier establishes a program, DCL command, or Command
Procedure to be executed upon exiting from SED. The qualifier may be
included as part of the SED command at command level or it may be
placed in the SED.INI file. The program to execute can also be
established while in SED using the <ENTER>program<SWITCH> sequence.
If the sequence <ENTER><EXIT> is used, the default program to run is
SYS$BYU:COMPIL. For more information on COMPIL, type the DCL command
"HELP COMPIL".
Some examples of this qualifier appear below:
/PROG=RUNOFF will cause RUNOFF to be run upon exiting from SED.
/PROG=$command will cause the DCL command "command" to be
executed upon exiting. "Command" must not include any imbedded
blanks or any trailing qualifiers. For example, /PROG=$DIRECTORY
will cause SED to execute the DCL DIRECTORY command upon exiting.
/PROG=@command_procedure will cause the DCL command procedure
"command_procedure" to be executed upon exiting. For example,
/PROG=@SYS$COM:TMOUNT.COM will cause the TMOUNT command procedure in
the system command procedure library to be executed.
/QUICK
/QUICK
/NOQUICK (D)
Controls the initial display of a file on the screen.
/QUICK suppresses the initial display of a file on your terminal's
screen after a DCL level SED command or a <SET-FILE> command. This
is useful on a slow terminal when you are not interested in what is
on the first page of the file.
/NOQUICK allows SED to display the first page of the file. This is
the default.
/RAISE
/RAISE (D)
/NORAISE
Controls how the <CASE> commands works, if /NOINVRT is set.
/RAISE tells <CASE> to change lower case letters to upper case.
/NORAISE tells <CASE> to change upper case letters to lower case.
/RCUR
/RCUR may be used with <SET-FILE>. It causes the current filespecs,
rather than the alternate specs, to be replaced by the given ones.
Useful for "keeping your finger" in one file (the alternate) while
looking at several others.
/READ
/READ makes the file read-only. /READ is the opposite of /WRITE.
/RECOV
/RECOV
/NORECOV (D)
Controls whether SED starts a normal editing session, or reconstructs
a file using the journal from an inadvertently (as in a system
crash!) aborted SED session.
Typing SED/RECOV at DCL command level tells SED to recover the
previous editing session using the journal. See /JOURN.
/RESET
/RESET (D)
/NORESET
Controls whether the starting nominals for parameters are reset after
each command.
/RESET causes the starting nominal parameters to be reset after each
command. Thus, <ENTER>5<INSERT-LINE><INSERT-LINE> will insert 6
lines. This is the default.
/NORESET - do not reset starting nominal parameters after each
command. Thus, <ENTER>5<INSERT-LINE><INSERT-LINE> will insert 10
lines.
/RMAR
/RMAR=n (D=80, usually)
/RMAR=n - Sets the right margin to be column n. Default is the width
of the screen (usually 80).
/ROLL
/ROLL (D)
/NOROLL
Controls what happens when you type <RETURN> on the last line of the
screen.
/ROLL causes the text on the screen to roll one line if the cursor is
at the bottom of the screen and you type <RETURN>.
/NOROLL causes the cursor to move to the top of the screen if the
cursor is at the bottom of the screen and you type <RETURN>. The
text on the screen does not roll.
/SAVE
/SAVE=n
/NOSAVE or /SAVE=0 (D)
Causes an incremental save of your file every n characters of typein.
Default is n=0 (i.e., no incremental saves).
/ISAVE and /SAVE can be used together. When the counter for either
one reaches its limit, the file is saved, and both counters are
reset.
/SCROLL
/SCROLL
/NOSCROLL (D)
Controls what happens when you type <CURSOR-DOWN> on the last line of
the screen or <CURSOR-UP> on the first line of the screen.
/SCROLL causes the text on the screen to scroll one line if the
cursor is at the bottom (or top) of the screen and you type
<CURSOR-DOWN> (or <CURSOR-UP>).
/NOSCROLL causes the cursor to wrap around on the screen instead of
scrolling any text. For example, a <CURSOR-DOWN> on the last line of
the screen moves the cursor to the first line of the screen.
Likewise, a <CURSOR-UP> on the first line of the screen moves the
cursor to the last line of the screen. This is the default.
/SHOW
/SHOW
/NOSHOW (D)
Controls the display on your screen while <EXECUTE> is working.
/SHOW causes the effects of an <EXECUTE> command to be displayed
while it is working.
/NOSHOW updates the screen only when the <EXECUTE> is done. This is
the default.
/SLIDE
/SLIDE=n (D=8)
/NOSLIDE
Controls the <SLIDE-LEFT> and <SLIDE-RIGHT> commands.
/SLIDE=n enables the <SLIDE-LEFT> and <SLIDE-RIGHT> commands. If the
optional value n is specified, is sets the default number of columns
to slide (or to /RESET to). The starting default for n is 8.
/NOSLIDE disables the <SLIDE-LEFT> and <SLIDE-RIGHT> commands.
/SLIDE=0 is equivalent to /NOSLIDE.
/TABS
/TABS
/TABS=n (D=8)
/TABS=W or /NOTABS
/TABS=S
Controls the way <TAB> and <BACKTAB> move.
/TABS makes <TAB> and <BACKTAB> use the usual tab positions.
/NOTABS or /TABS=W sets up word-wise TABS.
/TABS=n sets up tab stops every n positions (clears all previously
set tabs first). The default is /TABS=8. For additional tailoring
of tab stops, use /TSET.
/TABS=S restores all previously set tabs (including /TSET ones).
(This option is useful after /TABS=W.)
/TERM
/TERM=type
/TERM=type allows the user to specify the type of terminal he/she is
using. The qualifier may be specified as part of the SED command at
DCL command level or it may be included in the SED.INI file.
If SED cannot determine your terminal type, and /TERM is not present
on the command line or in the initialization file, the editor will
check for the logical name SED_TERMINAL which should be equated to
your terminal type using the abbreviations for various terminals
listed below. This logical can also be equated to your terminal type
in the LOGIN.COM file.
If after checking for the above settings, SED still cannot determine
your terminal type, it will use the default system log-in setting
which can be seen by using the DCL command "SHOW TERMINAL."
The "type" on the /TERM qualifier can be VT100, VT52, or FT1
(Televideo 910), INF200 (Infoton 200), RAM6211 (Ramtek 6211 graphics
terminal), Visual 200 configured in VT52+ mode (VIS200).
/TSET
/TSET=n
/NOTSET=n
Sets or clears a tab stop.
/TSET=n sets a tab stop at column n on the screen.
/NOTSET=n can be used to clear the tab (if any) at column n on the
screen.
/UPPER
/UPPER
/NOUPPER (D)
Controls whether lower case typein is converted to upper case.
/UPPER causes all alphabetic characters to be converted to upper case.
This is useful on a terminal whose shift lock shifts all characters,
like the VT100.
/NOUPPER leaves characters in whatever case you type them. This is the
default.
/WIDTH
/WIDTH=n (D=80, usually)
/WIDTH=n causes SED to think the terminal is n characters wide. Good
for terminals which can change their widths, like the VT100. (The
VT100 has both 80 and 132 column display modes.)
The default is the current width of your screen (as shown by the DCL
command "SHOW TERM/WIDTH"), which is usually 80.
/WRITE
/WRITE (D)
/NOWRITE (same as /READ)
Controls whether you can change the contents of the file you are
looking at.
/WRITE allows the current file to be altered. This is the default.
/NOWRITE (which is the same as /READ) makes commands which change the
file become illegal, so the file cannot be modified accidentally.
/X
/X=NAME=txt
/X=NAME=txt is used in SED.INI to set up an execute buffer named NAME
with contents txt.