THE Reference - SET Commands

SET COMMAND REFERENCE

SET ALT - change alteration counts
Syntax:: [SET] ALT [n] [m]
Description:: The SET ALT command allows the user to change the alteration counts. This command is usually called from within a macro.; The first number; n sets the number of changes since the last AUTOSAVE was issued.; The second number; m sets the number of changes since the last SAVE or SSAVE command was issued.; All options can be specified as the current EQUIVCHAR to retain the existing value.
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: OFF
See Also:: SET EQUIVCHAR
Status:: Complete.

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.; All options can be specified as the current EQUIVCHAR to retain the existing value.
Compatibility:: XEDIT: Compatible.; Single arbitrary character not supported.; KEDIT: Compatible.; Arbitrary character not supported in CHANGE or SCHANGE commands.
Default:: Off $ ?
See Also:: SET EQUIVCHAR
Status:: Complete.

SET AUTOCOLOR - specifies which parser to use for syntax highlighting
Syntax:: [SET] AUTOCOLOR mask parser [MAGIC]
Description:: The SET AUTOCOLOR command allows the user to specify which syntax highlighting parser is to be used for which file masks.; The parser argument specifies a syntax highlighting parser that already exists, either as a default parser , or added by the user with SET PARSER . The special parser name of '*NULL' can be specified; this will effectively remove the association between the parser and the file mask.; The mask argument specifies the file mask (or magic number ) to associate with the specified parser. The mask can be any valid file mask for the operating system. eg *.c fred.* joe.?; If the magic option is specified, the mask argument refers to the last element of the magic number that is specified in the first line of a Unix shell script comment. eg if the first line of a shell script contains: #!/usr/local/bin/rexx then the file mask argument would be specified as "rexx".
Compatibility:: XEDIT: N/A; KEDIT: Similar. KEDIT does not have MAGIC option.
Default:: See QUERY AUTOCOLOR
See Also:: SET COLORING, SET ECOLOUR, SET PARSER
Status:: Complete.

SET AUTOCOLOUR - specifies which parser to use for syntax highlighting
Syntax:: [SET] AUTOCOLOUR mask parser [MAGIC]
Description:: The SET AUTOCOLOUR command is a synonym for the SET AUTOCOLOR command.
Compatibility:: XEDIT: N/A; KEDIT: Similar. KEDIT does not have MAGIC option.
Default:: See QUERY AUTOCOLOR
See Also:: SET AUTOCOLOR
Status:: Complete.

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.; It is not possible to set AUTOSAVE for 'pseudo' files such as the directory listing 'file' , Rexx output 'file' and the key definitions 'file'
Compatibility:: XEDIT: Does not support [mode] option.; KEDIT: Compatible.
Default:: OFF
Status:: Complete.

SET AUTOSCROLL - set rate of automatic horizontal scrolling
Syntax:: [SET] AUTOSCroll n|OFF|Half
Description:: The SET AUTOSCROLL allows the user to set the rate at which automatic horizontal scrolling occurs.; When the cursor reaches the last (or first) column of the filearea the filearea can automatically scroll if AUTOSCROLL is not OFF and a CURSOR RIGHT or CURSOR LEFT command is issued. How many columns are scrolled is determined by the setting of AUTOSCROLL.; If AUTOSCROLL is set to HALF , then half the number of columns in the filearea window are scrolled. Any other value will result in that many columns scrolled, or the full width of the filearea window if the set number of columns is larger.; Autoscrolling does not occur if the key pressed is assigned to CURSOR SCREEN LEFT or RIGHT, which is the case if SET COMPAT XEDIT key definitions are active.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: HALF
Status:: Complete.

SET BACKUP - indicate if a backup copy of the file is to be kept
Syntax:: [SET] BACKup OFF|TEMP|KEEP|ON|INPLACE [suffix]
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 compatibility 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.; With INPLACE , the file being written is first copied to a file with a .bak extension. The file in memory is then written to disk in place of the original. This option ensures that all operating system file attributes are retained.; The optional suffix specifies the string to append to the file name of the backup copy including a period if required. The maximum length of suffix is 100 characters. By default this is ".bak".
Compatibility:: XEDIT: N/A; KEDIT: Compatible.; suffix is a THE extension
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 BOUNDMARK - set bounds marker display
Syntax:: [SET] BOUNDMARK OFF|Zone|TRunc|MARgins|TABs|Verify
Description:: The BOUNDMARK command indicates if boundary markers are to be displayed and if so, where. Boundary markers are vertical lines drawn before or after certain columns within the filearea . This command only has a visible effect on GUI platforms, currently only the X11 port.; OFF turns off the display of boundary markers.; ZONE turns on the display of boundary markers, before the zone start column and after the zone end column.; TRUNC turns on the display of boundary markers, after the truncation column. Not supported.; MARGINS turns on the display of boundary markers, before the left margin and after the right margin.; TABS turns on the display of boundary markers, before each tab column.; VERIFY turns on the display of boundary markers, before each verify column. Not supported.
Compatibility:: XEDIT: N/A; KEDIT: Compatible, but no support for TRUNC or VERIFY option.
Default:: Zone
Status:: Incomplete

SET CASE - set case sensitivity parameters
Syntax:: [SET] CASE Mixed|Lower|Upper [Respect|Ignore] [Respect|Ignore] [Respect|Ignore] [Mixed|Lower|Upper] [Mixed|Lower|Upper]
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 in the filearea . 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.; The fifth option controls how text is entered by the user on the command line . The allowed values and behaviour are the same as for the first option.; The sixth option controls how text is entered by the user in the prefix area . The allowed values and behaviour are the same as for the first option.; All options can be specified as the current EQUIVCHAR to retain the existing value.
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
See Also:: SET EQUIVCHAR
Status:: Complete

SET CLEARERRORKEY - specify which key clears the message line
Syntax:: [SET] CLEARErrorkey *|keyname
Description:: The SET CLEARERRORKEY command allows the user to specify which key clears the message line. By default, any key pressed will cause the message line to be cleared. The keyname specified is the name returned via the SHOWKEY command.; As the QUERY command also uses the same mechanism for displaying its results as errors, then this command affects when results from the QUERY command are cleared.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: *
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:: RETRIEVE
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 COLOR - set colors for display
Syntax:: [SET] COLOR area [modifier[...]] [foreground] [ON] [background]; [SET] COLOR area [modifier[...]] ON|OFF; [SET] COLOUR color red blue green; [SET] COLOUR BOLD FONT|BRIGHT
Description:: The SET COLOR command changes the colors or display attributes of various display areas in THE.; Valid values for area :; ALERT - alert boxes; see ALERT; Arrow - command line prompt; Block - marked block; BOUNDmarker - bound markers (GUI platforms only); CBlock - current line if in marked block; CHIghlight - highlighted line if the same as current line; Cmdline - command line; CTofeof - as for TOfeof if the same as current line; CUrline - the current line; CURSORline - the line in filearea that the cursor is or was on; Divider - dividing line between vertical split screens; Filearea - area containing file lines; GAP - the gap between the prefix area and filearea; CGAP - the gap between the prefix area and filearea - current; HIghlight - highlighted line; 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; CPRefix - prefix area if the same as current line; Reserved - default for reserved line; Scale - line showing scale line; SHadow - hidden line marker lines; SLK - soft label keys; STatarea - line showing status of editing session; Tabline - line showing tab positions; TOfeof - Top-of-File line and Bottom-of-File line; DIALOG - background of a dialog box; see DIALOG; DIALOGBORDER - border for a dialog box; DIALOGEDITFIELD - edit field of a dialog box; DIALOGBUTTON - inactive button in a dialog box; DIALOGABUTTON - active button in a dialog box; POPUP - all non-highlighted lines in a popup; see POPUP; POPUPBORDER - border for a popup; POPUPCURLINE - the highlighted line in a popup; POPUPDIVIDER - dividing line in a popup; * - All areas (second format only); Valid values for foreground , background and color :; BLAck; BLUe; Brown; Green; GRAy; GREy; Cyan; RED; Magenta; Pink; Turquoise; Yellow; White; Valid values for modifier :; NORmal; BLInk; BOld; BRIght; High; REVerse; Underline; DARK; Italic - only available on X11 port with valid Italic font, on; Windows with "GUI" PDcurses, and the SDL2 port.; The second format of this command allows the user to turn on or off any of the valid modifiers.; The third format of this command allows the user to change the intensity of specified colors on platforms that support changing the content of a color (X11, SDL2, Windows GUI). The specified color can be changed by supplying the intensity of red, green and blue. These are numeric values between 0 and 1000 inclusive. eg To change red to blue : SET COLOR RED 0 0 1000. All characters being displayed as red will be displayed with the specified intensities. Note that this behaviour is not consistent across platforms, and should be considered experimental at this stage.; The fourth format of this command allows the BOLD modifier to be displayed as an actual bold font, or as a brighter colour than the normal, non-bold colour. This format is only supported on platforms that support different fonts. (SDL2); 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, SET COLOUR, SET ECOLOUR, DIALOG, POPUP
Status:: Complete.

SET COLOUR - set colours for display
Syntax:: [SET] COLOUR area [modifier[...]] [foreground] [on background]; [SET] COLOUR area [modifier[...]] ON|OFF; [SET] COLOUR colour red blue green; [SET] COLOUR BOLD FONT|BRIGHT
Description:: The SET COLOUR command is a synonym for the SET COLOR command.
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 COLOR
Status:: Complete.

SET COLORING - enable or disable syntax highlighting
Syntax:: [SET] COLORING ON|OFF [AUTO|parser]
Description:: The SET COLORING command allows the user to turn on or off syntax highlighting for current file. It also allows the parser used to be specified explicitly, or automatically determined by the file extension or magic number .; ON turns on syntax highlighting for the current file, OFF turns it off.; AUTO determines the parser to use for the current file based on the file extension. The parser to use is controlled by the SET AUTOCOLOR command.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: ON AUTO
See Also:: SET COLOURING, SET ECOLOUR, SET AUTOCOLOR, SET PARSER
Status:: Complete.

SET COLOURING - enable or disable syntax highlighting
Syntax:: [SET] COLOURING ON|OFF [AUTO|parser]
Description:: The SET COLOURING command is a synonym for the SET COLORING command.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: ON AUTO
See Also:: SET COLORING
Status:: Complete.

SET COMPAT - set compatibility mode
Syntax:: [SET] COMPat The|Xedit|Kedit|KEDITW|Ispf|= [The|Xedit|Kedit|KEDITW|Ispf|=] [The|Xedit|Kedit|KEDITW|Ispf|=]
Description:: The SET COMPAT command changes some settings of THE to make it more compatible with the look and/or feel of XEDIT, KEDIT, KEDIT for Windows, or ISPF.; 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 and behave 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 :-); The first parameter affects the look of THE, the second parameter affects the feel of THE, and the third parameter determines which default function key settings you require.; Any of the parameters can be specified as =, which will not change that aspect of THE's compatibility.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: THE THE THE
Status:: Complete.

SET CTLCHAR - define control character attributes
Syntax:: [SET] CTLchar OFF; [SET] CTLchar char Escape | OFF; [SET] CTLchar char Protect|Noprotect [modifier[...]] fore [ON back]
Description:: The SET CTLCHAR command defines control characters to be used when displaying a reserved line . Control characters determine how parts of a reserved line are displayed.; See SET COLOUR for valid values for modifier , fore and back .; The Protect and Noprotect arguments are ignored.
Compatibility:: XEDIT: Similar, but does not support all parameters.; KEDIT: N/A.
Default:: OFF
See Also:: SET COLOUR, SET RESERVED
Status:: Complete.

SET CURLINE - set position of current line on screen
Syntax:: [SET] CURLine [ON] 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.; e.g. 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.; e.g. +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 optional to specify the ON argument.; 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 DEFSORT - specify the order in which files appear in DIR.DIR
Syntax:: [SET] DEFSORT OFF|DIRectory|Size|Date|Time|Name [Ascending|Descending]
Description:: The SET DEFSORT command allows the user to determine the order in which files appear in a DIR.DIR file.; Directory specifies that directories within the current directory are shown before other files.; Size specifies that the size of the file determines the order in which files are displayed.; Date specifies that the date of the last change to the file determines the order in which files are displayed. If the dates are the same, the time the file was last changed is used as a secondary sort key.; Time specifies that the time of the file determines the order in which files are displayed.; Name specifies that the name of the file determines the order in which files are displayed. This is the default. Files are sorted by name as a secondary sort key when any of the above options are specified and two files have equal values for that sort option.; OFF indicates that no ordering of the files in the directory is performed. On directories with a large number of files, this option results in a displayed DIR.DIR file much quicker than any sorted display.; The second parameter specifies if the sort order is ascending or descending.; If this command is issued while the DIR.DIR pseudo file is the current file, the settings are applied immediately.
Compatibility:: XEDIT: N/A; KEDIT: Similar in functionality.
Default:: NAME ASCENDING
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 e.g.; 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 ECOLOR - set colors for syntax highlighting
Syntax:: [SET] ECOLOR char [modifier[...]] [foreground] [on background]; [SET] ECOLOR char [modifier[...]] ON|OFF
Description:: The SET ECOLOR command allows the user to specify the colors of each category of items used in syntax highlighting.; char refers to one of the following valid values:; A - comments; B - strings; C - numbers; D - keywords; E - labels; F - preprocessor directives; G - header lines; H - extra right paren, matchable keyword (N/A); I - level 1 paren; J - level 1 matchable keyword (N/A); K - level 1 matchable preprocessor keyword (N/A); L - level 2 paren, matchable keyword (N/A); M - level 3 paren, matchable keyword (N/A); N - level 4 paren, matchable keyword (N/A); O - level 5 paren, matchable keyword (N/A); P - level 6 paren, matchable keyword (N/A); Q - level 7 paren, matchable keyword (N/A); R - level 8 paren or higher, matchable keyword (N/A); S - incomplete string; T - HTML markup tags; U - HTML character/entity references; V - Builtin functions; W - not used; X - not used; Y - not used; Z - not used; 1 - alternate keyword color 1; 2 - alternate keyword color 2; 3 - alternate keyword color 3; 4 - alternate keyword color 4; 5 - alternate keyword color 5; 6 - alternate keyword color 6; 7 - alternate keyword color 7; 8 - alternate keyword color 8; 9 - alternate keyword color 9; N/A indicates that this capability is not yet implemented.; For valid values for modifier , foreground and background see SET COLOR .; The second format of this command allows the user to turn on or off any of the valid modifiers.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: See QUERY ECOLOR
See Also:: SET COLORING, SET AUTOCOLOR, SET PARSER, SET COLOR
Status:: Complete.

SET ECOLOUR - set colours for syntax highlighting
Syntax:: [SET] ECOLOUR char [modifier[...]] [foreground] [on background]; [SET] ECOLOUR char [modifier[...]] ON|OFF
Description:: The SET ECOLOUR command allows the user to specify the colours of each category of items used in syntax highlighting.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: See QUERY ECOLOR
See Also:: SET COLOURING, SET AUTOCOLOUR, SET PARSER, SET COLOUR
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 specify that no end of line character is written.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: LF - UNIX; CRLF - DOS/OS2/WIN32; NONE - if THE started with -u option
Status:: Complete.

SET EQUIVCHAR - set the equivalence character
Syntax:: [SET] EQUIVChar char
Description:: The SET EQUIVChar command allows the user to change the character that is used to specify equivalence in command parameters.; In many THE commands, an equivalence character, usually '=' , can be used as a parameter to default to values in the current file or view.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: =
Status:: Complete.

SET ERRORFORMAT - set format of error messages
Syntax:: [SET] ERRORFormat Normal|Extended
Description:: The ERRORFORMAT command allows the user to specify if extended information is displayed with error messages. The Normal format is an error number, error text and option arguments following. The Extended format prefixes the Normal format with the command being executed at the time of the error. This assists in tracking down errors inside macros.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: Normal
Status:: Complete.

SET ERROROUTPUT - indicate whether THE error messages are echoed to screen
Syntax:: [SET] ERROROUTput ON|OFF
Description:: With SET ERROROUTPUT OFF, THE error messages are shown in the MSGLINE. With SET ERROROUTPUT ON, THE error messages are also displayed in the window in which THE was started, provided one exists. This is particularly useful when tracing THE macros as the error message is shown afte the invocation of the command that caused the error.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: OFF
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.; e.g. 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 control characters below ASCII 32, as a "control" character; characters greater than ASCII 126 will be displayed as the SET NONDISP characters. On ASCII based machines, [SET] ETMODE OFF is equivalent to [SET] ETMODE ON 32-126. On EBCDIC based machines [SET] ETMODE OFF is equivalent to [SET] ETMODE ON ??-??; 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; e.g. 124, or a range of numbers specified; e.g. 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 inclusive 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:: ON - DOS/OS2/WIN32; ON 32-255 - X11; OFF - UNIX/AMIGA/QNX
See Also:: SET NONDISP, SET COLOUR
Status:: Complete.

SET FILE DISPLAY NAME - change the display filename of the file being edited
Syntax:: [SET] FDISPLAY displayname
Description:: The SET FDISPLAY command allows the user to change the display filename of the file currently being edited as shown on the IDLINE .
Compatibility:: XEDIT: N/A; KEDIT: N/A
See Also:: SET FPATH, SET FNAME, SET FEXT, SET FMODE, SET EQUIVCHAR, SET FDISPLAY
Status:: Complete.

SET FEXT - change the extension of the existing file
Syntax:: [SET] FExt ext; [SET] FType ext
Description:: The SET FEXT command allows the user to change the extension of the file currently being edited. The extension is the characters after the last period.; See SET FILENAME for a full explanation of THE's definitions of fpath, filename, fname, fext and fmode.; It is not possible to use this command on pseudo files.
Compatibility:: XEDIT: N/A; KEDIT: N/A
See Also:: SET FNAME, SET FILENAME, SET FTYPE, SET FMODE
Status:: Complete.

SET FILENAME - change the filename of the file being edited
Syntax:: [SET] FILEName filename
Description:: The SET FILEName command allows the user to change the filename of the file currently being edited.; In THE, a fully qualified file name consists of a file path and a file name. THE treats all characters up to and including the last directory separator (usually / or \) as the file's path. From the first character after the end of the file's path, to the end of the fully qualified file name is the file name.; A file name is further broken down into a fname and fext. The fname of a file consists of all characters from the start of the filename up to but not including the last period (if there is one). The fext of a file consists of all characters from the end of the filename up to but not including the last period. If there is no period in the filename then the fext is empty.; The fmode of a file is equivalent to the drive letter of the file's path. This is only valid under DOS, OS/2 and Windows ports.; Some examples.; A limited amount of validation of the resulting file name is carried out by this command, but some errors in the file name will not be evident until the file is saved.; A leading "=" indicates that the fname portion of the current file name is be retained. This is equivalent to the command SET FEXT . A trailing "=" indicates that the fext portion of the current file name is to be retained. This is equivalent to the command SET FNAME .; Only one "=" is allowed in the parameter.; Some examples.; It is not possible to use this command on pseudo files.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
See Also:: SET FPATH, SET FNAME, SET FEXT, SET FMODE, SET EQUIVCHAR
Status:: Complete.

SET FILETABS - determine if and where where file tabs are positioned
Syntax:: [SET] FILETABS ON|OFF
Description:: The SET FILETABS command allows the user to determine if file tabs are to be displayed and where. FILETABS is a single line at the top of the display showing all files currently in the ring, except the current file. It provides a mechanism where the user running THE with mouse support can simply click on the filename in the FILETABS line to change focus to that file.; The colour of the file tabs can be set with SET COLOUR FILETABS. The colour of the file dividers can be set with SET COLOUR FILETABSDIV.
Compatibility:: XEDIT: N/A; KEDIT: N/A
See Also:: SET COLOUR, TABFILE
Status:: Complete.

SET FMODE - change the drive letter of the existing file
Syntax:: [SET] FMode d[:]
Description:: The SET FMode command allows the user to change the drive letter of the file currently being edited.; This command is only valid under the DOS, OS/2 and Windows ports.; See SET FILENAME for a full explanation of THE's definitions of fpath, filename, fname, fext and fmode.; It is not possible to use this command on pseudo files.
Compatibility:: XEDIT: N/A; KEDIT: Compatible
See Also:: SET FNAME, SET FILENAME, SET FEXT, SET FPATH
Status:: Complete.

SET FNAME - change the filename of the file being edited
Syntax:: [SET] FName filename
Description:: The SET FNAME command allows the user to change the fname of the file currently being edited.; See SET FILENAME for a full explanation of THE's definitions of fpath, filename, fname, fext and fmode.; A limited amount of validation of the resulting file name is carried out by this command, but some errors in the file name will not be evident until the file is saved.; It is not possible to use this command on pseudo files.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
See Also:: SET FPATH, SET FILENAME, SET FEXT, SET FMODE
Status:: Complete.

SET FPATH - change the path of the existing file
Syntax:: [SET] FPath path
Description:: The SET FPATH command allows the user to change the path of the file currently being edited.; The path parameter can be specified with or without the trailing directory separator. Under DOS, OS/2 and Windows ports, the drive letter is considered part of the file's path.; See SET FILENAME for a full explanation of THE's definitions of fpath, filename, fname, fext and fmode.; It is not possible to use this command on pseudo files.
Compatibility:: XEDIT: N/A; KEDIT: N/A
See Also:: SET FNAME, SET FILENAME, SET FEXT, SET FMODE
Status:: Complete.

SET FTYPE - change the extension of the existing file
Syntax:: [SET] FType ext
Description:: The SET FTYPE is a synonym for SET FEXT .
Compatibility:: XEDIT: N/A; KEDIT: N/A
See Also:: SET FNAME, SET FILENAME, SET FEXT, SET FMODE
Status:: Complete.

SET FULLFNAME - specify if complete filename to be displayed
Syntax:: [SET] FULLFName ON|OFF
Description:: The SET FULLFNAME command allows the user to determine if the fully qualified filename is displayed on the IDLINE or just the FNAME component. See SET FILENAME for a full explanation of THE's definitions of fpath, filename, fname, fext and fmode.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: ON
Status:: Complete.

SET HEADER - turn on or off syntax highlighting headers
Syntax:: [SET] HEADer section ON|OFF
Description:: The SET HEADER command allows fine tuning of which sections of a TLD file are to be applied for the current view.; section refers to one of the following headers that can be specified in a TLD file: NUMBER, COMMENT, STRING, KEYWORD, FUNCTION, HEADER, LABEL, MATCH, COLUMN, POSTCOMPARE, MARKUP, DIRECTORY. section can also be specified as '*' , in which case all headers are applied or not applied.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: * ON
See Also:: SET PARSER, SET COLORING, SET AUTOCOLOR
Status:: Complete.

SET HEX - set how hexadecimal strings are treated in string operands
Syntax:: [SET] HEX ON|OFF
Description:: The SET HEX set command determines whether hexadecimal 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 separate 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 hexadecimal 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.; e.g. 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.; e.g. +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 hexadecimal 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 HIGHLIGHT - specify which lines (if any) are to be highlighted
Syntax:: [SET] HIGHlight OFF|TAGged|ALTered|SELect n [m]
Description:: The SET HIGHLIGHT command allows for the user to specify which lines are to be displayed in the highlighted colour.; OFF turns all highlighting display off; TAGGED displays all tagged lines in the highlight colour.; ALTERED displays all lines that have been added or changed in the current session in the highlight colour.; 'SELECT n [m]' displays all lines with the specified selection level in highlight colour.
Compatibility:: XEDIT: N/A; KEDIT: Compatible
Default:: OFF
See Also:: SET SELECT, TAG, SET LINEFLAG
Status:: Ccomplete.

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 set 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 set 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 set 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 INPUTMODE - set input mode behaviour
Syntax:: [SET] INPUTMode OFF|FUll|LIne
Description:: The SET INPUTMODE command changes the way THE handles input.; When INPUTMODE LINE is in effect, pressing the ENTER key while in the filearea will result in a new line being added.; When INPUTMODE OFF is in effect, pressing the ENTER key while in the filearea will result in the cursor moving to the beginning of the next line; scrolling the screen if necessary.; When INPUTMODE FULL is in effect, pressing the ENTER key while in the filearea will result in the cursor moving to the beginning of the next line; scrolling the screen if necessary.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: LINE
See Also:: INPUT
Status:: Incomplete. No support for FULL option.

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 INTERFACE - set overall behaviour of THE
Syntax:: [SET] INTerface CLASSIC|CUA
Description:: The SET INTERFACE command changes the behaviour of several operations within THE. THE normally operates in a block-mode manner, however many applications conform to the Common User Access (CUA) standard developed by IBM. This command specifies that CUA behaviour should occur on various actions during the edit session.; The major differences between CLASSIC and CUA behaviour involve keyboard and mouse actions. Various THE commands have CUA options to allow the user to customise the behaviour individual keys or the mouse to behave in a CUA manner.; Where behaviour is not related to particular key or mouse actions, this command provides the mechanism for changing the behaviour. The behaviour that SET INTERFACE affects:; - entering text in the filearea with a marked CUA block will; first delete the block and reposition the cursor; - executing SOS DELCHAR or SOS DELBACK will delete the; marked CUA block; - executing any positioning command, such as CURSOR DOWN,; FORWARD or CURSOR MOUSE, will unmark the CUA block
Compatibility:: XEDIT: N/A; KEDIT: Compatible with KEDIT for Windows.
Default:: CLASSIC
See Also:: MARK, CURSOR
Status:: Complete.

SET LASTOP - set the contents of the lastop argument
Syntax:: [SET] LASTOP operand text
Description:: The SET LASTOP command sets the values of the specified operand to the text supplied. This command is most useful when run from a macro, to set the string to be passed to the next invocation of the equivalent operand command; eg LOCATE, FIND, etc.; Because THE does not save the contents of the lastop from a command when run from a macro, sometimes the macro is intended to set this value. This command allows that capability.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
See Also:: LOCATE, FIND, SEARCH
Status:: Complete.

SET LINEFLAG - set the line characteristics of lines
Syntax:: [SET] LINEFLAG CHAnge|NOCHange NEW|NONEW TAG|NOTAG [target]
Description:: The SET LINEFLAGS command controls the line characteristics of lines in a file.; Each line in a file has certain characteristics associated with it depending on how the line has been modified. On reading a file from disk, all lines in the file are set to their default values.; Once a line is modified, or tagged, the characteristics of the line are set appropriately. A line that is added, is set to NEW; a line that is changed is set to CHANGE, and a line that is tagged with the TAG command, is set to TAG. All three characteristics can be on at the one time.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: NOCHANGE NONEW NOTAG
See Also:: TAG, SET HIGHLIGHT
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 MACRO - indicate if macros executed before commands
Syntax:: SET MACRO ON|OFF
Description:: The SET MACRO command allows the user to determine if macros are executed before a built-in command of the same name.; This command MUST be prefixed with SET to distinguish it from the MACRO command.; A macro with the same name as a built-in command will only be executed before the built-in command if SET IMPMACRO is ON, SET MACRO is ON, and the command was NOT executed with the COMMAND command.
Compatibility:: XEDIT: Compatible.; KEDIT: N/A
Default:: OFF
See Also:: MACRO, SET IMPMACRO, COMMAND
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|path[s]
Description:: The SET MACROPATH command sets up the search path from which macro command files are executed. Each directory is separated by a colon (Unix) or semi-colon (DOS & OS/2). Only 20 directories are allowed to be specified.; When PATH is specified, the search path is set to the system PATH environment variable.
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.; All options can be specified as the current EQUIVCHAR to retain the existing value.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: 1 72 +0
See Also:: SET WORDWRAP, SET EQUIVCHAR
Status:: Complete.

SET MOUSE - turn mouse support on or off
Syntax:: [SET] MOUSE ON|OFF
Description:: The SET MOUSE command allows the user to turn on or off mouse support in THE. With mouse support, THE commands assigned to a mouse button event will be executed. See APPENDIX 3 for details on default mouse support.; If the platform does not support mouse operations, the default setting will be OFF.
Compatibility:: XEDIT: N/A; KEDIT: Compatible. Does not support all options.
Default:: ON - if mouse supported, OFF - otherwise
See Also:: DEFINE
Status:: Complete.

SET MOUSECLICK - set interval for mouse click events
Syntax:: [SET] MOUSECLick n
Description:: The SET MOUSECLICK command specifies the time interval in milliseconds that THE uses to determine if a mouse button CLICK is returned or a pair of mouse button PRESS and RELEASE events are returned. See APPENDIX 3 for details on default mouse support.; If the platform does not support mouse operations, the command is ignored.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Status:: Complete.

SET MSGLINE - set position and size of message line
Syntax:: [SET] MSGLine ON M[+n|-n]|[+|-]n [lines] [Overlay]; [SET] MSGLine CLEAR
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 positional 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.; e.g. 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 positional 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.; e.g. +3 or 3 will set first line to line 3; -3 on a 24 line screen will set first line to 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.; The lines argument specifies the maximum number of lines of error messages to display at the one time. If this value is specified as a whole number it must be less than or equal to the number of lines that could fit on the screen from the starting row. '*' can be specified to indicate that as many lines as possible should be displayed.; All options can be specified as the current EQUIVCHAR to retain the existing value.; The second format of the command clears the messages being displayed. This is useful in macros where you need to display an error message but also want to be able to clear it.
Compatibility:: XEDIT: Compatible.; The OVERLAY option is the default but ignored.; The second format is not supported.; KEDIT: Compatible; The OVERLAY option is the default but ignored.; The second format is not supported.
Default:: ON 2 5 Overlay
See Also:: SET EQUIVCHAR
Status:: Complete

SET MSGMODE - set display of messages on or off
Syntax:: [SET] MSGMode ON|OFF [Short|Long]
Description:: The SET MSGMODE set command determines whether error messages will be displayed or suppressed.
Compatibility:: XEDIT: Does not implement [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 set the display of numbers in the prefix area .
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: ON
See Also:: SET PREFIX
Status:: Complete.

SET PAGEWRAP - determine if page scrolling wraps at bottom/top of file
Syntax:: [SET] PAGEWRAP ON|OFF
Description:: The SET PAGEWRAP command allows the user to turn on or off the automatic wrapping of FORWARD and BACKWARD commands when the cursor is at the Bottom-of-File line or Top-of-File line respectively.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: ON
Status:: Complete.

SET PARSER - associates a language definition file with a parser
Syntax:: [SET] PARSER parser file
Description:: The SET PARSER defines a new syntax highlighting parser ; parser based on a language definition file; file .; The file is looked for in the directories specified by SET MACROPATH .; To specify one of the builtin parsers, prefix the filename with '*' . Therefore to define a parser called FRED using the builtin C parser, the command would be: SET PARSER FRED *C.TLD.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
See Also:: SET COLORING, SET ECOLOUR, SET AUTOCOLOR, SET MACROPATH
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 assigns 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 alphanumeric characters. e.g. .a .fred and .3AB are valid 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.
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] [m [n]]; [SET] PREfix Nulls [Left|Right] [m [n]]; [SET] PREfix OFF; [SET] PREfix Synonym newname oldname; [SET] PREfix GAP n [LINE]
Description:: The first form of the SET PREFIX command allows the user to display the prefix area and optionally to select the position where 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 displayed with leading spaces rather than zeros; with SET NUMBER OFF, blanks are displayed instead of equal signs.; The first and second forms of the SET PREFIX command allows the user to specify the width of the prefix area and optionally a gap between the prefix area and the filearea. m can be specified as an unsigned number between 2 and 20 inclusive. n can be specified as an unsigned number between 0 and 18, but less than the number specified in m .; 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. To turn off a prefix synonym, call SET PREFIX newname oldname where newname and oldname are the same and newname is an existing prefix command or macro.; The fifth form of the SET PREFIX command allows the user to specify the width of the gap between the prefix area and the file area and whether a vertical line should be displayed in that gap. n can be specified as an unsigned number between 0 and 18, but less than the current prefix width.
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.; Specification of prefix width ang gap is a THE-only option. Kedit has; SET PREFIXWIDTH to set prefix width, but not gap.
Default:: ON Left 6 0
Status:: Complete.

SET PRINTER - define printer spooler name
Syntax:: [SET] PRINTER spooler|[OPTION options]
Description:: The SET PRINTER command sets up the print spooler name to determine where output from the PRINT command goes.; The options can be one of the following: CPI n (characters per inch) LPI n (lines per inch) ORIENTation Portrait|Landscape FONT fontname (name of fixed width font); No checking is done for printer options. i.e. You may specify a font that THE doesn 't know about, and the printing process may not work after that.'; The defaults for page layout for Win32 are: CPI 16 LPI 8 ORIENTation Portrait FONT LinePrinter BM; options are only valid for Win32 platform. Printer output for the Win32 platform ALWAYS goes to the default printer. Therefore, the spooler option is invalid on this platform.
Compatibility:: XEDIT: N/A; KEDIT: Compatible. THE adds more functionality.
Default:: LPT1 - DOS/OS2, lpr - Unix, default - Win32
See Also:: PRINT
Status:: Complete.

SET PSCREEN - set physical size of screen
Syntax:: [SET] PSCReen height [width] [RESET|PRESET]
Description:: The SET PSCREEN command allows the user to adjust the size of the physical screen to the size specified by height and width .; This command does not work on all platforms.; The optional argument [RESET|PRESET] are ignored; they are there for Kedit compatibility.
Compatibility:: XEDIT: N/A; KEDIT: Compatible. Ignores RESET|PRESET argument
Default:: System Dependent
Status:: Incomplete.

SET READONLY - allow/disallow changes to a file if it is readonly
Syntax:: [SET] READONLY ON|OFF|FORCE [File]
Description:: The SET READONLY command allows the user to disallow changes to files if they are readonly. Normally, if a file is readonly, THE allows the user to make changes to the file contents while in the editing session, but does not allow the file to be saved.; With READONLY ON, THE disallows any changes to be made to the contents of the file in memory, in much the same way that THE disallows changes to be made to any files, if THE is started with the -r command line switch.; With READONLY FORCE, THE disallows any changes to be made to the contents of the file in memory, in the same way that THE disallows changes to be made to any files, if THE is started with the -r command line switch.; While the -r command line switch disallows changes to be made to any files, SET READONLY ON, only disallows changes to be made to readonly files. SET READONLY FORCE disallows changes to be made to the any files irrespective of whether they are readonly on disk.; With the [File] option, SET READONLY ON and SET READONLY FORCE will result in the current file being readonly. SET READONLY OFF will allow changes to be made to the current file, provided the global READONLY status is OFF.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: OFF
Status:: Complete.

SET REGEXP - specify the regular expression syntax to use
Syntax:: [SET] REGEXP syntax
Description:: The SET REGEXP command allows the user specify which of the many regular expression syntaxes to use when using regular expressions in a target . The syntax can be specified as one of:; EMACS; AWK; POSIX_AWK; GREP; EGREP; POSIX_EGREP; SED; POSIX_BASIC; POSIX_MINIMAL_BASIC; POSIX_EXTENDED; POSIX_MINIMAL_EXTENDED
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: EMACS
See Also:: LOCATE, ALL
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 subsequently 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 [AUTOSCroll] *|+|-n [colour] [text|OFF]
Description:: The SET RESERVED command reserves 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.; By default, reserved lines are fixed; that is the left portion of the reserved line that can be displayed stays displayed irrespective of whether the file contents have been scrolled left or right. With the AUTOSCroll option, the text of the reserved line is scrolled with the file contents using the same settings as SET AUTOSCROLL .; 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.; The text of reserved lines can also included embedded control characters to control the colour of portions of the text. Assume the following SET CTLCHAR commands have been issued:; SET CTLCHAR ! ESCAPE; SET CTLCHAR @ PROTECT BOLD RED ON WHITE; SET CTLCHAR % PROTECT GREEN ON BLACK; Then to display a reserved line using the specified colours:; SET RESERVED -1 normal!@bold red on white!%green on black; It is an error to try to reserve a line which is the same line as SET CURLINE .
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.; AUTOSCroll option is a THE extension.
See Also:: SET COLOUR, SET CTLCHAR
Status:: Complete.

SET REXXHALT - halt Rexx macro after specified number of events
Syntax:: [SET] REXXHALT Command|Function n|OFF
Description:: The SET REXXHALT command specifies how many calls to subcommands or functions can be made in a macro before a Rexx HALT condition is raised.; A Rexx HALT condition can be triggered by the user at the prompt displayed when the message line is full.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: OFF
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.; e.g. 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.; e.g. +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 - specify number of screens displayed
Syntax:: [SET] SCReen n [Horizontal|Vertical]; [SET] SCReen Size l1|* [l2|*]; [SET] SCReen Width c1|* [c2|*]
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.; The second form of SET SCREEN allows the user to specify the number of lines that each screen occupies. The sum of l1 and l2 must equal to lscreen.5 or lscreen.5 - 1 if the status line is displayed.; The value of l1 specifies the size of the topmost screen; l2 specifies the size of the bottommost screen.; Either l1 or l2 can be set to *, but not both. The * signifies that the screen size for the specified screen will be the remainder of the full display window after the size of the other screen has been subtracted.; The third form of SET SCREEN allows the user to specify the number of columns that each screen occupies. The sum of c1 and c2 must equal to lscreen.6.; The value of c1 specifies the size of the leftmost screen; c2 specifies the size of the rightmost screen.; Either c1 or c2 can be set to *, but not both. The * signifies that the screen size for the specified screen will be the remainder of the full display window after the size of the other screen has been subtracted.; The THE display can only be split into 1 or 2 screens.
Compatibility:: XEDIT: Does not support Define options.; KEDIT: Does not support Split option.; A maximum of 2 screens are supported.
Default:: 1
See Also:: SET STATUSLINE
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. n cannot be larger than 50000
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 SLK - set Soft Label Key definitions
Syntax:: [SET] SLK n|ON|OFF [text]
Description:: The SET SLK command allows the user to specify a short text description to be displayed on the bottom of the screen, using the terminal's built-in Soft Label Keys, on the last line of the screen.; The n argument of the command represents the label number from left to right, with the first label numbered 1.; OFF turns off display of the Soft Label Keys.; ON restores the display of the Soft Label Keys.; The main use for this command is to describe the function assigned to a function key, in place of a reserved line .; On those platforms that support a pointing device, clicking the left mouse button on the Soft Label Key, is equivalent to pressing the associated function key.; See COMMAND LINE SWITCHES in the THE manual for details on the number and format of Soft Label Keys.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: ON - if support for Soft Label Keys is available
See Also:: SET COLOUR
Status:: Complete.

SET SPAN - specify if a string target can span multiple lines (unavailable)
Syntax:: [SET] SPAN ON|OFF [Blank|Noblank [n|*]]
Description:: The SET SPAN set command determines if a character string that is the subject of a target search can span more than one line of the file.
Compatibility:: XEDIT: Compatible.; KEDIT: N/A
Default:: OFF Blank 2
Status:: Not started.

SET SPILL - specify if a string target can span multiple lines (unavailable)
Syntax:: [SET] SPILL ON|OFF|WORD
Description:: The SET SPILL set command determines how characters are spilt off the end of a line when the length of the line exceeds the truncation column.
Compatibility:: XEDIT: Compatible.; KEDIT: N/A
Default:: OFF
Status:: Not started.

SET STATOPT - set display options on statusline
Syntax:: [SET] STATOPT ON option column [length [prompt] ]; [SET] STATOPT OFF option|*
Description:: The SET STATOPT command allows the user to specify which internal settings of THE are to be displayed on the status line .; The option argument is any value returned by the EXTRACT command. eg NBFILE.1.; The syntax of the ON option, displays the specified value, at the position in the status line specified by column . If supplied, length specifies the number of characters, beginning at the first character of the returned value, to display. A value of 0 indicates that the full value if to be displayed. The optional prompt argument, allows the user to specify a string to display immediately before the returned value.; OFF, removes the specified option from displaying. If * is specified, all displayed options will be removed.; column is relative to the start of the status line . The value of column must be > 9, so that the version of THE is not obscured.; Options will be displayed in the order in which they are set.; If SET CLOCK or SET HEX are ON, these will take precedence over options specified with this command.; The more values you display the longer it will take THE to display the status line . Also, some values that are available via EXTRACT are not really suitable for use here. eg CURLINE.3.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: ON NBFILE.1 13 0 Files=; ON WIDTH.1 23 0 Width=
Status:: Complete.

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 (unavailable)
Syntax:: [SET] SYNonym ON|OFF; [SET] SYNonym [LINEND char] newname [n] definition
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 defines a command synonym.; The synonym is newname , which effectively adds a new THE command with the definition specified by definition . The n parameter defines the minimum length of the abbreviation for the new command An optional LINEND character can be specified prior to newname if the definition contains multiple commands.; definition can be of the form: [REXX] command [args] [#command [args] [...]] (where # represents the LINEND character specified prior to newname ); If the optional keyword; 'REXX' , is supplied, the remainder of the command line is treated as a Rexx macro and is passed onto the Rexx interpreter (if you have one) for execution.; Only 1 level of synonym processing is carried out; therefore a synonym cannot be specified in the definition .
Compatibility:: XEDIT: Compatible. Does not support format that can reorder parameters.; KEDIT: Compatible.
Default:: OFF
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.; All options can be specified as the current EQUIVCHAR to retain the existing value.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: Tab Character
See Also:: SET EQUIVCHAR
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.; e.g. 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.; e.g. +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; [SET] TABS OFF
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.; The third format specifies that no tab columns are to be set.; Tab columns are used by SOS TABF , SOS TABB and SOS SETTAB commands to position the cursor and also by the COMPRESS and EXPAND commands.
Compatibility:: XEDIT: Compatible. Does not support OFF option.; KEDIT: Compatible. Does not support OFF option.
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 TARGETSAVE - set type(s) of targets to save for subsequent LOCATEs
Syntax:: [SET] TARGETSAVE ALL|NONE| STRING REGEXP ABSOLUTE RELATIVE POINT BLANK
Description:: The SET TARGETSAVE command allows you to specify which target types are saved for subsequent calls to the LOCATE command without any parameters.; By default; SET TARGETSAVE ALL, the LOCATE command without any parameters, locates the last target irrespective of the type of target.; SET TARGETSAVE NONE turns off saving of targets, but does not delete any already saved target.; Any combination of the target types, STRING, REGEXP, ABSOLUTE, RELATIVE, POINT, or BLANK can be supplied. e.g. SET TARGETSAVE STRING POINT.; As an example, having SET TARGETTYPE STRING then the only target saved will be one that has a string target component. i.e. if you executed LOCATE /fred/ then LOCATE :3 then LOCATE, the final LOCATE will look for /fred/ NOT :3
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: ALL
See Also:: LOCATE
Status:: Complete.

SET THIGHLIGHT - specify if text highlighting is supported
Syntax:: [SET] THIGHlight ON|OFF
Description:: The SET THIGHLIGHT command allows the user to specify if a the result of a string LOCATE command should be highlighted. The colour that is used to highlight the found string is set by the THIGHLIGHT option of SET COLOUR . The found string is highlighted until a new line is added or deleted, a command is issued from the command line, another LOCATE or CLOCATE command is executed, a block is marked, or RESET THIGHLIGHT is executed.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: ON - THE/KEDIT/KEDITW OFF - XEDIT/ISPF
See Also:: LOCATE, SET COLOUR
Status:: Complete.

SET TIMECHECK - specify if time stamp checking done
Syntax:: [SET] TIMECHECK ON|OFF
Description:: The SET TIMECHECK command allows the user to specify if a check is made of the modification time of the file being saved at the time of saving. This is done to alert the user if a file has changed since they began editing the file.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: ON
Status:: Complete.

SET TOFEOF - specify if TOF and BOF lines are displayed
Syntax:: [SET] TOFEOF ON|OFF
Description:: The SET TOFEOF command allows the user to specify if the Top-of-File line and the Bottom-of-File line are displayed.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: ON
Status:: Complete.

SET TRAILING - specify how to treat trailing blanks on lines
Syntax:: [SET] TRAILING ON|OFF|REMOVE|SINGLE|EMPTY
Description:: The SET TRAILING set command determines how trailing blanks on lines are handled when written to disk. TRAILING ON means that THE will not treat trailing blanks any differently from any other characters in the file. Trailing blanks are left on the line while reading in and editing, and retained when the file is written to disk. With TRAILING OFF, THE will remove trailing blanks when a file is read, remove them during an edit session, and not write any trailing blanks to the file. With TRAILING REMOVE, THE will leave trailing blanks on the end of a line when the file is read in and during editing, but will remove trailing blanks when a file is written to disk. TRAILING SINGLE is the same as TRAILING OFF, except that a single blank character is appended to the end of every line when the file is written. TRAILING EMPTY is the same as TRAILING OFF, except that otherwise empty lines will be written with a single trailing blank.; Note that the default for this under THE is ON. This is because of the way that THE processes profile files. If the default was OFF, and you had TRAILING ON in your profile, then there would be no way to retain the original trailing blanks.; If THE is started with -u switch, then any change to TRAILING is ignored; the file will be handled as though TRAILING ON is in effect.
Compatibility:: XEDIT: N/A; KEDIT: Compatible. REMOVE is an THE extension.
Default:: ON
Status:: Complete. Some trailing blank behaviour while editing files incomplete.

SET TRUNC - specify the truncation column
Syntax:: [SET] TRunc n|*
Description:: The SET TRUNC set command determines the truncation column. This is the rightmost column of text upon which THE commands are effective.
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: *
Status:: Incomplete.

SET TYPEAHEAD - set behaviour 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 UNDOING - turn on or off undo facility for the current file
Syntax:: [SET] UNDOING ON|OFF
Description:: The SET UNDOING command allows the user to turn on or off the undo facility for the current file.; At this stage in the development of THE, setting UNDOING to OFF stops THE from saving changes made to lines in a file, and prevents those lines from being able to be RECOVERed.; Setting UNDOING to OFF will increase the speed at which THE can execute CHANGE and DELETE commands.
Compatibility:: XEDIT: N/A; KEDIT: Does not support optional arguments.
Default:: ON
Status:: Complete.

SET UNTAA - specifies if "Unsigned Numerical Targets Are Absolute"
Syntax:: [SET] UNTAA ON|OFF
Description:: The SET UNTAA command allows the user to turn on or off the behaviour of unsigned numerical targets.; Numerical targets have the form [:|;|+|-]nn. By default, if the optional portion of the target is not supplied, then a '+' is assumed. WIth SET UNTAA set to ON, if the optional portion of the target is not supplied, then a ':' is assumed.; Caution: This SET command affects all numerical targets, not just targets in the LOCATE command.
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.; All options can be specified as the current EQUIVCHAR to retain the existing value.
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, SET EQUIVCHAR
Status:: Complete.

SET WIDTH - set width of maximum line that THE can edit
Syntax:: [SET] WIDTH n
Description:: The SET WIDTH command specifies the maximum length that a line can be within the edit session. This command is effectively the same as the -w command line switch.; The value n MUST be between 10 and 2000000000.
Compatibility:: XEDIT: N/A; KEDIT: N/A
Default:: 512
Status:: Complete.

SET WORD - controls what THE considers a word to be
Syntax:: [SET] WORD NONBlank|ALPHAnum
Description:: The SET WORD set command determines what sequence of characters THE considers a word to be. This is used in command such as SOS DELWORD , SOS TABWORDF and MARK WORD to specify the boundaries of the word.; The default setting for SET WORD is NONBlank . THE treats all sequences of characters separated by a blank (ASCII 32) as words.; With ALPHAnum THE treats a group of consecutive alphanumeric characters as a word. THE also includes the underscore character and characters with an ASCII value > 128 as alphanumeric.
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: NONBlank
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 WRAP - enable/disable string locates around the end of the file
Syntax:: [SET] WRap ON|OFF
Description:: The SET WRAP set command determines whether THE will look for a string target off the ends of the file.; With WRAP OFF, THE will attempt to locate a string target from the current line to the end of file (or top of file if the locate is a backwards search).; With WRAP ON, THE will attempt to locate a string target from the current line to the end of file (or top of file if the locate is a backwars search) and wrap around the end of the file and continue searching until the current line is reached.; If the string target is located after wrapping around the end of the file, the message 'Wrapped...' is displayed.; Commands affected by SET WRAP are; LOCATE , FIND , NFIND , FINDUP and NFINDUP .
Compatibility:: XEDIT: N/A; KEDIT: Compatible.
Default:: OFF
See Also:: LOCATE, FIND, NFIND, FINDUP, NFINDUP
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 qualified 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.; All options can be specified as the current EQUIVCHAR to retain the existing value.
Compatibility:: XEDIT: Compatible.; KEDIT: Compatible.
Default:: 1 *
See Also:: SET VERIFY, SET EQUIVCHAR
Status:: Complete.

Return to Table of Contents

SET COMMAND REFERENCE

SET ALT - change alteration counts

SET ARBCHAR - set arbitrary character(s) for targets

SET AUTOCOLOR - specifies which parser to use for syntax highlighting

SET AUTOCOLOUR - specifies which parser to use for syntax highlighting

SET AUTOSAVE - set autosave period

SET AUTOSCROLL - set rate of automatic horizontal scrolling

SET BACKUP - indicate if a backup copy of the file is to be kept

SET BEEP - turn on or off the audible alarm when displaying errors

SET BOUNDMARK - set bounds marker display

SET CASE - set case sensitivity parameters

SET CLEARERRORKEY - specify which key clears the message line

SET CLEARSCREEN - indicate if the screen is to be cleared on exit

SET CLOCK - turn on or off display of time on status line

SET CMDARROWS - sets the behaviour of the up and down arrow keys

SET CMDLINE - sets the position of the command line.

SET COLOR - set colors for display

SET COLOUR - set colours for display

SET COLORING - enable or disable syntax highlighting

SET COLOURING - enable or disable syntax highlighting

SET COMPAT - set compatibility mode

SET CTLCHAR - define control character attributes

SET CURLINE - set position of current line on screen

SET CURSORSTAY - set on or off the behaviour of the cursor on a scroll

SET DEFSORT - specify the order in which files appear in DIR.DIR

SET DIRINCLUDE - set the file mask for directory command

SET DISPLAY - specify which level of lines to display

SET ECOLOR - set colors for syntax highlighting

SET ECOLOUR - set colours for syntax highlighting

SET EOLOUT - set end of line terminating character(s)

SET EQUIVCHAR - set the equivalence character

SET ERRORFORMAT - set format of error messages

SET ERROROUTPUT - indicate whether THE error messages are echoed to screen

SET ETMODE - indicate if extended display mode is possible

SET FILE DISPLAY NAME - change the display filename of the file being edited

SET FEXT - change the extension of the existing file

SET FILENAME - change the filename of the file being edited

SET FILETABS - determine if and where where file tabs are positioned

SET FMODE - change the drive letter of the existing file

SET FNAME - change the filename of the file being edited

SET FPATH - change the path of the existing file

SET FTYPE - change the extension of the existing file

SET FULLFNAME - specify if complete filename to be displayed

SET HEADER - turn on or off syntax highlighting headers

SET HEX - set how hexadecimal strings are treated in string operands

SET HEXDISPLAY - turn on or off display of character under cursor

SET HEXSHOW - turn on or off hex display of current line

SET HIGHLIGHT - specify which lines (if any) are to be highlighted

SET IDLINE - specify if IDLINE is displayed

SET IMPCMSCP - set implied operating system command processing

SET IMPMACRO - set implied macro command processing

SET IMPOS - set implied operating system command processing

SET INPUTMODE - set input mode behaviour

SET INSERTMODE - put editor into or out of insert mode

SET INTERFACE - set overall behaviour of THE

SET LASTOP - set the contents of the lastop argument

SET LINEFLAG - set the line characteristics of lines

SET LINEND - allow/disallow multiple commands on command line

SET MACRO - indicate if macros executed before commands

SET MACROEXT - set default macro extension value

SET MACROPATH - set default path for macro commands

SET MARGINS - set left and right margins for wordwrap

SET MOUSE - turn mouse support on or off

SET MOUSECLICK - set interval for mouse click events

SET MSGLINE - set position and size of message line

SET MSGMODE - set display of messages on or off

SET NEWLINES - set position of cursor after adding blank line

SET NONDISP - specify character to display for non-displaying characters

SET NUMBER - turn prefix numbers on or off

SET PAGEWRAP - determine if page scrolling wraps at bottom/top of file

SET PARSER - associates a language definition file with a parser

SET PENDING - set status of pending prefix commands

SET POINT - assign a name to the current line

SET POSITION - determine if LINE/COL is displayed on idline

SET PREFIX - set prefix area attributes

SET PRINTER - define printer spooler name

SET PSCREEN - set physical size of screen

SET READONLY - allow/disallow changes to a file if it is readonly

SET REGEXP - specify the regular expression syntax to use

SET REPROFILE - indicate if profile file to be executed for all files