Document revision date: 30 March 2001
[Compaq] [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]
[OpenVMS documentation]

Extensible Versatile Editor Reference Manual


Previous Contents Index


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:

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:

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:

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:

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:

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:

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
      


Previous Next Contents Index

  [Go to the documentation home page] [How to order documentation] [Help on this site] [How to contact us]  
  privacy and legal statement  
6021PRO_013.HTML