THE Reference - SET Commands

SET COMMAND REFERENCE

SET ARBCHAR - set arbitrary character(s) for targets
Syntax:: [SET] ARBchar ON|OFF [char1] [char2]
Description:: Set the character to use as an 'arbitrary character' in string targets. The first arbitrary character matches a group of zero or more characters, the second will match exactly one character.
Compatibility:: XEDIT: Compatible.; Single arbitrary character not supported.; KEDIT: Compatible.
Default:: Off $ ?
Status:: Incomplete. Multiple arbitrary character matching is not implemented.

SET AUTOSAVE - set autosave period
Syntax:: [SET] AUtosave n|OFF
Description:: The SET AUTOSAVE command sets the interval between automatic saves of the file, or turns it off altogether. The interval n refers to the number of alterations made to the file. Hence a value of 10 for n would result in the file being automatically saved after each 10 alterations have been made to the file.
Compatibility:: XEDIT: Does not support [mode] option.; KEDIT: Compatible.
Default:: OFF
Status:: Complete.

SET BACKUP - indicate if a backup copy of the file is to be kept
Syntax:: [SET] BACKup OFF|TEMP|KEEP|ON
Description:: The SET BACKUP command allows the user to determine if a backup copy of the original file is to be kept when the file being edited is saved or filed.; KEEP and ON options are the same. ON is kept for compatability with previous versions of THE.; With OFF , the file being written to disk will replace an existing file. There is a chance that you will end up with neither the old version of the file or the new one if problems occur while the file is being written.; With TEMP or KEEP options, the file being written is first renamed to the filename with a .bak extension. The file in memory is then written to disk. If TEMP is in effect, the backup file is then deleted.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: KEEP
See Also:: FILE, FFILE, SAVE, SSAVE
Status:: Complete.

SET BEEP - turn on or off the audible alarm when displaying errors
Syntax:: [SET] BEEP ON|OFF
Description:: The SET BEEP command allows the user to determine if an audible alarm is sounded when an error is displayed.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: OFF
Status:: Complete.

SET CASE - set case sensitivity parameters
Syntax:: [SET] CASE Mixed|Lower|Upper [Respect|Ignore] [Respect|Ignore] [Respect|Ignore]
Description:: The CASE command sets the editor 's handling of the case of text.'; The first option (which is mandatory) controls how text is entered by the user. When 'LOWER' or 'UPPER' are in effect, the shift or caps lock keys have no effect on the text being entered. When 'MIXED' is in effect, text is entered in the case set by the use of the shift and caps lock keys.; The second option determines how the editor determines if a string target matches text in the file when the target is used in a LOCATE command. With 'IGNORE' in effect, a match is found irrespective of the case of the target or the found text. The following strings are treated as equivalent: the THE The ThE... With 'RESPECT' in effect, the target and text must be the same case. Therefore a target of 'The' only matches text containing 'The' , not 'THE' or 'ThE' etc.; The third option determines how the editor determines if a string target matches text in the file when the target is used in a CHANGE command. With 'IGNORE' in effect, a match is found irrespective of the case of the target or the found text. The following strings are treated as equivalent: the THE The ThE... With 'RESPECT' in effect, the target and text must be the same case. Therefore a target of 'The' only matches text containing 'The' , not 'THE' or 'ThE' etc.; The fourth option determines how the editor determines the sort order of upper and lower case with the SORT command. With 'IGNORE' in effect, upper and lower case letters are treated as equivalent. With 'RESPECT' in effect, upper and lower case letters are treated as different values and uppercase characters will sort before lowercase characters.
Compatibility:: XEDIT: Adds support for case significance in CHANGE commands.; KEDIT: Adds support for LOWER option.; Both: Adds support for case significance in SORT command.
Default:: Mixed Ignore Respect Respect
Status:: Complete

SET CLEARSCREEN - indicate if the screen is to be cleared on exit
Syntax:: [SET] CLEARScreen ON|OFF
Description:: The SET CLEARSCREEN command allows the user to request that the screen be cleared on exit from THE.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: OFF
Status:: Complete

SET CLOCK - turn on or off display of time on status line
Syntax:: [SET] CLOCK ON|OFF
Description:: The SET CLOCK command turns on or off the display of the time on the status line .
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: ON
Status:: Complete

SET CMDARROWS - sets the behaviour of the up and down arrow keys
Syntax:: [SET] CMDArrows Retrieve|Tab
Description:: The SET CMDARROWS command determines the action that occurs when the up and down arrows keys are hit while on the command line .; 'RETRIEVE' will set the up and down arrows to retrieve the last or next command entered on the command line .; 'TAB' will set the up and down arrows to move to the last or first line respectively of the main window.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: RETREIVE
See Also:: CURSOR, ?
Status:: Complete.

SET CMDLINE - sets the position of the command line.
Syntax:: [SET] CMDline ON|OFF|Top|Bottom
Description:: The SET CMDLINE command sets the position of the command line , either at the top of the screen, the bottom of the screen or off.
Compatibility:: XEDIT: Compatible.; CMDLINE ON is equivalent to CMDLINE Bottom; KEDIT: Compatible.
Default:: BOTTOM
Status:: Complete.

SET COLOUR - set colours for display
Syntax:: [SET] COLOUR area [modifier[...]] [foreground] [on] [background]; [SET] COLOR area [modifier[...]] [foreground] [on] [background]
Description:: The SET COLOUR command changes the colours or display attributes of various display areas in THE.; Valid values for area :; Arrow - command line prompt; Block - marked block; CBlock - current line if in marked block; Cmdline - command line; CTofeof - as for TOfeof if the same as current line; CUrline - the current line; Divider - dividing line between vertical split screens; Filearea - area containing file lines; Idline - line containing file specific info; Msgline - error messages; Nondisp - Non-display characters ( SET ETMODE OFF); Pending - pending commands in prefix area; PRefix - prefix area; Reserved - default for reserved line; Scale - line showing scale line; SHadow - hidden line marker lines; STatarea - line showing status of editing session; Tabline - line showing tab positions; TOfeof - Top-of-File line and Bottom-of-File line; Valid values for foreground and background :; BLAck; BLUe; Brown; Green; GRAy; GREy; Cyan; RED; Magenta; Pink; Turquoise; Yellow; White; Valid values for modifier :; NORmal; BLInk; BOld; BRIght; High; REVerse; Underline; It is an error to attempt to set a colour on a mono display.
Compatibility:: XEDIT: Functionally compatible. See below.; KEDIT: Functionally compatible. See below.; Does not implement all modifiers.
Default:: Depends on compatibility mode setting and monitor type.
See Also:: SET COMPAT
Status:: Complete.

SET COMPAT - set compatibility mode
Syntax:: [SET] COMPat The|Xedit|Kedit
Description:: The SET COMPAT command changes some settings of THE to make it more compatible with the behaviour of XEDIT and KEDIT.; This command is most useful as the first SET command in a profile file. It will change the default settings of THE to initially look like the chosen editor. You can then make any additional changes in THE by issuing other SET commands.; It is recommended that this command NOT be executed from the command line, particularly if you have 2 files being displayed at the same time. Although the command works, things may look and behave strangely :-)
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: THE
Status:: Complete.

SET CURLINE - set position of current line on screen
Syntax:: [SET] CURLine M[+n|-n] | [+|-]n
Description:: The SET CURLINE command sets the position of the current line to the physical screen line specified by supplied arguments.; The first form of parameters is:; M[+n|-n]; this sets the current line to be relative to the middle of; the screen. A positive value adds to the middle line number,; a negative subtracts from it.; eg. M+3 on a 24 line screen will be line 15; M-5 on a 24 line screen will be line 7; The second form of parameters is:; [+|-]n; this sets the current line to be relative to the top of the; screen (if positive or no sign) or relative to the bottom; of the screen if negative.; eg. +3 or 3 will set current line to line 3; -3 on a 24 line screen will be line 21; If the resulting line is outside the bounds of the screen the position of the current line will become the middle line on the screen.; It is an error to try to position the CURLINE on the same line as a line already allocated by one of SET HEXSHOW , SET RESERVED , SET SCALE or SET TABLINE .
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: M
Status:: Complete.

SET CURSORSTAY - set on or off the behaviour of the cursor on a scroll
Syntax:: [SET] CURSORSTay ON|OFF
Description:: The SETCURSORSTAY command allows the user to set the behaviour of the cursor when the file is scrolled with a FORWARD or BACKWARD command.; Before this command was introduced, the position of the cursor after the file was scrolled depended on SET COMPAT ; for THE, the cursor moved to the current line, for XEDIT and KEDIT modes the cursor stayed on the same screen line.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: ON
Status:: Complete.

SET DIRINCLUDE - set the file mask for directory command
Syntax:: [SET] DIRInclude *; [SET] DIRInclude [Normal] [Readonly] [System] [Hidden] [Directory]
Description:: The DIRINCLUDE command sets the file mask for files that will be displayed on subsequent DIRECTORY commands. The operand "*" will set the mask to all files, the other options will set the mask to include those options specified together with "normal" files eg.; DIRINCLUDE R S; will display readonly and system files together with "normal" files the next time the DIRECTORY command is issued.; The effects of DIRINCLUDE are ignored in the Unix version.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: *
See Also:: DIRECTORY, LS
Status:: Complete.

SET DISPLAY - specify which level of lines to display
Syntax:: [SET] DISPlay n [m|*]
Description:: The SET DISPLAY command sets the selection level for lines to be displayed on the screen.
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: 0 0
See Also:: SET SCOPE, SET SELECT, ALL
Status:: Complete.

SET EOLOUT - set end of line terminating character(s)
Syntax:: [SET] EOLout CRLF|LF|CR|NONE
Description:: The EOLOUT command allows the user to specify the combination of characters that terminate a line. Lines of text in Unix files are usually terminated with a LF , DOS file usually end with a CR and LF combination. Files on the Apple Macintosh are usually terminated with a CR .; The NONE option can be used to specifiy that no end of line character is written.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: LF - Unix,; CRLF - DOS/OS2; NONE - if THE started with -u option
Status:: Complete.

SET ETMODE - indicate if extended display mode is possible
Syntax:: [SET] ETMODE ON|OFF [character list]
Description:: The SET ETMODE command allows the user to specify which characters in a character set are to be displayed as their actual representation.; Those characters not explicitly specified to be displayed as they are represented, will be displayed as the SET NONDISP character in the colour specified by SET COLOUR NONDISP. Characters below 32, will be displayed with an alphabetic character representing the "control" code.; eg. character code with a value of 7, will display as "G" in the colour specified by SET COLOUR NONDISP.; ON with no optional character list will display ALL characters as their actual representation.; OFF with no optional character list will display characters below 32, as a "control" character; characters greater than 126 will be displayed as the SET NONDISP characters.; The character list is a list of positive numbers between 0 and 255 (inclusive). The format of this character list can be either a single number; eg. 124, or a range of numbers specified; eg. 32-126. (The first number must be less than or equal to the second number).; As an example; ETMODE ON 32-127 160-250 would result in the characters with a decimal value between 32 and 127 inclusive and 160 and 250 inclusive being displayed as their actual representation (depending on the current font), and the characters between 0 and 31 inclusive, being displayed as an equivalent "control" character; characters between 128 and 159 inculsive and 250 to 255 being displayed with the SET NONDISP character.; Up to 20 character specifiers (single number or range) can be specified.
Compatibility:: XEDIT: Similar function but deals with Double-Byte characters; KEDIT: N/A
Default:: DOS/OS2; ON; X11; ON 32-255; UNIX; OFF
See Also:: SET NONDISP, SET COLOUR
Status:: Complete.

SET HEX - set how hexidecimal strings are treated in string operands
Syntax:: [SET] HEX ON|OFF
Description:: The SET HEX set command determines whether hexidecimal strings are treated as such in string operands.; With the ON option, any string operand of the form /x '31 32 33' / or /d '49 50 51' / will be converted to /123/ before the command is executed.; With the OFF option, no conversion is done.; This conversion should work wherever a string operand is used in any command.
Compatibility:: XEDIT: Adds support for decimal representation. See below.; KEDIT: Compatible. See below.; Spaces must seperate each character representation.
Default:: OFF
Status:: Complete.

SET HEXDISPLAY - turn on or off display of character under cursor
Syntax:: [SET] HEXDISPlay ON|OFF
Description:: The SET HEXDISPLAY command turns on or off the display of the character under the cursor on the status line .
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: ON
Status:: Complete

SET HEXSHOW - turn on or off hex display of current line
Syntax:: [SET] HEXShow ON|OFF [M[+n|-n]|[+|-]n]
Description:: The SET HEXShow command indicates if and where a hexidecimal representation of the current line will be displayed.; The first form of parameters is:; M[+n|-n]; this sets the hexshow line to be relative to the middle of; the screen. A positive value adds to the middle line number,; a negative subtracts from it.; eg. M+3 on a 24 line screen will be line 15; M-5 on a 24 line screen will be line 7; The second form of parameters is:; [+|-]n; this sets the hexshow line to be relative to the top of the; screen (if positive or no sign) or relative to the bottom; of the screen if negative.; eg. +3 or 3 will set current line to line 3; -3 on a 24 line screen will be line 21; If the resulting line is outside the bounds of the screen the position of the hexshow line will become the middle line on the screen.; The position argument specifies the position of the first line of the hexidecimal display.; It is an error to try to position the HEXSHOW lines on the same line as SET CURLINE .
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: OFF 7
Status:: Complete

SET IDLINE - specify if IDLINE is displayed
Syntax:: [SET] IDline ON|OFF
Description:: The SET IDLINE set command determines if the idline for a file is displayed or not.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: ON
Status:: Complete

SET IMPCMSCP - set implied operating system command processing
Syntax:: [SET] IMPcmscp ON|OFF
Description:: The SET IMPCMSCP command is used to toggle implied operating system command processing from the command line. By turning this feature on you can then issue an operating system command without the need to prefix the operating system command with the OS command.
Compatibility:: XEDIT: Compatible.; KEDIT: N/A
Default:: ON
See Also:: SET IMPOS
Status:: Complete.

SET IMPMACRO - set implied macro command processing
Syntax:: [SET] IMPMACro ON|OFF
Description:: The SET IMPMACRO command is used to toggle implied macro processing from the command line. By turning this feature on you can then issue a macro command without the need to prefix the macro name with the MACRO command.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: ON
See Also:: MACRO, SET MACROPATH
Status:: Complete.

SET IMPOS - set implied operating system command processing
Syntax:: [SET] IMPOS ON|OFF
Description:: The SET IMPOS command is used to toggle implied operating system command processing from the command line. By turning this feature on you can then issue an operating system command without the need to prefix the operating system command with the OS command.
Compatibility:: XEDIT: Compatible.; KEDIT: N/A
Default:: ON
See Also:: SET IMPCMSCP
Status:: Complete.

SET INSERTMODE - put editor into or out of insert mode
Syntax:: [SET] INSERTMode ON|OFF|TOGGLE
Description:: The SET INSERTMODE command enable the user to set the insert mode within THE.; The TOGGLE option turns insert mode ON if it is currently OFF and vice versa.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: OFF
Status:: Complete.

SET LINEND - allow/disallow multiple commands on command line
Syntax:: [SET] LINENd ON|OFF [character]
Description:: The SET LINEND command allows or disallows the execution of multiple commands on the command line . When setting LINEND ON, a character is specified as the LINEND character which delimits each command.
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: OFF #
Status:: Complete.

SET MACROEXT - set default macro extension value
Syntax:: [SET] MACROExt [ext]
Description:: The SET MACROEXT command sets the value of the file extension to be used for macro files. When a macro file name is specified on the command line , a period '.' , then this value will be appended. If no value is specified for ext , then THE assumes that the supplied macro file name is the fully specified name for a macro.; The length of ext must be 10 characters or less.; The macro extension is only appended to a file if that file does not include any path specifiers.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: the
Status:: Complete.

SET MACROPATH - set default path for macro commands
Syntax:: [SET] MACROPath path[s]
Description:: The SET MACROPATH command sets up the search path from which macro command files are executed. Each directory is seperated by a colon (Unix) or semi-colon (DOS & OS/2). No check is done at this stage to validate the supplied path.
Compatibility:: XEDIT: N/A; KEDIT: Incompatible.
Default:: Path specified by env variable THE_MACRO_PATH
See Also:: MACRO, SET IMPMACRO
Status:: Complete.

SET MARGINS - set left and right margins for wordwrap
Syntax:: [SET] MARgins left right [[+|-]indent]
Description:: The SET MARGINS command sets the left and right margins and the number of columns to indent a paragraph.; These values are used with the SET WORDWRAP option.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: 1 72 +0
See Also:: SET WORDWRAP
Status:: Complete.

SET MSGLINE - set position and size of message line
Syntax:: [SET] MSGLine ON M[+n|-n]|[+|-]n [lines] [Overlay]
Description:: The SET MSGLINE set command specifies the position of the message line and the size of the message line window.; The first form of parameters is:; M[+n|-n]; this sets the first line to be relative to the middle of; the screen. A positive value adds to the middle line number,; a negative subtracts from it.; eg. M+3 on a 24 line screen will be line 15; M-5 on a 24 line screen will be line 7; The second form of parameters is:; [+|-]n; this sets the first line to be relative to the top of the; screen (if positive or no sign) or relative to the bottom; of the screen if negative.; eg. +3 or 3 will set current line to line 3; -3 on a 24 line screen will be line 21; If the resulting line is outside the bounds of the screen the position of the message line will become the middle line on the screen.
Compatibility:: XEDIT: Compatible.; The OVERLAY option is the default but ignored.; KEDIT: Compatible; The OVERLAY option is the default but ignored.
Default:: ON 2 5 Overlay
Status:: Complete

SET MSGMODE - set display of messages on or off
Syntax:: [SET] MSGMode ON|OFF
Description:: The SET MSGMODE set command determines whether error messages will be displayed or suppressed.
Compatibility:: XEDIT: Does not support [Short|Long] options.; KEDIT: Compatible
Default:: ON
Status:: Complete

SET NEWLINES - set position of cursor after adding blank line
Syntax:: [SET] NEWLines Aligned|Left
Description:: The SET NEWLINES set command determines where the cursor displays after a new line is added to the file.; With 'ALIGNED' , the cursor will display in the column of the new line immediately underneath the first non-blank character in the line above. With 'LEFT' , the cursor will display in the first column of the new line.
Compatibility:: XEDIT: N/A; KEDIT: Same command, different functionality.
Default:: Aligned
Status:: Complete

SET NONDISP - specify character to display for non-displaying characters
Syntax:: [SET] NONDisp character
Description:: The SET NONDISP command allows the user to change the character that is displayed for non-displaying commands when SET ETMODE is OFF.
Compatibility:: XEDIT: Compatible.; KEDIT: N/A
Default:: #
See Also:: SET ETMODE
Status:: Complete.

SET NUMBER - turn prefix numbers on or off
Syntax:: [SET] NUMber ON|OFF
Description:: The SET NUMBER command allows the user to toggle the display of numbers in the prefix area .
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: ON
See Also:: SET PREFIX
Status:: Complete.

SET PENDING - set status of pending prefix commands
Syntax:: [SET] PENDing ON string; [SET] PENDing OFF; [SET] PENDing BLOCK string
Description:: The SET PENDING command allows the user to insert or remove commands from the pending prefix list.; ON string, simulates the user typing string in the prefix area of the focus line .; OFF, removes any pending prefix command from the focus line.; BLOCK string, simulates the user typing string in the PREFIX area of the focus line and identifies the prefix command to be a BLOCK command.
Compatibility:: XEDIT: Does not support ERROR option.; KEDIT: N/A
Status:: Complete.

SET POINT - assign a name to the current line
Syntax:: [SET] Point .name [OFF]
Description:: The SET POINT command assignes the specified name to the focus line , or removes the name from the line with the specified name. A valid line name must start with a '.' followed by an alphabetic character. eg. .a .fred and .GG are valid names; fred and .3 are invalid line names.; When a line is moved within the same file, its line name stays with the line.
Compatibility:: XEDIT: Compatible. See below.; KEDIT: Compatible. See below.; Does not allow for multiple names for the same line.
Status:: Complete.

SET POSITION - determine if LINE/COL is displayed on idline
Syntax:: [SET] POSition ON|OFF
Description:: The SET POSITION command allows the user to turn on or off the display of LINE/COL on the idline .
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: ON
Status:: Complete.

SET PREFIX - set prefix area attributes
Syntax:: [SET] PREfix ON [Left|Right]; [SET] PREfix Nulls [Left|Right]; [SET] PREfix OFF; [SET] PREfix Synonym newname oldname
Description:: The first form of the SET PREFIX command allows the user to display the prefix area and optionally to select the position were the prefix should be displayed.; The second form of the SET PREFIX command is functionally the same as the first form. The difference is that when the prefix area is displayed with SET NUMBER ON, numbers are displyed with leading spaces rather than zeros; with SET NUMBER OFF, blanks are displayed instead of equal signs.; The third form, turns the display of the prefix area off. Executed from within the profile, the only effect is that the defaults for all files is changed. Executed from the command line, the SET PREFIX command changes the current window displays to reflect the required options.; The fourth form of the SET PREFIX command allows the user to specify a synonym for a prefix command or REXX prefix macro. The newname is the command entered in the prefix area and oldname corresponds to an existing prefix command or a REXX macro file in the MACROPATH ending in .the or whatever the value of SET MACROEXT is at the time the prefix command is executed. The oldname can also be the fully qualified filename of a REXX macro.
Compatibility:: XEDIT: Compatible. See below.; KEDIT: Compatible. See below.
Default:: ON Left
Status:: Complete.

SET PRINTER - define printer spooler name
Syntax:: [SET] PRINTER spooler
Description:: The SET PRINTER command sets up the print spooler name to determine where output from the PRINT command goes.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: LPT1 - DOS/OS2, lpr - Unix
See Also:: PRINT
Status:: Complete.

SET REPROFILE - indicate if profile file to be executed for all files
Syntax:: [SET] REPROFile ON|OFF
Description:: The SET REPROFILE command allows the user to determine if the profile file is to reexecuted for files subsequenlty edited.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: OFF
See Also:: XEDIT, EDIT, THE
Status:: Complete

SET RESERVED - display a reserved line
Syntax:: [SET] RESERved *|+|-n [colour] [text|OFF]
Description:: The SET RESERVED command reseves a line for the display of arbitrary text by the user. The position is determined by +|-n. This number, if positive, specifies the line relative from the top of the display. A negative number is relative from the bottom of the display.; By specifying a line, say +3, then the third line from the top will be reserved, with the supplied text being displayed in that line.; The idline of a file will always be displayed after any reserved lines.; The status line is not considered part of the displayable area, so any positioning specifications ignore that line.; A reserved line can only be turned off by identifying it in the same way that it was defined. If a reserved line was added with the position specification of -1, it cannot be turned off with a position specification of 23, even though both position specifiers result in the same display line.; All reserved lines may be turned of by specifying * as the number of lines.; The colour option specifies the colours to use to display the reserved line. The format of this colour specifier is the same as for SET COLOUR . If no colour is specified, the colour of the reserved line will be the colour set by any SET COLOUR RESERVED command for the view or white on black by default.; It is an error to try to reserve a line which is the same line as SET CURLINE .
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
See Also:: SET COLOUR
Status:: Complete.

SET REXXOUTPUT - indicate where REXX output is to go
Syntax:: [SET] REXXOUTput File|Display n
Description:: The SET REXXOUTPUT command indicates where output from the REXX interpreter is to go; either captured to a file in the ring or displayed in a scrolling fashion on the screen.; Also specified is the maximum number of lines from the REXX interpreter that are to be displayed or captured. This is particularly useful when a REXX macro gets into an infinite loop.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: Display 1000
Status:: Complete.

SET SCALE - set position and status of scale line on screen
Syntax:: [SET] SCALe ON|OFF [M[+n|-n]|[+|-]n]
Description:: The SET SCALE command sets the position and status of the scale line for the current view.; The first form of parameters is:; M[+n|-n]; this sets the scale line to be relative to the middle of; the screen. A positive value adds to the middle line number,; a negative subtracts from it.; eg. M+3 on a 24 line screen will be line 15; M-5 on a 24 line screen will be line 7; The second form of parameters is:; [+|-]n; this sets the scale line to be relative to the top of the; screen (if positive or no sign) or relative to the bottom; of the screen if negative.; eg. +3 or 3 will set current line to line 3; -3 on a 24 line screen will be line 21; If the resulting line is outside the bounds of the screen the position of the current line will become the middle line on the screen.; It is an error to try to position the SCALE line on the same line as SET CURLINE .
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: OFF M+1
Status:: Complete.

SET SCOPE - sets which lines are to be excluded from commands
Syntax:: [SET] SCOPE All|Display
Description:: The SET SCOPE command indicates whether lines not displayed as the result of a SET DISPLAY or ALL command are included in the scope of lines to be acted upon by other THE commands.
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: Display
See Also:: SET DISPLAY, SET SELECT, ALL
Status:: Completed.

SET SCREEN - specifiy number of screens displayed
Syntax:: [SET] SCReen n [Horizontal|Vertical]
Description:: The SET SCREEN command specifies the number of views of file(s) to display on screen at once. If the number of views specified is 2 and only one file is currently in the ring , two views of the same file are displayed.
Compatibility:: XEDIT: Does not support Size,Width or Define options.; KEDIT: Does not support Size option.; Only 2 screens are supported.
Default:: 1
Status:: Complete.

SET SELECT - sets the selection level for the specified lines
Syntax:: [SET] SELect [+|-]n [target]
Description:: The SET SELECT command sets the selection level for the indicated lines equal to n (if no signs are specified) or adds or subtracts n from the selection level currently set for the lines in the target.
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: 0
See Also:: SET SCOPE, SET DISPLAY, ALL
Status:: Complete.

SET SHADOW - determines if shadow lines are displayed or not
Syntax:: [SET] SHADOW ON|OFF
Description:: The SET SHADOW command indicates whether shadow line s are to be displayed.
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: ON
See Also:: SET DISPLAY, SET SELECT, ALL
Status:: Completed.

SET STATUSLINE - set position of status line
Syntax:: [SET] STATUSLine Top|Bottom|Off|GUI
Description:: The SET STATUSLINE command determines the position of the status line for the editing session. TOP will place the status line on the first line of the screen; BOTTOM will place the status line on the last line of the screen; OFF turns off the display of the status line.; The GUI option is only meaningful for those platforms that support a separate status line window. If specified for non-GUI ports, the GUI option is equivalent to OFF.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.; Added GUI option for THEdit port.
Default:: Bottom
Status:: Complete

SET STAY - set condition of cursor position after CHANGE/LOCATE commands
Syntax:: [SET] STAY ON|OFF
Description:: The SET STAY set command determines what line is displayed as the current line after an unsuccessful LOCATE or successful CHANGE command.; With STAY ON, the current line remains where it currently is.; With STAY OFF, after an unsuccessful LOCATE , the current line becomes the Bottom-of-File line (or Top-of-File line if direction is backwards).; After a successful CHANGE , the current line is the last line affected by the CHANGE command.
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: ON
Status:: Complete

SET SYNONYM - define synonyms for commands
Syntax:: [SET] SYNonym ON|OFF; [SET] SYNonym [LINEND char] newname [n] oldname
Description:: The SET SYNONYM command allows the user to define synonyms for commands or macros.; The first format indicates if synonym processing is to be performed.; The second format specifies the synonym to be associated with the following command.
Compatibility:: XEDIT: Does not support the formatting option.; KEDIT: Compatible.
Default:: ON
Status:: Incomplete.

SET TABKEY - set characteristics of the SOS TABF command
Syntax:: [SET] TABKey Tab|Character Tab|Character
Description:: The SET TABKEY sets the action to be taken when the SOS TABF command is executed. Depending on the insert mode, the SOS TABF command will either display a raw tab character or will move to the next tab column.; The first operand refers to the behaviour of the SOS TABF command when SET INSERTMODE is OFF.; The second operand specifies the behaviour when the SOS TABF command is executed when SET INSERTMODE is ON.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: Tab Character
Status:: Complete

SET TABLINE - set position and status of tab line on screen
Syntax:: [SET] TABLine ON|OFF [M[+n|-n]|[+|-]n]
Description:: The SET TABLINE command sets the position and status of the tab line for the current view.; The first form of parameters is:; M[+n|-n]; this sets the tab line to be relative to the middle of; the screen. A positive value adds to the middle line number,; a negative subtracts from it.; eg. M+3 on a 24 line screen will be line 15; M-5 on a 24 line screen will be line 7; The second form of parameters is:; [+|-]n; this sets the tab line to be relative to the top of the; screen (if positive or no sign) or relative to the bottom; of the screen if negative.; eg. +3 or 3 will set current line to line 3; -3 on a 24 line screen will be line 21; If the resulting line is outside the bounds of the screen the position of the current line will become the middle line on the screen.; It is an error to try to position the TABL line on the same line as SET CURLINE .
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: OFF -3
Status:: Complete.

SET TABS - set tab columns or tab length
Syntax:: [SET] TABS n1 [n2 ... n32]; [SET] TABS INCR n
Description:: The SET TABS command determines the position of tab columns in THE.; The first format of SET TABS, specifies individual tab columns. Each column must be greater than the column to its left.; The second format specifies the tab increment to use. ie each tab column will be set at each n columns.; Tab columns are used by SOS TABF and SOS TABB commands to position the cursor and also by the COMPRESS and EXPAND commands.
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: INCR 8
Status:: Complete.

SET TABSIN - set tab processing on file input
Syntax:: [SET] TABSIn ON|OFF [n]
Description:: The SET TABSIN command determines if tabs read from a file are to be expanded to spaces and if so how many spaces.
Compatibility:: XEDIT: N/A; KEDIT: Does not support TABQUOTE option.
Default:: OFF 8
See Also:: SET TABSOUT
Status:: Complete.

SET TABSOUT - set tab processing on file output
Syntax:: [SET] TABSOut ON|OFF [n]
Description:: The SET TABSOUT command determines if spaces written to a file are to be compressed to tabs and if so how many spaces.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: OFF 8
See Also:: SET TABSIN
Status:: Complete.

SET TYPEAHEAD - set behavior of screen redraw
Syntax:: [SET] TYPEAhead ON|OFF
Description:: The SET TYPEAHEAD set command determines whether or not THE uses the curses screen display optimization techniques.; With TYPEAHEAD ON, curses will abort screen display if a keystroke is pending.; With TYPEAHEAD OFF, curses will not abort screen display if a keystroke is pending.; For BSD based curses, this function has no effect.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: OFF
Status:: Complete.

SET VERIFY - set column display limits
Syntax:: [SET] Verify first [last]
Description:: The SET VERIFY command sets the column limits for the display of the current file. first specifies the first column to be displayed and last specifies the last column to be displayed.; If no last option is specified '*' is assumed.
Compatibility:: XEDIT: Does not implement HEX display nor multiple column pairs.; KEDIT: Does not implement HEX display nor multiple column pairs.
Default:: 1 *
See Also:: SET ZONE
Status:: Complete.

SET WORDWRAP - set wordwrap feature on or off
Syntax:: [SET] WORDWrap ON|OFF
Description:: The SET WORDWRAP set command determines whether wordwrap occurs when the cursor moves past the right margin (as set by the SET MARGINS command).; With WORDWRAP ON, the line, from the beginning of the word that exceeds the right margin, is wrapped onto the next line. The cursor position stays in the same position relative to the current word.; WIth WORDWRAP OFF, no word wrap occurs.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: OFF
See Also:: SET MARGINS
Status:: Complete.

SET XTERMINAL - set X terminal to execute under X
Syntax:: [SET] XTERMinal program
Description:: The SET XTERMINAL set command allows the user to specify the full quallified file name of the program to run when the OS , DOS or ! command is entered without parameters when running the X version of THE.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: System dependent but usually one of:
Status:: Complete.

SET ZONE - set column limits for editing
Syntax:: [SET] Zone first [last]
Description:: The SET ZONE command sets the column limits for various other editor commands, such as LOCATE and CHANGE . It effectively restricts to the specified columns those parts of the file which can be acted upon.; If no last option is specified '*' is assumed.
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: 1 *
See Also:: SET VERIFY
Status:: Complete.

Return to Table of Contents