 |
Extensible Versatile Editor Reference Manual
SET NOWRAP
Format
SET NOWRAP
Description
The SET NOWRAP command disables automatic word wrapping in the current
buffer so that as you type a new word past the right margin, your text
can go past the right margin. You can disable word wrap when you are
editing very long lines, such as wide multicolumn tables or lengthy
program statements that are progressively indented. To reformat text
while leaving wrap disabled, use FILL commands.
To enable wrapping, use the SET WRAP command, which is the default. As
you type at the end of a line, EVE automatically starts a new line when
your text reaches the right margin, without your having to press the
Return key or use FILL commands.
Wrapping is a buffer-specific setting; you can disable and enable
wrapping for the current buffer without affecting other buffers.
Related Commands
FILL
SET RIGHT MARGIN
SET WRAP
SHOW
Example
The following commands turn off wrapping so you can enter wide text
and, later, turn it on again:
|
Command: SET NOWRAP
Wrapping disabled in this buffer.
.
.
.
Command: SET WRAP
Text in this buffer will wrap at the right margin.
|
SET PARAGRAPH INDENT
Format
SET PARAGRAPH INDENT [--]integer
Parameter
integer
The number of spaces to be added or subtracted to the start of
paragraphs, relative to the left margin of the buffer. If the value is
positive (or unsigned), the sum of the left margin and paragraph indent
must be less than the right margin. A negative value produces a
"hanging" paragraph; its first line starts left of the left
margin. The algebraic sum of a negative indent and the left margin must
be at least 1. If you do not specify a paragraph indent, EVE prompts
for one. Pressing the Return key or the Do key at the prompt without
typing anything cancels the operation. The default setting is 0 (no
indent).
Description
The SET PARAGRAPH INDENT command sets the number of spaces to be added
or subtracted at the start of paragraphs relative to the left margin in
the current buffer. SET PARAGRAPH INDENT does not change existing text,
but affects only paragraphs you create or reformat with FILL commands.
Paragraph boundaries are any of the following:
- Blank line
- Bottom or top of the buffer
- Page break (form feed at the start of a line)
- DIGITAL Standard Runoff (DSR) command at the start of a line (for
example, .BREAK)
- VAX DOCUMENT tag at the start of a line (for example, <LE>)
Paragraph indent is a buffer-specific setting; you can have a different
setting for each buffer.
If you want a particular paragraph indent for all or most editing
sessions, put the SET PARAGRAPH INDENT command in an initialization
file (EVE$INIT.EVE). When you use that initialization file to invoke
EVE, the setting then applies to the MAIN (or first) buffer and to an
EVE system buffer named $DEFAULTS$, so that each buffer you create has
the same paragraph indent.
Paragraph indent set by command is relative to the left margin of the
buffer; set with the WPS Ruler key (GOLD-R), it is independent of the
margin.
If the paragraph indent is other than 0 (the default setting), you
cannot use FILL or FILL RANGE commands to reformat a range that does
not begin at the beginning of a paragraph. Also, EVE does not reformat
a line that begins with a DSR command, VAX DOCUMENT tag, or page break.
The SET FILL TAGS command lets FILL reformat lines that start with a
DSR command or a VAX DOCUMENT tag. The default setting is SET FILL
NOTAGS, which does not let you fill those lines.
Related Commands
FILL
FILL PARAGRAPH
FILL RANGE
SET FILL TAGS
SET LEFT MARGIN
Examples
The following examples show how to set a paragraph indent, including a
negative indent for a hanging paragraph:
The following command sets the paragraph indent at 4 columns from the
left margin. Thus, if your left margin is 5, the first line of a new
paragraph will start at column 9 and the remaining lines in column 5.
To reformat existing text according to the new setting, use FILL or
FILL PARAGRAPH.
| #1 |
Command: SET PARAGRAPH INDENT 4
|
The next command sets the left margin at column 4 and the paragraph
indent at three columns to the left of the left margin. Thus, the first
line of a new paragraph starts in column 1 and the rest of the lines in
column 4. This is a hanging paragraph.
| #2 |
Command: SET LEFT MARGIN 4
Command: SET PARAGRAPH INDENT -3
.
.
.
Command: SET PARAGRAPH INDENT 0
Command: SET LEFT MARGIN 1
|
In restoring your previous settings, note the order of the commands
(paragraph indent 0, left margin 1). Reversing the order would produce
an error with SET LEFT MARGIN 1 because the sum of the paragraph indent
(--3) and the new left margin is less than 1.
SET PENDING DELETE
Format
SET PENDING DELETE
Description
The SET PENDING DELETE command enables deletion of a select range when
you use DELETE or type new text. Pending delete is useful for quickly
erasing or replacing a block of text.
To insert what you erased, use RESTORE SELECTION or RESTORE BOX
SELECTION.
The default is SET NOPENDING DELETE. If you have selected text, using
DELETE erases the character left of the cursor; typing new text inserts
the new characters.
The setting applies in all buffers. To save your setting for future
editing sessions, use SAVE ATTRIBUTES to create a section file or to
create or update a command file. For more information, read the online
help topic on Attributes.
Using the SELECT ALL command temporarily disables pending delete to
prevent you from accidentally erasing all of the buffer.
For more information about pending delete, read the online help topic
on Pending Delete.
Related Commands
BOX SELECT
RESTORE BOX SELECTION
RESTORE SELECTION
SELECT
SET BOX SELECT
SET NOPENDING DELETE
SET RIGHT MARGIN
Format
SET RIGHT MARGIN integer
Parameters
integer
The column at which you want the right margin. The integer must be
greater than the left margin (or greater than the sum of the left
margin and the paragraph indent). If you do not specify a number, EVE
prompts for one. Pressing the Return key or the Do key at the prompt
without typing anything cancels the operation.
The default right margin is one column less than the screen width. The
width is 80 columns; the default right margin is then 79.
Description
The SET RIGHT MARGIN command sets the right margin of the current
buffer to the column you specify. Setting margins does not change
existing lines but affects only new lines or text you reformat with
CENTER LINE or FILL commands. When EVE wraps text automatically, or
when you use FILL commands, no characters will go beyond the right
margin.
You can set different margins for each buffer you edit. To find out the
current margins of the buffer, use the SHOW command.
You can also set the right margin and left margin by using the WPS
Ruler key (GOLD-R).
If you want a particular right margin for all or most editing sessions,
put the SET RIGHT MARGIN command in an initialization file
(EVE$INIT.EVE). When you use that initialization file to invoke EVE,
the setting then applies to the MAIN (or first) buffer and to an EVE
system buffer named $DEFAULTS$, so that each buffer you create has the
same left margin.
The SET WIDTH command makes the right margin of the $DEFAULTS$ buffer
one column less than the width you specify but does not affect the
margins of other existing buffers.
Related Commands
CENTER LINE
FILL
SET LEFT MARGIN
SET WIDTH
SET WRAP
Example
The following command sets the right margin to 65. To reformat existing
text according to the new margin, use FILL commands.
|
Command: SET RIGHT MARGIN 65
|
SET SCROLL JUMP
Format
SET SCROLL JUMP
Description
The SET SCROLL JUMP command causes new text to be repainted in your
window instead of scrolled into your window. SET SCROLL JUMP sets
scrolling operations to first scroll the text that will remain in your
window, leaving part of your window empty. The operation finishes by
displaying the new text in the empty region in a single repaint
operation. This makes for slightly faster scrolling than with SET
SCROLL SMOOTH (which is the default) because only part of your window
is scrolled.
You can set scrolling behavior to jump or smooth regardless of your
terminal scroll setting. For example, if you set your terminal to
Smooth Scroll and use SET SCROLL JUMP, text slides smoothly out of the
window (the effect of the terminal setting), and new text is repainted
in one operation (the effect of SET SCROLL JUMP).
This setting has no effect if you use SET SCROLL OFF.
The setting applies in all your buffers. To save your setting for
future editing sessions, use SAVE ATTRIBUTES to create a section file
or to create or update a command file. For more information, read the
online help topic on Attributes.
In DECwindows, you can toggle this setting as follows:
- Choose Global Attributes from the Options menu
- Click on the Set Scroll Jump button in the dialog box
The opposite setting (SET SCROLL SMOOTH) repaints new text, line by
line, as it is brought into the window.
Related Commands
SET SCROLL MARGINS
SET SCROLL OFF
SET SCROLL ON
SET SCROLL SMOOTH
SET SCROLL MARGINS
Format
SET SCROLL MARGINS integer1[%] integer2[%]
Parameters
integer1
The number of lines down from the top of a window at which you want
scrolling to begin. You cannot overlap the bottom scroll margin
(integer2). The default setting is 0. Scrolling starts when
you move past the top of the window. If you do not specify a value, EVE
prompts for one. Pressing the Return key or the Do key at the prompt
without typing anything keeps the current value.
integer2
The number of lines up from the bottom of a window at which you want
scrolling to begin. You cannot overlap the top scroll margin
(integer1). The default setting is 0. Scrolling starts when
you move past the bottom of the window. If you do not specify a value,
EVE prompts for one. Pressing Return or Do at the prompt without typing
anything keeps the current value.
%
Percent sign, specifying that scroll margins are percentages of the
window height, rounded to the nearest line.
Description
The SET SCROLL MARGINS command sets the top and bottom distances at
which scrolling begins automatically as you move the cursor up and
down. You specify the distances as numbers of lines or as percentages
of the window size. Scroll margins apply to all windows in EVE. If you
specify the scroll margins as numbers of lines, EVE converts them to
percentages of the window size, so that if you resize the window (for
example, by using SPLIT WINDOW), the scroll margins are proportional to
the window size.
Scroll margins apply in all buffers but are not saved in a section file
or command file. To keep your settings for future editing sessions, put
SET SCROLL MARGINS in an initialization file (EVE$INIT.EVE).
Examples
The following examples show how to use numbers of lines and percentages
to set scroll.
To set the scroll margins at two lines from the top and three lines
from the bottom of the window, use the following command:
| #1 |
Command: SET SCROLL MARGINS 2 3
|
To set the scroll margins at 9 percent from the top and 14 percent from
the bottom of the window, use the following command:
| #2 |
Command: SET SCROLL MARGINS 9% 14%
|
With a 21-line window, the top scroll margin is 2 lines down and the
bottom scroll margin is 3 lines up.
SET SCROLL OFF
Format
SET SCROLL OFF
Description
The SET SCROLL OFF command disables scrolling of text as new text is
brought into the window. With scrolling disabled, the window is
repainted each time new text is brought into the window.
The setting applies in all your buffers. To save your setting for
future editing sessions, use SAVE ATTRIBUTES to create a section file
or to create or update a command file. For more information, read the
online help topic on Attributes.
In DECwindows, you can toggle this setting as follows:
- Choose Global Attributes from the Options menu
- Click on the Set Scroll Off button in the dialog box
The opposite setting (SET SCROLL ON) scrolls new text as it is brought
into the window.
Related Commands
SET SCROLL JUMP
SET SCROLL MARGINS
SET SCROLL ON
SET SCROLL SMOOTH
SET SCROLL ON
Format
SET SCROLL ON
Description
The SET SCROLL ON command enables scrolling of text as new text is
brought into the window. With scrolling enabled, you cause new text to
scroll into the window when you perform one of the following actions:
- Move to a position that is off screen by less than (approximately)
one window's length. You move to that position by using navigation
commands (FIND, MOVE BY PAGE, PREVIOUS SCREEN, and so on), by
positioning with the mouse, or by using vertical scroll bars in
DECwindows EVE.
- Move above the top scroll margin or below the bottom scroll margin
in a window by using one of the previous methods.
- Erase, add, or format text that causes new text to be brought into
the window.
This setting does not affect moving to a position off screen by more
than (approximately) one window's length. In this case, the entire
window is repainted with the new text.
The setting applies in all your buffers. To save your setting for
future editing sessions, use SAVE ATTRIBUTES to create a section file
or to create or update a command file. For more information, read the
online help topic on Attributes.
In DECwindows, you can toggle this setting as follows:
- Choose Global Attributes from the Options menu
- Click on the Set Scroll On button in the dialog box
The opposite setting (SET SCROLL OFF) repaints the window each time a
scroll would otherwise occur.
Related Commands
SET SCROLL JUMP
SET SCROLL MARGINS
SET SCROLL OFF
SET SCROLL SMOOTH
SET SCROLL SMOOTH
Format
SET SCROLL SMOOTH
Description
The SET SCROLL SMOOTH command causes each new line of text to scroll
into your window. This makes for slightly slower scrolling than with
SET SCROLL JUMP, which scrolls only part of your window before
repainting all new text in one operation.
This setting has no effect if you use SET SCROLL OFF.
The setting applies in all your buffers. To save your setting for
future editing sessions, use SAVE ATTRIBUTES to create a section file
or to create or update a command file. For more information, read the
online help topic on Attributes.
In DECwindows, you can toggle this setting as follows:
- Choose Global Attributes from the Options menu
- Click on the Set Scroll Smooth button in the dialog box
Related Commands
SET SCROLL JUMP
SET SCROLL MARGINS
SET SCROLL OFF
SET SCROLL ON
SET SECTION FILE PROMPTING
Format
SET SECTION FILE PROMPTING
Description
The SET SECTION FILE PROMPTING command enables prompting for a section
file in which to save attributes and other customizations. This is the
default. When you use the SAVE ATTRIBUTES or SAVE SYSTEM ATTRIBUTES
command or when you save attributes as part of exiting or quitting, EVE
prompts you whether to save your customizations in a section file. The
following table shows the effects of SET SECTION FILE PROMPTING,
depending on whether you set a default section file for saving
customizations.
|
Section File Settings
|
Effects with SET SECTION
FILE PROMPTING
|
SET NODEFAULT SECTION FILE
(default)
|
When you save attributes, EVE asks whether you want to save them in a
section file. If you respond YES, EVE asks for the name of the section
file.
|
|
SET DEFAULT SECTION FILE
|
When you save attributes, EVE asks whether you want to save them in a
section file. If you respond YES, EVE saves them in your default
section file.
|
For more information, read the online help topic on Attributes.
Related Commands
SAVE ATTRIBUTES
SET NOSECTION FILE PROMPTING
SET SELECTION GRAB FOCUS
Format
SET SELECTION GRAB FOCUS
Description
The SET SELECTION GRAB FOCUS command causes EVE to grab the Motif
primary selection when you give EVE input focus. Using SET SELECTION
GRAB FOCUS causes EVE to conform to the Motif Style Guide
"focus-based" model for moving the primary selection among applications.
When you create a primary selection in another application, EVE loses
the primary selection. EVE saves the current selection and removes the
highlighting from the selected text.
If SET SELECTION GRAB FOCUS is in effect, then when you give EVE the
input focus, EVE grabs the primary selection and restores the
selection, if any, that was active when it lost the primary selection.
The alternate behavior is to grab the primary selection only when you
select text. See help on SET SELECTION GRAB SELECTION.
Related Commands
SET SELECTION GRAB SELECTION
SET SELECTION GRAB SELECTION
Format
SET SELECTION GRAB SELECTION
Description
The SET SELECTION GRAB SELECTION command causes EVE to grab the Motif
primary selection when you select text. This is the default setting in
the Motif DECwindows environment. Using SET SELECTION GRAB SELECTION
causes EVE to conform to the Motif Style Guide
"selection-based" model for moving the primary selection
among applications.
When you create a primary selection in another application, EVE loses
the primary selection. EVE saves the current selection and removes the
highlighting from the selected text.
If SET SELECTION GRAB SELECTION is in effect, then EVE grabs the
primary selection only when you select text. To restore the saved
selection, press Ctrl/Shift/Select (a key defined with the SET FUNCTION
KEYS MOTIF command). The saved selection will be restored correctly
only if the current position is the same as when EVE lost the primary
selection.
The alternate behavior is to grab the primary selection when you give
EVE the input focus. See help on SET SELECTION GRAB FOCUS.
Related Commands
SET SELECTION GRAB FOCUS
SET TABS
Format
SET TABS {AT integer1 [integer2...] |EVERY integer |INSERT |INVISIBLE
|MOVEMENT |SPACES |VISIBLE}
Parameters
AT integer1 [integer2...]
The column or columns at which you want a tab stop in the current
buffer. The new tab stops are applied to any tab characters already in
the buffer. Enter the numbers in ascending order, separated by spaces.
If you do not specify a number, EVE prompts for one. Pressing the
Return key or the Do key at the prompt without typing anything cancels
the operation.
EVERY integer
The interval for all tab stops in the current buffer. The new tab stops
are applied to any tab characters already in the buffer. If you do not
specify a number, EVE prompts for one. Pressing Return or Do at the
prompt without typing anything cancels the operation. The default
setting is EVERY 8; that is, tab stops are set at columns 9, 17, 25,
33, and so on.
INSERT
Makes TAB insert a tab character, pushing the cursor and existing text
to the next tab stop. The setting applies to all buffers. This is the
default.
INVISIBLE
Makes tab characters invisible, appearing as blank space. The setting
applies to all buffers. This is the default.
You can specify only one keyword per command. If you do not specify a
keyword, EVE prompts for one. Pressing Return or Do at the prompt
without typing anything cancels the operation.
MOVEMENT
Makes TAB move the cursor to the next tab stop, without inserting
anything. The cursor stays on the current line and can move into the
unused portion of the buffer, even if the cursor is set to bound. The
setting applies to all buffers. This is useful for moving through
tab-aligned text, such as tables and multicolumn lists.
SPACES
Makes TAB insert the appropriate number of spaces, instead of a tab
character, pushing the cursor and any existing text on the line to the
next tab stop. The setting applies to all buffers but does not affect
existing tabs; for example, it does not convert tab characters
to spaces. This is useful for editing text to be printed or displayed
on different devices because the spacing will be the same regardless of
the tab stops set for the printer or display device.
VISIBLE
Makes tab characters visible, appearing as a small HT (horizontal tab).
The setting applies to all buffers. Visible tabs are an editing
convenience only; the setting does not affect how tab
characters appear when the text is printed.
Description
The SET TABS command sets tab stops for the buffer (AT or EVERY), tab
modes (INSERT, MOVEMENT, or SPACES), or the appearence of tab
characters during editing (INVISIBLE or VISIBLE). Tab stops are
buffer-specific settings; you can have different tab stops for each
buffer. Changing the tab stops affects any tab characters already in
the buffer. To find out the current tab stops of the buffer, use the
SHOW command.
You can also set tab stops by using the WPS Ruler key (GOLD R).
If you want particular tab stops for all or most editing sessions, put
the SET TABS AT or SET TAB EVERY command in an initialization file
(EVE$INIT.EVE). When you use that initialization file to invoke EVE,
the settings then apply to the MAIN (or first) buffer and to an EVE
system buffer named $DEFAULTS$ so that each buffer you create has the
same tab stops.
Tab mode and visibility apply in all buffers. To save your settings
(for example, if you always want tab characters visible), use SAVE
ATTRIBUTES to create a section file or to create or update a command
file. For more information, read the online help topic on Attributes.
Tab stops are not stored in the output file. Therefore, in printing or
typing the file, tab-aligned text may not appear the same as during
editing, depending on the tab stops set for the printer or display
device. You may want to use the CONVERT TABS command to convert tab
characters to spaces. For more information, see the description of the
CONVERT TABS command.
Related Commands
CONVERT TABS
SAVE ATTRIBUTES
SHOW
TAB
Examples
To set tab stops at the specified columns in the current buffer, use
the following command:
| #1 |
Command: SET TABS AT 6 11 20 36
|
This example changes any tab characters already in the buffer. After
you use this command, any tab characters added after column 36 do not
push existing text to the right because there is no tab stop after
column 36.
To set the TAB function to insert spaces instead of a tab character and
to make existing tab characters visible, use the following commands:
| #2 |
Command: SET TABS SPACES
Command: SET TABS VISIBLE
|
|
