Document revision date: 19 July 1999
[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

Table 2-15 lists the keys that you can use with the WPS ruler. These keys are enabled in the ruler regardless of how the keys are defined otherwise.

Table 2-15 WPS Ruler Keys
WPS Style Keys Effects Within the Ruler
I or i Sets the paragraph indent to the current column. Does not reformat existing text. A paragraph indent set with the ruler is independent of the left margin; set with the SET PARAGRAPH INDENT command, it is relative to the left margin.
L or l Sets the left margin to the current column. Does not reformat existing text.
P or p Same as I.
R or r Sets the right margin to the current column. Does not reformat existing text.
S or s Saves ruler settings, prompting for the ruler number (0--9).
T or t Sets or deletes a tab stop at the current column. The new tab stops are immediately applied to the buffer you are editing.
W or w Sets the WPS-style wrap point to the current column.
!@#$%^&*() Saves settings in ruler number 0--9. For example, type ! for ruler 1, @ for ruler 2, and so on. Rulers are not saved from session to session.
1234567890 Recalls the ruler of that number. Only one ruler can be active at a time.
<- Moves the cursor one column to the left in the ruler.
-> Moves the cursor one column to the right in the ruler.
Ctrl/E Moves the cursor to the end of the ruler.
Ctrl/H or
BACKSPACE
Moves the cursor to the start of the ruler.
KP0 (WPS Advance) Sets the direction of the ruler to FORWARD and moves the cursor one column to the right in the ruler.
KP1 (WPS Backup) Sets the direction of the ruler to REVERSE and moves the cursor one column to the left in the ruler.
KP2 (WPS Line) Moves the cursor to the start or end of the ruler, depending on the direction of the ruler. The default direction is FORWARD.
KP4 (WPS Word) Moves the cursor to the next or previous setting indicator (L, P, R, or T), depending on the direction of the ruler.
TAB Moves the cursor to the next or previous tab stop indicator (T), depending on the direction of the ruler.
HELP or
GOLD-H
Displays a help topic on Ruler Keys, which lists the keys you can use within the ruler.
RETURN or
GOLD-RETURN
Exits from the ruler, applying your new settings, and resumes editing.

Related Commands


SET LEFT MARGIN


Format

SET LEFT MARGIN integer


Parameter

integer

The column at which you want the left margin. The default is 1 (leftmost column). The left margin must be less than the right margin. 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.

Description

The SET LEFT MARGIN command sets the left margin of the current buffer to the column you specify. EVE starts a new line at the left margin when you press Return or use FILL commands or when EVE wraps text automatically. Setting the margins does not change existing lines but affects only new lines or text you reformat with CENTER LINE or FILL commands.

The left margin is a buffer-specific setting; you can have a different left margin for each buffer. To find out the current margins of the buffer, use the SHOW command.

You can also use the WPS Ruler key (GOLD-R) to set the left margin and right margin. In DECwindows, you can choose Set Margins from the Format menu or the Option menu in Motif EVE.

If you want a particular left margin for all or most editing sessions, put the SET LEFT MARGIN command in an initialization file (EVE$INIT.EVE). When you use that initialization file to invoke EVE, 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.

If you use the SET PARAGRAPH INDENT command, the sum of the left margin and the paragraph indent must be less than the right margin and (in the case of a negative indent) must be at least 1. For example, if the paragraph indent is --4, the left margin must be at least 5.

Related Commands


Example

The following commands set the left margin to 5 and then reformat the current paragraph according to the new margin:

Command: SET LEFT MARGIN 5
Command: FILL PARAGRAPH
      


SET NOCLIPBOARD


Format

SET NOCLIPBOARD


Description

The SET NOCLIPBOARD command disables the DECwindows clipboard for copying, cutting, and pasting text, and enables the INSERT HERE buffer in EVE. This is the default. For a list of the commands and key that use the clipboard, see Table 2-7.

Enabling the clipboard lets you transfer text between EVE and other DECwindows applications. However, for routine editing within EVE, it may be faster to use the INSERT HERE buffer, depending on the amount of text involved. WPS keys do not use the clipboard, regardless of the setting.


SET NODEFAULT COMMAND FILE


Format

SET NODEFAULT COMMAND FILE


Description

The SET NODEFAULT COMMAND FILE command cancels the default command file set with the SET DEFAULT COMMAND FILE command. It does not determine the command file executed at startup, but only the command file created for saving attributes and menu entries. This is the default.

In effect, SET NODEFAULT COMMAND FILE makes one of the following the default command file:


SET NODEFAULT SECTION FILE


Format

SET NODEFAULT SECTION FILE


Description

The SET NODEFAULT SECTION FILE command cancels the default section file set with the SET DEFAULT SECTION FILE command. It does not determine the section file executed at startup, but only the section file created when you save your customizations. This is the default.

The following table shows the effects of SET NODEFAULT SECTION FILE depending on whether you enabled or disabled the section file prompts for saving attributes:
Prompt Settings Effects with SET NODEFAULT SECTION FILE
SET SECTION FILE PROMPTING
(default)
When you save attributes, EVE asks whether to save them in a section file. If you respond YES, EVE asks for the name of the section file.
SET NOSECTION FILE PROMPTING When you save attributes, EVE asks whether you want to save them in a command file, without prompting you about saving them in a section file.

These effects apply when you use either SAVE ATTRIBUTES or SAVE SYSTEM ATTRIBUTES or when you save attributes as part of exiting or quitting.

Related Commands


SET NOEXIT ATTRIBUTE CHECK


Format

SET NOEXIT ATTRIBUTE CHECK


Description

The SET NOEXIT ATTRIBUTE CHECK command disables attribute checking on exiting so that EVE does not ask whether to save your customizations. SET NOEXIT ATTRIBUTE CHECK does not apply to the session when you first use it because the setting itself is saved in a section file or DECTPU command file. After you save it, the setting applies to future editing sessions in which you use the relevant section file or command file. See the description of the SAVE ATTRIBUTES command.

Related Commands


SET NOGOLD KEY


Format

SET NOGOLD KEY


Description

The SET NOGOLD KEY command cancels (undefines) the current GOLD key so that you can define it as you wish. This is the default. You can have only one key set as GOLD at a time. If you set the GOLD key other than PF1 and set the EDT keypad or WPS keypad, your GOLD key is used. You can then define PF1 like any other key, or you can use SET NOGOLD KEY to restore PF1 as the GOLD key for the EDT or WPS keypad, canceling your GOLD key.

SET NOGOLD KEY does not cancel or undefine GOLD key sequeneces, but they cannot be executed unless another key is set as GOLD, either by using the SET GOLD KEY command or by setting the EDT or WPS keypad.

Related Commands


Example

In the following example, you set F20 as the GOLD key and then enable the EDT keypad, which ordinarily uses PF1 as the GOLD key. The SET NOGOLD KEY command then cancels F20, making PF1 the GOLD key.

Command: SET GOLD KEY F20
Command: SET KEYPAD EDT
Command: SET NOGOLD KEY
GOLD key restored to PF1 in the EDT keypad.
      


SET NOJOURNALING


Format

SET NOJOURNALING buffer


Parameter

buffer

The buffer for which you want to disable the creation of a buffer-change journal file. If you do not specify a buffer name, EVE prompts for one. Pressing the Return key or the Do key at the prompt without typing anything cancels the operation.

Description

The SET NOJOURNALING command disables buffer-change journaling for the buffer you specify. By default, EVE creates a journal file for each text buffer you create. You can disable journaling for a buffer in which you do not have to protect text against loss from a system failure (for example, a "scratchpad" buffer used to test procedures or a read-only buffer that contains text you want to view without editing).

SET NOJOURNALING does not delete the journal file for the buffer. To delete the journal file, use the DELETE command.

Related Commands


SET NOJOURNALING ALL


Format

SET NOJOURNALING ALL


Description

The SET NOJOURNALING ALL command disables buffer-change journaling for all your text buffers. By default, EVE creates a journal file for each text buffer you create. You can disable buffer-change journaling if you want to rely on keystroke journaling (enabled by using the /JOURNAL qualifier and specifying a journal file when you invoked EVE). Disabling buffer-change journaling may improve performance, depending on the type of edits you make. However, it risks losing your work in case of a system failure during your editing session.

To disable journaling for a particular buffer, use the SET NOJOURNALING command and specify the buffer name. If you want to disable buffer-change journaling for all your buffers, put the SET NOJOURNALING ALL command in an initialization file (EVE$INIT.EVE).

SET NOJOURNALING ALL disables the creation of new journal files but does not delete existing journal files. To delete the journal files, use the DELETE command.

Related Commands


SET NOPENDING DELETE


Format

SET NOPENDING DELETE


Description

The SET NOPENDING DELETE command disables erasing of selected text when you use the DELETE command or type new text. This is the default. If you select text in the buffer, typing new text adds characters to the select range; using DELETE erases only the character left of the cursor. In other words, if pending delete is disabled, using DELETE and typing new text characters work the same whether there is a select range or not.

The setting applies to all buffers.

Related Commands


SET NOSECTION FILE PROMPTING


Format

SET NOSECTION FILE PROMPTING


Description

The SET NOSECTION FILE PROMPTING command disables prompting for a section file in which to save attributes and other customizations. The following table shows the effects of SET NOSECTION FILE PROMPTING, depending on whether you set a default section file.
Section File Settings Effects with SET NOSECTION
FILE PROMPTING
SET DEFAULT SECTION FILE When you save attributes, EVE saves them in your default section file.
SET NODEFAULT SECTION FILE When you save attributes, EVE asks whether you want to save them in a command file, bypassing any prompts about saving them in a section file.

You can disable section-file prompting to exit from EVE quickly or to save attributes faster. You can also disable section-file prompting if you prefer to save attributes in a DECTPU command file, which uses less disk space than a section file. For more information, read the online help topic on Attributes.

Related Commands


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


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


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


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_012.HTML