/usr/share/doc/the/html/commset.html

<HTML>
<HEAD><TITLE>THE Reference - SET Commands </TITLE></HEAD>
<BODY BGCOLOR="#F1EDD1" LINK = "#0000FF" VLINK = "#FF0022" ALINK = "#808000">
<CENTER> <img WIDTH="64" HEIGHT="64" HSPACE="20" SRC="the64.png" ALT="THE"> </CENTER>
<P><HR><A NAME="SETCOMMANDREFERENCE"></A>
<H2> SET COMMAND REFERENCE </H2>
<HR>
<A NAME="SETALT"></A>
<DL><DT>
<h3>SET ALT -  change alteration counts </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] ALT <I>[n] [m]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET ALT command allows the user to change the alteration counts.           This command is usually called from within a macro. <P></DD>
<DD> The first number;  <I>n</I>  sets the number of changes since the last           AUTOSAVE was issued. <P></DD>
<DD> The second number;  <I>m</I>  sets the number of changes since the last           SAVE or SSAVE command was issued. <P></DD>
<DD> All options can be specified as the current EQUIVCHAR to retain the           existing value. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETEQUIVCHAR">SET EQUIVCHAR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETARBCHAR"></A>
<DL><DT>
<h3>SET ARBCHAR -  set arbitrary character(s) for targets </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] ARBchar <I>ON|OFF [char1] [char2]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DD> All options can be specified as the current EQUIVCHAR to retain the           existing value. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   Single arbitrary character not supported.
</DD><DD>   KEDIT: Compatible.
</DD><DD>   Arbitrary character not supported in <A HREF = "comm.html#CHANGE">CHANGE</A> or <A HREF = "comm.html#SCHANGE">SCHANGE</A>  commands.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> Off $ ? <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETEQUIVCHAR">SET EQUIVCHAR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETAUTOCOLOR"></A>
<DL><DT>
<h3>SET AUTOCOLOR -  specifies which parser to use for syntax highlighting </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] AUTOCOLOR <I>mask parser [MAGIC]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET AUTOCOLOR command allows the user to specify which syntax           highlighting <A HREF = "glossary.html#PARSER">parser</A>  is to be used for which file masks. <P></DD>
<DD> The  <I>parser</I>  argument specifies a syntax highlighting <A HREF = "glossary.html#PARSER">parser</A> that           already exists, either as a default <A HREF = "glossary.html#PARSER">parser</A> , or added by the user           with <A HREF = "commset.html#SETPARSER">SET PARSER</A> .  The special parser name of  '*NULL'  can be           specified; this will effectively remove the association between           the <A HREF = "glossary.html#PARSER">parser</A>  and the file mask. <P></DD>
<DD> The  <I>mask</I>  argument specifies the file mask (or <A HREF = "glossary.html#MAGICNUMBER">magic number</A> ) to           associate with the specified parser.  The  <I>mask</I>  can be any valid           file mask for the operating system. eg *.c fred.* joe.? <P></DD>
<DD> If the  <I>magic</I>  option is specified, the  <I>mask</I>  argument refers to           the last element of the <A HREF = "glossary.html#MAGICNUMBER">magic number</A>  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". <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Similar. KEDIT does not have MAGIC option.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> See  <A HREF = "comm.html#QUERY">QUERY</A>  AUTOCOLOR <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETCOLORING">SET COLORING</A>, <A HREF = "commset.html#SETECOLOUR">SET ECOLOUR</A>, <A HREF = "commset.html#SETPARSER">SET PARSER</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETAUTOCOLOUR"></A>
<DL><DT>
<h3>SET AUTOCOLOUR -  specifies which parser to use for syntax highlighting </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] AUTOCOLOUR <I>mask parser [MAGIC]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET AUTOCOLOUR command is a synonym for the <A HREF = "commset.html#SETAUTOCOLOR">SET AUTOCOLOR</A>  command. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Similar. KEDIT does not have MAGIC option.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> See  <A HREF = "comm.html#QUERY">QUERY</A>  AUTOCOLOR <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETAUTOCOLOR">SET AUTOCOLOR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETAUTOSAVE"></A>
<DL><DT>
<h3>SET AUTOSAVE -  set autosave period </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] AUtosave <I>n|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET AUTOSAVE command sets the interval between automatic saves           of the file, or turns it off altogether.  The interval  <I>n</I>  refers           to the number of alterations made to the file.  Hence a value of           10 for  <I>n</I>  would result in the file being automatically saved after           each 10 alterations have been made to the file. <P></DD>
<DD> It is not possible to set AUTOSAVE for  'pseudo'  files such as the           directory listing  'file' , Rexx output  'file'  and the key definitions            'file' <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Does not support [mode] option.
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETAUTOSCROLL"></A>
<DL><DT>
<h3>SET AUTOSCROLL -  set rate of automatic horizontal scrolling </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] AUTOSCroll <I>n|OFF|Half</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET AUTOSCROLL allows the user to set the rate at which automatic           horizontal scrolling occurs. <P></DD>
<DD> When the cursor reaches the last (or first) column of the <A HREF = "glossary.html#FILEAREA">filearea</A> the <A HREF = "glossary.html#FILEAREA">filearea</A> can automatically scroll if AUTOSCROLL is not  <I>OFF</I>  and           a <A HREF = "comm.html#CURSOR">CURSOR</A> RIGHT or <A HREF = "comm.html#CURSOR">CURSOR</A>  LEFT command is issued.           How many columns are scrolled is determined by the setting of AUTOSCROLL. <P></DD>
<DD> If AUTOSCROLL is set to  <I>HALF</I> , then half the number of columns in the <A HREF = "glossary.html#FILEAREA">filearea</A> window are scrolled.  Any other value will result in that           many columns scrolled, or the full width of the <A HREF = "glossary.html#FILEAREA">filearea</A>  window if           the set number of columns is larger. <P></DD>
<DD> Autoscrolling does not occur if the key pressed is assigned to <A HREF = "comm.html#CURSOR">CURSOR</A> SCREEN LEFT or RIGHT, which is the case if <A HREF = "commset.html#SETCOMPAT">SET COMPAT</A>  XEDIT           key defintions are active. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> HALF <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETBACKUP"></A>
<DL><DT>
<h3>SET BACKUP -  indicate if a backup copy of the file is to be kept </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] BACKup <I>OFF|TEMP|KEEP|ON|INPLACE [suffix]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DD> <I>KEEP</I>  and  <I>ON</I>  options are the same.  <I>ON</I>  is           kept for compatability with previous versions of THE. <P></DD>
<DD> With  <I>OFF</I> , 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. <P></DD>
<DD> With  <I>TEMP</I>  or  <I>KEEP</I>  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  <I>TEMP</I>  is in effect, the backup           file is then deleted. <P></DD>
<DD> With  <I>INPLACE</I> , 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. <P></DD>
<DD> The optional  <I>suffix</I>  specifies the string to append to the file name           of the backup copy including a period if required. The maximum length           of  <I>suffix</I>  is 100 characters.           By default this is ".bak". <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
</DD><DD>    <I>suffix</I>  is a THE extension
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> KEEP <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#FILE">FILE</A>, <A HREF = "comm.html#FFILE">FFILE</A>, <A HREF = "comm.html#SAVE">SAVE</A>, <A HREF = "comm.html#SSAVE">SSAVE</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETBEEP"></A>
<DL><DT>
<h3>SET BEEP -  turn on or off the audible alarm when displaying errors </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] BEEP <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET BEEP command allows the user to determine if an audible           alarm is sounded when an error is displayed. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETBOUNDMARK"></A>
<DL><DT>
<h3>SET BOUNDMARK -  set bounds marker display </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] BOUNDMARK <I>OFF|Zone|TRunc|MARgins|TABs|Verify</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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 <A HREF = "glossary.html#FILEAREA">filearea</A> .           This command only has a visible effect on GUI platforms, currently           only the X11 port. <P></DD>
<DD> <I>OFF</I>  turns off the display of boundary markers. <P></DD>
<DD> <I>ZONE</I>  turns on the display of boundary markers, before the zone           start column and after the zone end column. <P></DD>
<DD> <I>TRUNC</I>  turns on the display of boundary markers, after the           truncation column. Not supported. <P></DD>
<DD> <I>MARGINS</I>  turns on the display of boundary markers, before the left           margin and after the right margin. <P></DD>
<DD> <I>TABS</I>  turns on the display of boundary markers, before each tab           column. <P></DD>
<DD> <I>VERIFY</I>  turns on the display of boundary markers, before each verify           column. Not supported. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible, but no support for TRUNC or VERIFY option.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> Zone <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Incomplete </DD>
</DL><P>
<HR>
<A NAME="SETCASE"></A>
<DL><DT>
<h3>SET CASE -  set case sensitivity parameters </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] CASE <I>Mixed|Lower|Upper [Respect|Ignore] [Respect|Ignore] [Respect|Ignore] [Mixed|Lower|Upper] [Mixed|Lower|Upper]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The CASE command sets the editor's handling of the case of text. <P></DD>
<DD> The first option (which is mandatory) controls how text is entered           by the user in the <A HREF = "glossary.html#FILEAREA">filearea</A> . When  <I>LOWER</I>  or  <I>UPPER</I>  are in effect,           the shift or caps lock keys have no effect on the text being entered.           When  <I>MIXED</I>  is in effect, text is entered in the case set by the use           of the shift and caps lock keys. <P></DD>
<DD> The second option determines how the editor determines if a string           target matches text in the file when the target is used in a <A HREF = "comm.html#LOCATE">LOCATE</A>            command.  With  <I>IGNORE</I>  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  <I>RESPECT</I>  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. <P></DD>
<DD> The third option determines how the editor determines if a string           target matches text in the file when the target is used in a <A HREF = "comm.html#CHANGE">CHANGE</A>            command.  With  <I>IGNORE</I>  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  <I>RESPECT</I>  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. <P></DD>
<DD> The fourth option determines how the editor determines the sort           order of upper and lower case with the <A HREF = "comm.html#SORT">SORT</A>  command.           With  <I>IGNORE</I>  in effect, upper and lower case letters are treated as           equivalent.           With  <I>RESPECT</I>  in effect, upper and lower case letters are treated as           different values and uppercase characters will sort before lowercase           characters. <P></DD>
<DD> The fifth option controls how text is entered by the user on the <A HREF = "glossary.html#COMMANDLINE">command line</A> . The allowed values and behaviour are the same as for           the first option. <P></DD>
<DD> The sixth option controls how text is entered by the user in the <A HREF = "glossary.html#PREFIXAREA">prefix area</A> . The allowed values and behaviour are the same as for           the first option. <P></DD>
<DD> All options can be specified as the current EQUIVCHAR to retain the           existing value. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Adds support for case significance in CHANGE commands.
</DD><DD>   KEDIT: Adds support for LOWER option.
</DD><DD>   Both:  Adds support for case significance in SORT command.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> Mixed Ignore Respect Respect <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETEQUIVCHAR">SET EQUIVCHAR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete </DD>
</DL><P>
<HR>
<A NAME="SETCLEARERRORKEY"></A>
<DL><DT>
<h3>SET CLEARERRORKEY -  specify which key clears the message line </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] CLEARErrorkey <I>*|keyname</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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 <A HREF = "comm.html#SHOWKEY">SHOWKEY</A>  command. <P></DD>
<DD> As the <A HREF = "comm.html#QUERY">QUERY</A> command also uses the same mechanism for displaying           its results as errors, then this command affects when results from           the <A HREF = "comm.html#QUERY">QUERY</A>  command are cleared. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> * <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete </DD>
</DL><P>
<HR>
<A NAME="SETCLEARSCREEN"></A>
<DL><DT>
<h3>SET CLEARSCREEN -  indicate if the screen is to be cleared on exit </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] CLEARScreen <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET CLEARSCREEN command allows the user to request that the           screen be cleared on exit from THE. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete </DD>
</DL><P>
<HR>
<A NAME="SETCLOCK"></A>
<DL><DT>
<h3>SET CLOCK -  turn on or off display of time on status line </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] CLOCK <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET CLOCK command turns on or off the display of the time on the <A HREF = "glossary.html#STATUSLINE">status line</A> . <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete </DD>
</DL><P>
<HR>
<A NAME="SETCMDARROWS"></A>
<DL><DT>
<h3>SET CMDARROWS -  sets the behaviour of the up and down arrow keys </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] CMDArrows <I>Retrieve|Tab</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET CMDARROWS command determines the action that occurs when the           up and down arrows keys are hit while on the <A HREF = "glossary.html#COMMANDLINE">command line</A> . <P></DD>
<DD> <I>RETRIEVE</I>  will set the up and down arrows to retrieve the last or           next command entered on the <A HREF = "glossary.html#COMMANDLINE">command line</A> . <P></DD>
<DD> <I>TAB</I>  will set the up and down arrows to move to the last           or first line respectively of the main window. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> RETRIEVE <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#CURSOR">CURSOR</A>, <A HREF = "comm.html#QUESTIONMARK">?</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETCMDLINE"></A>
<DL><DT>
<h3>SET CMDLINE -  sets the position of the command line. </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] CMDline <I>ON|OFF|Top|Bottom</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET CMDLINE command sets the position of the <A HREF = "glossary.html#COMMANDLINE">command line</A> ,           either at the top of the screen, the bottom of the screen or off. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   CMDLINE ON is equivalent to CMDLINE Bottom
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> BOTTOM <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETCOLOR"></A>
<DL><DT>
<h3>SET COLOR -  set colours for display </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] COLOR <I>area [modifier[...]] [foreground] [ON] [background]</I> <P></DD>
<DD> [SET] COLOR <I>area [modifier[...]] ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET COLOR command changes the colours or display attributes of           various display areas in THE. <P></DD>
<DD> Valid values for  <I>area</I> : <P></DD>
<DD>   ALERT      - alert boxes; see <A HREF = "comm.html#ALERT">ALERT</A>
</DD><DD>   Arrow      - command line prompt
</DD><DD>   Block      - marked <A HREF = "glossary.html#BLOCK">block</A>
</DD><DD>   BOUNDmarker- bound markers (GUI platforms only)
</DD><DD>   CBlock     - <A HREF = "glossary.html#CURRENTLINE">current line</A> if in marked <A HREF = "glossary.html#BLOCK">block</A>
</DD><DD>   CHIghlight - highlighted line if the same as <A HREF = "glossary.html#CURRENTLINE">current line</A>
</DD><DD>   Cmdline    - <A HREF = "glossary.html#COMMANDLINE">command line</A>
</DD><DD>   CTofeof    - as for TOfeof if the same as <A HREF = "glossary.html#CURRENTLINE">current line</A>
</DD><DD>   CUrline    - the <A HREF = "glossary.html#CURRENTLINE">current line</A>
</DD><DD>   CURSORline - the line in <A HREF = "glossary.html#FILEAREA">filearea</A>  that the cursor is or was on
</DD><DD>   DIALOG     - dialog boxes; see <A HREF = "comm.html#DIALOG">DIALOG</A>
</DD><DD>   Divider    - dividing line between vertical split screens
</DD><DD>   Filearea   - area containing file lines
</DD><DD>   GAP        - the gap between the <A HREF = "glossary.html#PREFIXAREA">prefix area</A> and <A HREF = "glossary.html#FILEAREA">filearea</A>
</DD><DD>   CGAP       - the gap between the <A HREF = "glossary.html#PREFIXAREA">prefix area</A> and <A HREF = "glossary.html#FILEAREA">filearea</A>  - current
</DD><DD>   HIghlight  - highlighted line
</DD><DD>   Idline     - line containing file specific info
</DD><DD>   Msgline    - error messages
</DD><DD>   Nondisp    - Non-display characters ( <A HREF = "commset.html#SETETMODE">SET ETMODE</A>  OFF)
</DD><DD>   Pending    - pending commands in <A HREF = "glossary.html#PREFIXAREA">prefix area</A>
</DD><DD>   PRefix     - <A HREF = "glossary.html#PREFIXAREA">prefix area</A>
</DD><DD>   CPRefix    - <A HREF = "glossary.html#PREFIXAREA">prefix area</A> if the same as <A HREF = "glossary.html#CURRENTLINE">current line</A>
</DD><DD>   Reserved   - default for <A HREF = "glossary.html#RESERVEDLINE">reserved line</A>
</DD><DD>   Scale      - line showing <A HREF = "glossary.html#SCALELINE">scale line</A>
</DD><DD>   SHadow     - hidden line marker lines
</DD><DD>   SLK        - soft label keys
</DD><DD>   STatarea   - line showing status of editing session
</DD><DD>   Tabline    - line showing tab positions
</DD><DD>   TOfeof     - <A HREF = "glossary.html#TOP-OF-FILELINE">Top-of-File line</A> and <A HREF = "glossary.html#BOTTOM-OF-FILELINE">Bottom-of-File line</A>
</DD><DD>   *          - All area (second format only)
<P></DD>
<DD> Valid values for  <I>foreground</I>  and  <I>background</I> : <P></DD>
<DD>   BLAck
</DD><DD>   BLUe
</DD><DD>   Brown
</DD><DD>   Green
</DD><DD>   GRAy
</DD><DD>   GREy
</DD><DD>   Cyan
</DD><DD>   RED
</DD><DD>   Magenta
</DD><DD>   Pink
</DD><DD>   Turquoise
</DD><DD>   Yellow
</DD><DD>   White
<P></DD>
<DD> Valid values for  <I>modifier</I> : <P></DD>
<DD>   NORmal
</DD><DD>   BLInk
</DD><DD>   BOld
</DD><DD>   BRIght
</DD><DD>   High
</DD><DD>   REVerse
</DD><DD>   Underline
</DD><DD>   DARK
</DD><DD>   Italic - only available on X11 port with valid Italic font
<P></DD>
<DD> The second format of this command allows the user to turn on or off           any of the valid modifiers. <P></DD>
<DD> It is an error to attempt to set a colour on a mono display. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Functionally compatible. See below.
</DD><DD>   KEDIT: Functionally compatible. See below.
</DD><DD>   Does not implement all modifiers.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> Depends on compatibility mode setting and monitor type. <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETCOMPAT">SET COMPAT</A>, <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A>, <A HREF = "commset.html#SETECOLOUR">SET ECOLOUR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETCOLOUR"></A>
<DL><DT>
<h3>SET COLOUR -  set colours for display </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] COLOUR <I>area [modifier[...]] [foreground] [on background]</I> <P></DD>
<DD> [SET] COLOUR <I>area [modifier[...]] ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET COLOUR command is a synonym for the <A HREF = "commset.html#SETCOLOR">SET COLOR</A>  command. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Functionally compatible. See below.
</DD><DD>   KEDIT: Functionally compatible. See below.
</DD><DD>   Does not implement all modifiers.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> Depends on compatibility mode setting and monitor type. <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETCOLOR">SET COLOR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETCOLORING"></A>
<DL><DT>
<h3>SET COLORING -  enable or disable syntax highlighting </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] COLORING <I>ON|OFF [AUTO|parser]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET COLORING command allows the user to turn on or off syntax           highlighting for current file.  It also allows the <A HREF = "glossary.html#PARSER">parser</A> used to be           specified explicitly, or automatically determined by the file           extension or <A HREF = "glossary.html#MAGICNUMBER">magic number</A> . <P></DD>
<DD> ON turns on syntax highlighting for the current file, OFF turns it           off. <P></DD>
<DD> AUTO determines the <A HREF = "glossary.html#PARSER">parser</A> to use for the current file based on the           file extension.  The <A HREF = "glossary.html#PARSER">parser</A> to use is controlled by the <A HREF = "commset.html#SETAUTOCOLOR">SET AUTOCOLOR</A>            command. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON AUTO <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETCOLOURING">SET COLOURING</A>, <A HREF = "commset.html#SETECOLOUR">SET ECOLOUR</A>, <A HREF = "commset.html#SETAUTOCOLOR">SET AUTOCOLOR</A>, <A HREF = "commset.html#SETPARSER">SET PARSER</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETCOLOURING"></A>
<DL><DT>
<h3>SET COLOURING -  enable or disable syntax highlighting </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] COLOURING <I>ON|OFF [AUTO|parser]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET COLOURING command is a synonym for the <A HREF = "commset.html#SETCOLORING">SET COLORING</A>  command. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON AUTO <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETCOLORING">SET COLORING</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETCOMPAT"></A>
<DL><DT>
<h3>SET COMPAT -  set compatibility mode </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] COMPat <I>The|Xedit|Kedit|KEDITW|Ispf|= [The|Xedit|Kedit|KEDITW|Ispf|=] [The|Xedit|Kedit|KEDITW|Ispf|=]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DD> This command is most useful as the first <A HREF = "comm.html#SET">SET</A> 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 <A HREF = "comm.html#SET">SET</A>  commands. <P></DD>
<DD> 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 :-) <P></DD>
<DD> 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. <P></DD>
<DD> Any of the parameters can be specified as =, which will not           change that aspect of THE's compatability. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> THE THE THE <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETCTLCHAR"></A>
<DL><DT>
<h3>SET CTLCHAR -  define control character attributes </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] CTLchar <I>OFF</I> <P></DD>
<DD> [SET] CTLchar <I>char Escape | OFF</I> <P></DD>
<DD> [SET] CTLchar <I>char Protect|Noprotect [modifier[...]] fore [ON back]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET CTLCHAR command defines control characters to be used when           displaying a <A HREF = "glossary.html#RESERVEDLINE">reserved line</A> .  Control characters determine how parts           of a <A HREF = "glossary.html#RESERVEDLINE">reserved line</A>  are displayed. <P></DD>
<DD> See <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A>  for valid values for  <I>modifier</I> ,  <I>fore</I>  and  <I>back</I> . <P></DD>
<DD> The  <I>Protect</I>  and  <I>Noprotect</I>  arguments are ignored. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Similar, but does not support all parameters.
</DD><DD>   KEDIT: N/A.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A>, <A HREF = "commset.html#SETRESERVED">SET RESERVED</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETCURLINE"></A>
<DL><DT>
<h3>SET CURLINE -  set position of current line on screen </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] CURLine <I>[ON] M[+n|-n] | [+|-]n</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET CURLINE command sets the position of the <A HREF = "glossary.html#CURRENTLINE">current line</A>  to           the physical screen line specified by supplied arguments. <P></DD>
<DD> The first form of parameters is: <P></DD>
<DD>   M[+n|-n]
</DD><DD>   this sets the <A HREF = "glossary.html#CURRENTLINE">current line</A>  to be relative to the middle of
</DD><DD>   the screen. A positive value adds to the middle line number,
</DD><DD>   a negative subtracts from it.
</DD><DD>   eg. M+3 on a 24 line screen will be line 15
</DD><DD>   M-5 on a 24 line screen will be line 7
<P></DD>
<DD> The second form of parameters is: <P></DD>
<DD>   [+|-]n
</DD><DD>   this sets the <A HREF = "glossary.html#CURRENTLINE">current line</A>  to be relative to the top of the
</DD><DD>   screen (if positive or no sign) or relative to the bottom
</DD><DD>   of the screen if negative.
</DD><DD>   eg. +3 or 3 will set current line to line 3
</DD><DD>   -3 on a 24 line screen will be line 21
<P></DD>
<DD> 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. <P></DD>
<DD> It is optional to specify the ON argument. <P></DD>
<DD> It is an error to try to position the CURLINE on the same           line as a line already allocated by one of <A HREF = "commset.html#SETHEXSHOW">SET HEXSHOW</A> , <A HREF = "commset.html#SETRESERVED">SET RESERVED</A> , <A HREF = "commset.html#SETSCALE">SET SCALE</A> or <A HREF = "commset.html#SETTABLINE">SET TABLINE</A> . <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> M <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETCURSORSTAY"></A>
<DL><DT>
<h3>SET CURSORSTAY -  set on or off the behaviour of the cursor on a scroll </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] CURSORSTay <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SETCURSORSTAY command allows the user to set the behaviour of           the cursor when the file is scrolled with a <A HREF = "comm.html#FORWARD">FORWARD</A> or <A HREF = "comm.html#BACKWARD">BACKWARD</A>            command. <P></DD>
<DD> Before this command was introduced, the position of the cursor           after the file was scrolled depended on <A HREF = "commset.html#SETCOMPAT">SET COMPAT</A> ; for           THE, the cursor moved to the current line, for XEDIT and KEDIT           modes the cursor stayed on the same screen line. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETDEFSORT"></A>
<DL><DT>
<h3>SET DEFSORT -  specify the order in which files appear in DIR.DIR </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] DEFSORT <I>OFF|DIRectory|Size|Date|Time|Name [Ascending|Descending]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET DEFSORT command allows the user to determine the order           in which files appear in a DIR.DIR file. <P></DD>
<DD> <I>Directory</I>  specifies that directories within the current directory           are shown before other files. <P></DD>
<DD> <I>Size</I>  specifies that the size of the file determines the order           in which files are displayed. <P></DD>
<DD> <I>Date</I>  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. <P></DD>
<DD> <I>Time</I>  specifies that the time of the file determines the order           in which files are displayed. <P></DD>
<DD> <I>Name</I>  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. <P></DD>
<DD> <I>OFF</I>  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. <P></DD>
<DD> The second parameter specifies if the sort order is ascending or           descending. <P></DD>
<DD> If this command is issued while the DIR.DIR pseudo file is the current           file, the settings are applied immediately. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Similar in functionality.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> NAME ASCENDING <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETDIRINCLUDE"></A>
<DL><DT>
<h3>SET DIRINCLUDE -  set the file mask for directory command </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] DIRInclude <I>*</I> <P></DD>
<DD> [SET] DIRInclude <I>[Normal] [Readonly] [System] [Hidden] [Directory]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DD> DIRINCLUDE R S <P></DD>
<DD> will display readonly and system files together with "normal" files           the next time the DIRECTORY command is issued. <P></DD>
<DD> The effects of DIRINCLUDE are ignored in the Unix version. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> * <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#DIRECTORY">DIRECTORY</A>, <A HREF = "comm.html#LS">LS</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETDISPLAY"></A>
<DL><DT>
<h3>SET DISPLAY -  specify which level of lines to display </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] DISPlay <I>n [m|*]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET DISPLAY command sets the selection level for lines to be           displayed on the screen. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> 0 0 <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETSCOPE">SET SCOPE</A>, <A HREF = "commset.html#SETSELECT">SET SELECT</A>, <A HREF = "comm.html#ALL">ALL</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETECOLOR"></A>
<DL><DT>
<h3>SET ECOLOR -  set colors for syntax highlighting </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] ECOLOR <I>char [modifier[...]] [foreground] [on background]</I> <P></DD>
<DD> [SET] ECOLOR <I>char [modifier[...]] ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET ECOLOR command allows the user to specify the colors of           each category of items used in syntax highlighting. <P></DD>
<DD> <I>char</I>  refers to one of the following valid values: <P></DD>
<DD>   A - comments
</DD><DD>   B - strings
</DD><DD>   C - numbers
</DD><DD>   D - keywords
</DD><DD>   E - labels
</DD><DD>   F - preprocessor directives
</DD><DD>   G - header lines
</DD><DD>   H - extra right paren, matchable keyword (N/A)
</DD><DD>   I - level 1 paren
</DD><DD>   J - level 1 matchable keyword (N/A)
</DD><DD>   K - level 1 matchable preprocessor keyword (N/A)
</DD><DD>   L - level 2 paren, matchable keyword (N/A)
</DD><DD>   M - level 3 paren, matchable keyword (N/A)
</DD><DD>   N - level 4 paren, matchable keyword (N/A)
</DD><DD>   O - level 5 paren, matchable keyword (N/A)
</DD><DD>   P - level 6 paren, matchable keyword (N/A)
</DD><DD>   Q - level 7 paren, matchable keyword (N/A)
</DD><DD>   R - level 8 paren or higher, matchable keyword (N/A)
</DD><DD>   S - incomplete string
</DD><DD>   T - HTML markup tags
</DD><DD>   U - HTML character/entity references
</DD><DD>   V - Builtin functions
</DD><DD>   W - not used
</DD><DD>   X - not used
</DD><DD>   Y - not used
</DD><DD>   Z - not used
</DD><DD>   1 - alternate keyword color 1
</DD><DD>   2 - alternate keyword color 2
</DD><DD>   3 - alternate keyword color 3
</DD><DD>   4 - alternate keyword color 4
</DD><DD>   5 - alternate keyword color 5
</DD><DD>   6 - alternate keyword color 6
</DD><DD>   7 - alternate keyword color 7
</DD><DD>   8 - alternate keyword color 8
</DD><DD>   9 - alternate keyword color 9
</DD><DD>   N/A indicates that this capability is not yet implemented.
<P></DD>
<DD> For valid values for  <I>modifier</I> ,  <I>foreground</I>  and  <I>background</I>            see <A HREF = "commset.html#SETCOLOR">SET COLOR</A> . <P></DD>
<DD> The second format of this command allows the user to turn on or off           any of the valid modifiers. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> See  <A HREF = "comm.html#QUERY">QUERY</A>  ECOLOR <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETCOLORING">SET COLORING</A>, <A HREF = "commset.html#SETAUTOCOLOR">SET AUTOCOLOR</A>, <A HREF = "commset.html#SETPARSER">SET PARSER</A>, <A HREF = "commset.html#SETCOLOR">SET COLOR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETECOLOUR"></A>
<DL><DT>
<h3>SET ECOLOUR -  set colours for syntax highlighting </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] ECOLOUR <I>char [modifier[...]] [foreground] [on background]</I> <P></DD>
<DD> [SET] ECOLOUR <I>char [modifier[...]] ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET ECOLOUR command allows the user to specify the colours of           each category of items used in syntax highlighting. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> See  <A HREF = "comm.html#QUERY">QUERY</A>  ECOLOR <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETCOLOURING">SET COLOURING</A>, <A HREF = "commset.html#SETAUTOCOLOUR">SET AUTOCOLOUR</A>, <A HREF = "commset.html#SETPARSER">SET PARSER</A>, <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETEOLOUT"></A>
<DL><DT>
<h3>SET EOLOUT -  set end of line terminating character(s) </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] EOLout <I>CRLF|LF|CR|NONE</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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  <I>LF</I> , DOS file usually end with a  <I>CR</I>  and            <I>LF</I>  combination. Files on the Apple Macintosh are usually terminated           with a  <I>CR</I> . <P></DD>
<DD> The  <I>NONE</I>  option can be used to specify that no end of line           character is written. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> LF - UNIX <P></DD>
<DD> CRLF - DOS/OS2/WIN32 <P></DD>
<DD> NONE - if THE started with -u option <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETEQUIVCHAR"></A>
<DL><DT>
<h3>SET EQUIVCHAR -  set the equivalence character </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] EQUIVChar <I>char</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET EQUIVChar command allows the user to change the character           that is used to specify eqivalence in command parameters. <P></DD>
<DD> In many THE commands, an equivalence character, usually  '=' , can           be used as a parameter to default to values in the current file           or view. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> = <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETETMODE"></A>
<DL><DT>
<h3>SET ETMODE -  indicate if extended display mode is possible </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] ETMODE <I>ON|OFF [character list]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET ETMODE command allows the user to specify which characters           in a character set are to be displayed as their actual representation. <P></DD>
<DD> Those characters not explicitly specified to be displayed as they are           represented, will be displayed as the <A HREF = "commset.html#SETNONDISP">SET NONDISP</A> character in the           colour specified by <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A>  NONDISP. Characters below 32, will           be displayed with an alphabetic character representing the "control"           code. <P></DD>
<DD> eg.           character code with a value of 7, will display as "G" in the colour           specified by <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A>  NONDISP. <P></DD>
<DD> <I>ON</I>  with no optional  <I>character list</I>  will display ALL           characters as their actual representation. <P></DD>
<DD> <I>OFF</I>  with no optional  <I>character list</I>  will display control           characters below ASCII 32, as a "control" character; characters           greater than ASCII 126 will be displayed as the <A HREF = "commset.html#SETNONDISP">SET NONDISP</A>            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 ??-?? <P></DD>
<DD> The  <I>character list</I>  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). <P></DD>
<DD> 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 <A HREF = "commset.html#SETNONDISP">SET NONDISP</A>            character. <P></DD>
<DD> Up to 20 character specifiers (single number or range) can be           specified. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Similar function but deals with Double-Byte characters
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON - DOS/OS2/WIN32 <P></DD>
<DD> ON 32-255 - X11 <P></DD>
<DD> OFF - UNIX/AMIGA/QNX <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETNONDISP">SET NONDISP</A>, <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETFEXT"></A>
<DL><DT>
<h3>SET FEXT -  change the extension of the existing file </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] FExt <I>ext</I> <P></DD>
<DD> [SET] FType <I>ext</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DD> See <A HREF = "commset.html#SETFILENAME">SET FILENAME</A>  for a full explanation of THE's definitions           of fpath, filename, fname, fext and fmode. <P></DD>
<DD> It is not possible to use this command on pseudo files. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETFNAME">SET FNAME</A>, <A HREF = "commset.html#SETFILENAME">SET FILENAME</A>, <A HREF = "commset.html#SETFTYPE">SET FTYPE</A>, <A HREF = "commset.html#SETFMODE">SET FMODE</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETFILENAME"></A>
<DL><DT>
<h3>SET FILENAME -  change the filename of the file being edited </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] FILEName <I>filename</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET FILEName command allows the user to change the filename of           the file currently being edited. <P></DD>
<DD> 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. <P></DD>
<DD> 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. <P></DD>
<DD> 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. <P></DD>
<DD> Some examples. <P></DD>
<PRE>
          Full File Name     File            File     Fname  Fext     Fmode
                             Path            Name
          -----------------------------------------------------------------
          /usr/local/bin/the /usr/local/bin/ the      the             N/A
          c:\tools\the.exe   c:\tools\       the.exe  the    exe      c
          /etc/a.b.c         /etc/           a.b.c    a.b    c        N/A
</PRE><P>
<DD>  <P></DD>
<DD> 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. <P></DD>
<DD> A leading "=" indicates that the fname portion of the current file           name is be retained.  This is equivalent to the command <A HREF = "commset.html#SETFEXT">SET FEXT</A> .  A trailing "=" indicates that the fext portion of           the current file name is to be retained. This is equivalent to the           command <A HREF = "commset.html#SETFNAME">SET FNAME</A> . <P></DD>
<DD> Only one "=" is allowed in the parameter. <P></DD>
<DD> Some examples. <P></DD>
<PRE>
          File Name   Parameter  New File Name
          -----------------------------------------------------------------
          a.b.c       fred.c=    fred.c.c      SET FNAME fred.c
          a.b.c       fred.c.=   fred.c..c     SET FNAME fred.c.
          a.b.c       =fred      a.c.fred      SET FEXT fred
          a.b.c       =.fred     a.c..fred     SET FEXT .fred
          a           =d         a.d           SET FEXT d
          a.b.c       =          a.b.c         does nothing
</PRE><P>
<DD>  <P></DD>
<DD> It is not possible to use this command on pseudo files. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETFPATH">SET FPATH</A>, <A HREF = "commset.html#SETFNAME">SET FNAME</A>, <A HREF = "commset.html#SETFEXT">SET FEXT</A>, <A HREF = "commset.html#SETFMODE">SET FMODE</A>, <A HREF = "commset.html#SETEQUIVCHAR">SET EQUIVCHAR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETFILETABS"></A>
<DL><DT>
<h3>SET FILETABS -  determine if and where where file tabs are positioned </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] FILETABS <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DD> The colour of the file tabs can be set with <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A> FILETABS.           The colour of the file dividers can be set with <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A>  FILETABSDIV. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A>, <A HREF = "comm.html#TABFILE">TABFILE</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETFMODE"></A>
<DL><DT>
<h3>SET FMODE -  change the drive letter of the existing file </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] FMode <I>d[:]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET FMode command allows the user to change the drive letter           of the file currently being edited. <P></DD>
<DD> This command is only valid under the DOS, OS/2 and Windows ports. <P></DD>
<DD> See <A HREF = "commset.html#SETFILENAME">SET FILENAME</A>  for a full explanation of THE's definitions           of fpath, filename, fname, fext and fmode. <P></DD>
<DD> It is not possible to use this command on pseudo files. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible
<P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETFNAME">SET FNAME</A>, <A HREF = "commset.html#SETFILENAME">SET FILENAME</A>, <A HREF = "commset.html#SETFEXT">SET FEXT</A>, <A HREF = "commset.html#SETFPATH">SET FPATH</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETFNAME"></A>
<DL><DT>
<h3>SET FNAME -  change the filename of the file being edited </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] FName <I>filename</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET FNAME command allows the user to change the fname of           the file currently being edited. <P></DD>
<DD> See <A HREF = "commset.html#SETFILENAME">SET FILENAME</A>  for a full explanation of THE's definitions           of fpath, filename, fname, fext and fmode. <P></DD>
<DD> 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. <P></DD>
<DD> It is not possible to use this command on pseudo files. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETFPATH">SET FPATH</A>, <A HREF = "commset.html#SETFILENAME">SET FILENAME</A>, <A HREF = "commset.html#SETFEXT">SET FEXT</A>, <A HREF = "commset.html#SETFMODE">SET FMODE</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETFPATH"></A>
<DL><DT>
<h3>SET FPATH -  change the path of the existing file </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] FPath <I>path</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET FPATH command allows the user to change the path of           the file currently being edited. <P></DD>
<DD> The  <I>path</I>  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. <P></DD>
<DD> See <A HREF = "commset.html#SETFILENAME">SET FILENAME</A>  for a full explanation of THE's definitions           of fpath, filename, fname, fext and fmode. <P></DD>
<DD> It is not possible to use this command on pseudo files. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETFNAME">SET FNAME</A>, <A HREF = "commset.html#SETFILENAME">SET FILENAME</A>, <A HREF = "commset.html#SETFEXT">SET FEXT</A>, <A HREF = "commset.html#SETFMODE">SET FMODE</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETFTYPE"></A>
<DL><DT>
<h3>SET FTYPE -  change the extension of the existing file </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] FType <I>ext</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET FTYPE is a synonym for <A HREF = "commset.html#SETFEXT">SET FEXT</A> . <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETFNAME">SET FNAME</A>, <A HREF = "commset.html#SETFILENAME">SET FILENAME</A>, <A HREF = "commset.html#SETFEXT">SET FEXT</A>, <A HREF = "commset.html#SETFMODE">SET FMODE</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETFULLFNAME"></A>
<DL><DT>
<h3>SET FULLFNAME -  specify if complete filename to be displayed </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] FULLFName <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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 <A HREF = "commset.html#SETFILENAME">SET FILENAME</A>  for a full explanation of THE's definitions           of fpath, filename, fname, fext and fmode. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETHEADER"></A>
<DL><DT>
<h3>SET HEADER -  turn on or off syntax highlighting headers </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] HEADer <I>section ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET HEADER command allows fine tuning of which sections of a           TLD file are to be applied for the current view. <P></DD>
<DD> <I>section</I>  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.            <I>section</I>  can also be specified as  '*' , in which case all headers           are applied or not applied. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> * ON <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETPARSER">SET PARSER</A>, <A HREF = "commset.html#SETCOLORING">SET COLORING</A>, <A HREF = "commset.html#SETAUTOCOLOR">SET AUTOCOLOR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETHEX"></A>
<DL><DT>
<h3>SET HEX -  set how hexadecimal strings are treated in string operands </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] HEX <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET HEX set command determines whether hexadecimal strings are           treated as such in string operands. <P></DD>
<DD> With the  <I>ON</I>  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. <P></DD>
<DD> With the  <I>OFF</I>  option, no conversion is done. <P></DD>
<DD> This conversion should work wherever a string operand is used           in any command. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Adds support for decimal representation. See below.
</DD><DD>   KEDIT: Compatible. See below.
</DD><DD>   Spaces must separate each character representation.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETHEXDISPLAY"></A>
<DL><DT>
<h3>SET HEXDISPLAY -  turn on or off display of character under cursor </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] HEXDISPlay <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET HEXDISPLAY command turns on or off the display of the           character under the cursor on the <A HREF = "glossary.html#STATUSLINE">status line</A> . <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete </DD>
</DL><P>
<HR>
<A NAME="SETHEXSHOW"></A>
<DL><DT>
<h3>SET HEXSHOW -  turn on or off hex display of current line </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] HEXShow <I>ON|OFF [M[+n|-n]|[+|-]n]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET HEXShow command indicates if and where a hexadecimal           representation of the <A HREF = "glossary.html#CURRENTLINE">current line</A>  will be displayed. <P></DD>
<DD> The first form of parameters is: <P></DD>
<DD>   M[+n|-n]
</DD><DD>   this sets the hexshow line to be relative to the middle of
</DD><DD>   the screen. A positive value adds to the middle line number,
</DD><DD>   a negative subtracts from it.
</DD><DD>   eg. M+3 on a 24 line screen will be line 15
</DD><DD>   M-5 on a 24 line screen will be line 7
<P></DD>
<DD> The second form of parameters is: <P></DD>
<DD>   [+|-]n
</DD><DD>   this sets the hexshow line to be relative to the top of the
</DD><DD>   screen (if positive or no sign) or relative to the bottom
</DD><DD>   of the screen if negative.
</DD><DD>   eg. +3 or 3 will set current line to line 3
</DD><DD>   -3 on a 24 line screen will be line 21
<P></DD>
<DD> 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. <P></DD>
<DD> The position argument specifies the position of the first line           of the hexadecimal display. <P></DD>
<DD> It is an error to try to position the HEXSHOW lines on the same           line as <A HREF = "commset.html#SETCURLINE">SET CURLINE</A> . <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF 7 <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete </DD>
</DL><P>
<HR>
<A NAME="SETHIGHLIGHT"></A>
<DL><DT>
<h3>SET HIGHLIGHT -  specify which lines (if any) are to be highlighted </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] HIGHlight <I>OFF|TAGged|ALTered|SELect n [m]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET HIGHLIGHT command allows for the user to specify which           lines are to be displayed in the highlighted colour. <P></DD>
<DD> <I>OFF</I>  turns all highlighting display off <P></DD>
<DD> <I>TAGGED</I>  displays all tagged lines in the highlight colour. <P></DD>
<DD> <I>ALTERED</I>  displays all lines that have been added or           changed in the current session in the highlight colour. <P></DD>
<DD> 'SELECT n [m]'  displays all lines with the specified selection           level in highlight colour. <P></DD>
<DD>  <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETSELECT">SET SELECT</A>, <A HREF = "comm.html#TAG">TAG</A>, <A HREF = "commset.html#SETLINEFLAG">SET LINEFLAG</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Ccomplete. </DD>
</DL><P>
<HR>
<A NAME="SETIDLINE"></A>
<DL><DT>
<h3>SET IDLINE -  specify if IDLINE is displayed </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] IDline <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET IDLINE set command determines if the <A HREF = "glossary.html#IDLINE">idline</A>  for a file is           displayed or not. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete </DD>
</DL><P>
<HR>
<A NAME="SETIMPCMSCP"></A>
<DL><DT>
<h3>SET IMPCMSCP -  set implied operating system command processing </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] IMPcmscp <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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 <A HREF = "comm.html#OS">OS</A>  command. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETIMPOS">SET IMPOS</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETIMPMACRO"></A>
<DL><DT>
<h3>SET IMPMACRO -  set implied macro command processing </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] IMPMACro <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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 <A HREF = "glossary.html#MACRO">macro</A> command without the need to prefix the macro name           with the <A HREF = "comm.html#MACRO">MACRO</A>  command. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#MACRO">MACRO</A>, <A HREF = "commset.html#SETMACROPATH">SET MACROPATH</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETIMPOS"></A>
<DL><DT>
<h3>SET IMPOS -  set implied operating system command processing </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] IMPOS <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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 <A HREF = "comm.html#OS">OS</A>  command. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETIMPCMSCP">SET IMPCMSCP</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETINPUTMODE"></A>
<DL><DT>
<h3>SET INPUTMODE -  set input mode behaviour </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] INPUTMode <I>OFF|FUll|LIne</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET INPUTMODE command changes the way THE handles input. <P></DD>
<DD> When INPUTMODE LINE is in effect, pressing the ENTER key while           in the <A HREF = "glossary.html#FILEAREA">filearea</A>  will result in a new line being added. <P></DD>
<DD> When INPUTMODE OFF is in effect, pressing the ENTER key while           in the <A HREF = "glossary.html#FILEAREA">filearea</A>  will result in the cursor moving to the           beginning of the next line; scrolling the screen if necessary. <P></DD>
<DD> When INPUTMODE FULL is in effect, pressing the ENTER key while           in the <A HREF = "glossary.html#FILEAREA">filearea</A>  will result in the cursor moving to the           beginning of the next line; scrolling the screen if necessary. <P></DD>
<DD>  <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> LINE <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#INPUT">INPUT</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Incomplete. No support for FULL option. </DD>
</DL><P>
<HR>
<A NAME="SETINSERTMODE"></A>
<DL><DT>
<h3>SET INSERTMODE -  put editor into or out of insert mode </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] INSERTMode <I>ON|OFF|TOGGLE</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET INSERTMODE command enable the user to set the insert mode           within THE. <P></DD>
<DD> The  <I>TOGGLE</I>  option turns insert mode  <I>ON</I>  if it is currently            <I>OFF</I>  and vice versa. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETINTERFACE"></A>
<DL><DT>
<h3>SET INTERFACE -  set overall behaviour of THE </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] INTerface <I>CLASSIC|CUA</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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 behaiour should           occur on various actions during the edit session. <P></DD>
<DD> 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. <P></DD>
<DD> 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: <P></DD>
<DD>   - entering text in the filearea with a marked CUA block will
</DD><DD>   first delete the block and reposition the cursor
</DD><DD>   - executing <A HREF = "commsos.html#SOSDELCHAR">SOS DELCHAR</A> or <A HREF = "commsos.html#SOSDELBACK">SOS DELBACK</A>  will delete the
</DD><DD>   marked CUA block
</DD><DD>   - executing any positioning command, such as <A HREF = "comm.html#CURSOR">CURSOR</A>  DOWN,
</DD><DD>    <A HREF = "comm.html#FORWARD">FORWARD</A> or <A HREF = "comm.html#CURSOR">CURSOR</A>  MOUSE, will unmark the CUA block
<P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible with KEDIT for Windows.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> CLASSIC <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#MARK">MARK</A>, <A HREF = "comm.html#CURSOR">CURSOR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETLASTOP"></A>
<DL><DT>
<h3>SET LASTOP -  set the contents of the lastop argument </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] LASTOP <I>operand text</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET LASTOP command sets the valus of the specified  <I>operand</I>  to the            <I>text</I>  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            <I>operand</I>  command; eg LOCATE, FIND, etc. <P></DD>
<DD> 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. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#LOCATE">LOCATE</A>, <A HREF = "comm.html#FIND">FIND</A>, <A HREF = "comm.html#SEARCH">SEARCH</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETLINEFLAG"></A>
<DL><DT>
<h3>SET LINEFLAG -  set the line characteristics of lines </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] LINEFLAG <I>CHAnge|NOCHange NEW|NONEW TAG|NOTAG [target]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET LINEFLAGS command controls the line characteristics of lines           in a file. <P></DD>
<DD> 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. <P></DD>
<DD> 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 <A HREF = "comm.html#TAG">TAG</A>  command, is set to TAG.  All three characteristics can be on           at the one time. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> NOCHANGE NONEW NOTAG <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#TAG">TAG</A>, <A HREF = "commset.html#SETHIGHLIGHT">SET HIGHLIGHT</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETLINEND"></A>
<DL><DT>
<h3>SET LINEND -  allow/disallow multiple commands on command line </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] LINENd <I>ON|OFF [character]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET LINEND command allows or disallows the execution of multiple           commands on the <A HREF = "glossary.html#COMMANDLINE">command line</A> . When setting LINEND ON, a  <I>character</I>            is specified as the LINEND character which delimits each command. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF # <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETMACRO"></A>
<DL><DT>
<h3>SET MACRO -  indicate if macros executed before commands </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> SET MACRO <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET MACRO command allows the user to determine if macros           are executed before a built-in command of the same name. <P></DD>
<DD> This command MUST be prefixed with <A HREF = "comm.html#SET">SET</A> to distinguish it           from the <A HREF = "comm.html#MACRO">MACRO</A>  command. <P></DD>
<DD> A macro with the same name as a built-in command will only           be executed before the built-in command if <A HREF = "commset.html#SETIMPMACRO">SET IMPMACRO</A> is ON, <A HREF = "commset.html#SETMACRO">SET MACRO</A> is ON, and the command was NOT executed           with the <A HREF = "comm.html#COMMAND">COMMAND</A>  command. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#MACRO">MACRO</A>, <A HREF = "commset.html#SETIMPMACRO">SET IMPMACRO</A>, <A HREF = "comm.html#COMMAND">COMMAND</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETMACROEXT"></A>
<DL><DT>
<h3>SET MACROEXT -  set default macro extension value </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] MACROExt <I>[ext]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET MACROEXT command sets the value of the file extension to be           used for <A HREF = "glossary.html#MACRO">macro</A> files. When a macro file name is specified on the <A HREF = "glossary.html#COMMANDLINE">command line</A> , a period  '.' , then this value will be appended.           If no value is specified for  <I>ext</I> , then THE assumes that the           supplied macro file name is the fully specified name for a macro. <P></DD>
<DD> The length of  <I>ext</I>  must be 10 characters or less. <P></DD>
<DD> The macro extension is only appended to a file if that file does           not include any path specifiers. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> the <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETMACROPATH"></A>
<DL><DT>
<h3>SET MACROPATH -  set default path for macro commands </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] MACROPath <I>PATH|path[s]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DD> When  <I>PATH</I>  is specified, the search path is set to the system           PATH environment variable. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Incompatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> Path specified by env variable THE_MACRO_PATH <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#MACRO">MACRO</A>, <A HREF = "commset.html#SETIMPMACRO">SET IMPMACRO</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETMARGINS"></A>
<DL><DT>
<h3>SET MARGINS -  set left and right margins for wordwrap </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] MARgins <I>left right [[+|-]indent]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET MARGINS command sets the  <I>left</I>  and  <I>right</I>  margins and the           number of columns to  <I>indent</I>  a paragraph. <P></DD>
<DD> These values are used with the <A HREF = "commset.html#SETWORDWRAP">SET WORDWRAP</A>  option. <P></DD>
<DD> All options can be specified as the current EQUIVCHAR to retain the           existing value. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> 1 72 +0 <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETWORDWRAP">SET WORDWRAP</A>, <A HREF = "commset.html#SETEQUIVCHAR">SET EQUIVCHAR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETMOUSE"></A>
<DL><DT>
<h3>SET MOUSE -  turn mouse support on or off </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] MOUSE <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DD> If the platform does not support mouse operations, the default           setting will be OFF. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible. Does not support all options.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON - if mouse supported, OFF - otherwise <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#DEFINE">DEFINE</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETMSGLINE"></A>
<DL><DT>
<h3>SET MSGLINE -  set position and size of message line </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] MSGLine <I>ON M[+n|-n]|[+|-]n [lines] [Overlay]</I> <P></DD>
<DD> [SET] MSGLine <I>CLEAR</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET MSGLINE set command specifies the position of the <A HREF = "glossary.html#MESSAGELINE">message line</A>  and the size of the message line window. <P></DD>
<DD> The first form of positional parameters is: <P></DD>
<DD>   M[+n|-n]
</DD><DD>   this sets the first line to be relative to the middle of
</DD><DD>   the screen. A positive value adds to the middle line number,
</DD><DD>   a negative subtracts from it.
</DD><DD>   eg. M+3 on a 24 line screen will be line 15
</DD><DD>   M-5 on a 24 line screen will be line 7
<P></DD>
<DD> The second form of positional parameters is: <P></DD>
<DD>   [+|-]n
</DD><DD>   this sets the first line to be relative to the top of the
</DD><DD>   screen (if positive or no sign) or relative to the bottom
</DD><DD>   of the screen if negative.
</DD><DD>   eg. +3 or 3 will set first line to line 3
</DD><DD>   -3 on a 24 line screen will set first line to line 21
<P></DD>
<DD> 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. <P></DD>
<DD> The  <I>lines</I>  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. <P></DD>
<DD> All options can be specified as the current EQUIVCHAR to retain the           existing value. <P></DD>
<DD> 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. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   The OVERLAY option is the default but ignored.
</DD><DD>   The second format is not supported.
</DD><DD>   KEDIT: Compatible
</DD><DD>   The OVERLAY option is the default but ignored.
</DD><DD>   The second format is not supported.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON 2 5 Overlay <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETEQUIVCHAR">SET EQUIVCHAR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete </DD>
</DL><P>
<HR>
<A NAME="SETMSGMODE"></A>
<DL><DT>
<h3>SET MSGMODE -  set display of messages on or off </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] MSGMode <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET MSGMODE set command determines whether error messages will           be displayed or suppressed. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Does not support [Short|Long] options.
</DD><DD>   KEDIT: Compatible
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete </DD>
</DL><P>
<HR>
<A NAME="SETNEWLINES"></A>
<DL><DT>
<h3>SET NEWLINES -  set position of cursor after adding blank line </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] NEWLines <I>Aligned|Left</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET NEWLINES set command determines where the cursor displays           after a new line is added to the file. <P></DD>
<DD> With  <I>ALIGNED</I> , the cursor will display in the column of the new line           immediately underneath the first non-blank character in the line           above.           With  <I>LEFT</I> , the cursor will display in the first column of the new           line. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Same command, different functionality.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> Aligned <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete </DD>
</DL><P>
<HR>
<A NAME="SETNONDISP"></A>
<DL><DT>
<h3>SET NONDISP -  specify character to display for non-displaying characters </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] NONDisp <I>character</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET NONDISP command allows the user to change the  <I>character</I>            that is displayed for non-displaying commands when <A HREF = "commset.html#SETETMODE">SET ETMODE</A>            is OFF. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> # <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETETMODE">SET ETMODE</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETNUMBER"></A>
<DL><DT>
<h3>SET NUMBER -  turn prefix numbers on or off </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] NUMber <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET NUMBER command allows the user to set the display of           numbers in the <A HREF = "glossary.html#PREFIXAREA">prefix area</A> . <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETPREFIX">SET PREFIX</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETPAGEWRAP"></A>
<DL><DT>
<h3>SET PAGEWRAP -  determine if page scrolling wraps at bottom/top of file </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] PAGEWRAP <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET PAGEWRAP command allows the user to turn on or off the           automatic wrapping of <A HREF = "comm.html#FORWARD">FORWARD</A> and <A HREF = "comm.html#BACKWARD">BACKWARD</A> commands when the cursor           is at the <A HREF = "glossary.html#BOTTOM-OF-FILELINE">Bottom-of-File line</A> or <A HREF = "glossary.html#TOP-OF-FILELINE">Top-of-File line</A>  respectively. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETPARSER"></A>
<DL><DT>
<h3>SET PARSER -  associates a language definition file with a parser </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] PARSER <I>parser file</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET PARSER defines a new syntax highlighting <A HREF = "glossary.html#PARSER">parser</A> ;  <I>parser</I>  based           on a language definition file;  <I>file</I> . <P></DD>
<DD> The  <I>file</I>  is looked for in the directories specified by <A HREF = "commset.html#SETMACROPATH">SET MACROPATH</A> . <P></DD>
<DD> To specify one of the builtin parsers, prefix the filename with  '*' .           Therefore to define a <A HREF = "glossary.html#PARSER">parser</A>  called FRED using the builtin C parser,           the command would be: SET PARSER FRED *C.TLD. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETCOLORING">SET COLORING</A>, <A HREF = "commset.html#SETECOLOUR">SET ECOLOUR</A>, <A HREF = "commset.html#SETAUTOCOLOR">SET AUTOCOLOR</A>, <A HREF = "commset.html#SETMACROPATH">SET MACROPATH</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETPENDING"></A>
<DL><DT>
<h3>SET PENDING -  set status of pending prefix commands </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] PENDing <I>ON string</I> <P></DD>
<DD> [SET] PENDing <I>OFF</I> <P></DD>
<DD> [SET] PENDing <I>BLOCK string</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET PENDING command allows the user to insert or remove commands           from the pending prefix list. <P></DD>
<DD> ON string, simulates the user typing  <I>string</I>  in the <A HREF = "glossary.html#PREFIXAREA">prefix area</A> of the <A HREF = "glossary.html#FOCUSLINE">focus line</A> . <P></DD>
<DD> OFF, removes any pending prefix command from the focus line. <P></DD>
<DD> BLOCK string, simulates the user typing  <I>string</I>  in the PREFIX           area of the focus line and identifies the prefix command to be           a BLOCK command. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Does not support ERROR option.
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETPOINT"></A>
<DL><DT>
<h3>SET POINT -  assign a name to the current line </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] Point <I>.name [OFF]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET POINT command assignes the specified name to the <A HREF = "glossary.html#FOCUSLINE">focus line</A> , or removes the name from the line with the specified           name.           A valid line name must start with a  '.'  followed by alphanumeric           characters. eg. .a .fred and .3AB are valid names. <P></DD>
<DD> When a line is moved within the same file, its line name stays           with the line. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible. See below.
</DD><DD>   KEDIT: Compatible. See below.
</DD><DD>   Does not allow for multiple names for the same line.
<P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETPOSITION"></A>
<DL><DT>
<h3>SET POSITION -  determine if LINE/COL is displayed on idline </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] POSition <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET POSITION command allows the user to turn on or off the           display of LINE/COL on the <A HREF = "glossary.html#IDLINE">idline</A> . <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETPREFIX"></A>
<DL><DT>
<h3>SET PREFIX -  set prefix area attributes </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] PREfix <I>ON [Left|Right] [n [m]]</I> <P></DD>
<DD> [SET] PREfix <I>Nulls [Left|Right] [n [m]]</I> <P></DD>
<DD> [SET] PREfix <I>OFF</I> <P></DD>
<DD> [SET] PREfix <I>Synonym newname oldname</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The first form of the SET PREFIX command allows the user to display           the <A HREF = "glossary.html#PREFIXAREA">prefix area</A>  and optionally to select the position were the           prefix should be displayed. <P></DD>
<DD> 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 <A HREF = "commset.html#SETNUMBER">SET NUMBER</A> ON, numbers are displyed with leading           spaces rather than zeros; with <A HREF = "commset.html#SETNUMBER">SET NUMBER</A>  OFF, blanks are displayed           instead of equal signs. <P></DD>
<DD> 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. <P></DD>
<DD> The fourth form of the SET PREFIX command allows the user to specify           a synonym for a prefix command or Rexx prefix macro. The  <I>newname</I>            is the command entered in the prefix area and  <I>oldname</I>  corresponds           to an existing prefix command or a Rexx macro file in the MACROPATH           ending in .the or whatever the value of <A HREF = "commset.html#SETMACROEXT">SET MACROEXT</A>  is at the time the           prefix command is executed. The  <I>oldname</I>  can also be the fully           qualified filename of a Rexx macro. <P></DD>
<DD> 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.            <I>m</I>  can be specified as an unsigned number between 2 and 20 inclusive.            <I>n</I>  can be specified as an unsigned number between 0 and 18, but less           than the number specified in  <I>m</I> . <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: Compatible.
</DD><DD>   Specification of prefix width is a THE-only option.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON Left 6 0 <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETPRINTER"></A>
<DL><DT>
<h3>SET PRINTER -  define printer spooler name </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] PRINTER <I>spooler|[OPTION options]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET PRINTER command sets up the print spooler name to determine           where output from the <A HREF = "comm.html#PRINT">PRINT</A>  command goes. <P></DD>
<DD> The  <I>options</I>  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) <P></DD>
<DD> No checking is done for printer options. ie. You may specify a           font that THE doesn 't know about, and the printing process may           not work after that.' <P></DD>
<DD> The defaults for page layout for Win32 are:           CPI 16           LPI 8           ORIENTation Portrait           FONT LinePrinter BM <P></DD>
<DD> <I>options</I>  are only valid for Win32 platform.           Printer output for the Win32 platform ALWAYS goes to the default           printer. Therefore, the  <I>spooler</I>  option is invalid on this           platform. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible. THE adds more funtionality.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> LPT1 - DOS/OS2, lpr - Unix, default - Win32 <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#PRINT">PRINT</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETPSCREEN"></A>
<DL><DT>
<h3>SET PSCREEN -  set physical size of screen </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] PSCReen <I>height [width] [RESET|PRESET]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET PSCREEN command allows the user to adjust the size of the           physical screen to the size specified by  <I>height</I>  and  <I>width</I> . <P></DD>
<DD> This command does not work on all platforms. <P></DD>
<DD> The optional argument [RESET|PRESET] are ignored; they are there           for Kedit compatibility. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible. Ignores RESET|PRESET argument
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> System Dependent <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Incomplete. </DD>
</DL><P>
<HR>
<A NAME="SETREADONLY"></A>
<DL><DT>
<h3>SET READONLY -  allow/disallow changes to a file if it is readonly </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] READONLY <I>ON|OFF|FORCE</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DD> 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. <P></DD>
<DD> 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. <P></DD>
<DD> 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 current file irrespective of whether it is readonly on disk. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETREGEXP"></A>
<DL><DT>
<h3>SET REGEXP -  specify the regular expression syntax to use </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] REGEXP <I>syntax</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET REGEXP command allows the user specify which of the many           regular expression syntaxes to use when using regular expressions           in a <A HREF = "glossary.html#TARGET">target</A> .           The  <I>syntax</I>  can be specified as one of: <P></DD>
<DD>   EMACS
</DD><DD>   AWK
</DD><DD>   POSIX_AWK
</DD><DD>   GREP
</DD><DD>   EGREP
</DD><DD>   POSIX_EGREP
</DD><DD>   SED
</DD><DD>   POSIX_BASIC
</DD><DD>   POSIX_MINIMAL_BASIC
</DD><DD>   POSIX_EXTENDED
</DD><DD>   POSIX_MINIMAL_EXTENDED
<P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> EMACS <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#LOCATE">LOCATE</A>, <A HREF = "comm.html#ALL">ALL</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete </DD>
</DL><P>
<HR>
<A NAME="SETREPROFILE"></A>
<DL><DT>
<h3>SET REPROFILE -  indicate if profile file to be executed for all files </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] REPROFile <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET REPROFILE command allows the user to determine if the <A HREF = "glossary.html#PROFILE">profile</A>  file is to reexecuted for files subsequenlty edited. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#XEDIT">XEDIT</A>, <A HREF = "comm.html#EDIT">EDIT</A>, <A HREF = "comm.html#THE">THE</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete </DD>
</DL><P>
<HR>
<A NAME="SETRESERVED"></A>
<DL><DT>
<h3>SET RESERVED -  display a reserved line </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] RESERved <I>[AUTOSCroll] *|+|-n [colour] [text|OFF]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DD> 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. <P></DD>
<DD> The <A HREF = "glossary.html#IDLINE">idline</A>  of a file will always be displayed after any reserved           lines. <P></DD>
<DD> The <A HREF = "glossary.html#STATUSLINE">status line</A>  is not considered part of the displayable area,           so any positioning specifications ignore that line. <P></DD>
<DD> A <A HREF = "glossary.html#RESERVEDLINE">reserved line</A> can only be turned off by identifying it in the           same way that it was defined.  If a <A HREF = "glossary.html#RESERVEDLINE">reserved line</A>  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. <P></DD>
<DD> All reserved lines may be turned of by specifying * as the number           of lines. <P></DD>
<DD> 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  <I>AUTOSCroll</I>  option, the text of the reserved line is           scrolled with the file contents using the same settings as <A HREF = "commset.html#SETAUTOSCROLL">SET AUTOSCROLL</A> . <P></DD>
<DD> The colour option specifies the colours to use to display the           reserved line. The format of this colour specifier is the same           as for <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A> . If no colour is specified, the colour of the           reserved line will be the colour set by any <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A>  RESERVED           command for the view or white on black by default. <P></DD>
<DD> The text of reserved lines can also included embedded control           characters to control the colour of portions of the text.           Assume the following <A HREF = "commset.html#SETCTLCHAR">SET CTLCHAR</A>  commands have been issued: <P></DD>
<DD>   SET CTLCHAR ESCAPE !
</DD><DD>   SET CTLCHAR @ PROTECT BOLD RED ON WHITE
</DD><DD>   SET CTLCHAR % PROTECT GREEN ON BLACK
<P></DD>
<DD> Then to display a <A HREF = "glossary.html#RESERVEDLINE">reserved line</A>  using the specified colours: <P></DD>
<DD>   SET RESERVED -1 normal!@bold red on white!%green on black
<P></DD>
<DD> It is an error to try to reserve a line which is the same line as <A HREF = "commset.html#SETCURLINE">SET CURLINE</A> . <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: Compatible.
</DD><DD>   AUTOSCroll option is a THE extension.
<P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A>, <A HREF = "commset.html#SETCTLCHAR">SET CTLCHAR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETREXXHALT"></A>
<DL><DT>
<h3>SET REXXHALT -  halt Rexx macro after specified number of events </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] REXXHALT <I>Command|Function n|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DD> A Rexx HALT condition can be triggered by the user at the prompt displayed           when the <A HREF = "glossary.html#MESSAGELINE">message line</A>  is full. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETREXXOUTPUT"></A>
<DL><DT>
<h3>SET REXXOUTPUT -  indicate where Rexx output is to go </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] REXXOUTput <I>File|Display n</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DD> 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 <A HREF = "glossary.html#MACRO">macro</A>  gets into an infinite           loop. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> Display 1000 <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETSCALE"></A>
<DL><DT>
<h3>SET SCALE -  set position and status of scale line on screen </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] SCALe <I>ON|OFF [M[+n|-n]|[+|-]n]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET SCALE command sets the position and status of the scale line           for the current view. <P></DD>
<DD> The first form of parameters is: <P></DD>
<DD>   M[+n|-n]
</DD><DD>   this sets the <A HREF = "glossary.html#SCALELINE">scale line</A>  to be relative to the middle of
</DD><DD>   the screen. A positive value adds to the middle line number,
</DD><DD>   a negative subtracts from it.
</DD><DD>   eg. M+3 on a 24 line screen will be line 15
</DD><DD>   M-5 on a 24 line screen will be line 7
<P></DD>
<DD> The second form of parameters is: <P></DD>
<DD>   [+|-]n
</DD><DD>   this sets the <A HREF = "glossary.html#SCALELINE">scale line</A>  to be relative to the top of the
</DD><DD>   screen (if positive or no sign) or relative to the bottom
</DD><DD>   of the screen if negative.
</DD><DD>   eg. +3 or 3 will set current line to line 3
</DD><DD>   -3 on a 24 line screen will be line 21
<P></DD>
<DD> 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. <P></DD>
<DD> It is an error to try to position the SCALE line on the same           line as <A HREF = "commset.html#SETCURLINE">SET CURLINE</A> . <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF M+1 <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETSCOPE"></A>
<DL><DT>
<h3>SET SCOPE -  sets which lines are to be excluded from commands </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] SCOPE <I>All|Display</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET SCOPE command indicates whether lines not displayed as           the result of a <A HREF = "commset.html#SETDISPLAY">SET DISPLAY</A> or <A HREF = "comm.html#ALL">ALL</A>  command are included in           the scope of lines to be acted upon by other THE commands. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> Display <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETDISPLAY">SET DISPLAY</A>, <A HREF = "commset.html#SETSELECT">SET SELECT</A>, <A HREF = "comm.html#ALL">ALL</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Completed. </DD>
</DL><P>
<HR>
<A NAME="SETSCREEN"></A>
<DL><DT>
<h3>SET SCREEN -  specify number of screens displayed </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] SCReen <I>n [Horizontal|Vertical]</I> <P></DD>
<DD> [SET] SCReen <I>Size l1|* [l2|*]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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 <A HREF = "glossary.html#RING">ring</A> , two views of the           same file are displayed. <P></DD>
<DD> The second form of SET SCREEN allows the user to specify the           number of lines that each screen occupies.  The sum of  <I>l1</I>  and            <I>l2</I>  must equal to lscreen.5 or lscreen.5 - 1 if the <A HREF = "glossary.html#STATUSLINE">status line</A>            is displayed. <P></DD>
<DD> The value of  <I>l1</I>  specifies the size of the topmost screen;  <I>l2</I>            specifies the size of the bottommost screen. <P></DD>
<DD> Either  <I>l1</I>  or  <I>l2</I>  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. <P></DD>
<DD> The THE display can only be split into 1 or 2 screens. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Does not support Width or Define options.
</DD><DD>   KEDIT: Does not support Split option.
</DD><DD>   A maximum of 2 screens are supported.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> 1 <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETSTATUSLINE">SET STATUSLINE</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETSELECT"></A>
<DL><DT>
<h3>SET SELECT -  sets the selection level for the specified lines </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] SELect <I>[+|-]n [target]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET SELECT command sets the selection level for the indicated           lines equal to  <I>n</I>  (if no signs are specified) or adds or subtracts           n from the selection level currently set for the lines in the           target. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> 0 <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETSCOPE">SET SCOPE</A>, <A HREF = "commset.html#SETDISPLAY">SET DISPLAY</A>, <A HREF = "comm.html#ALL">ALL</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETSHADOW"></A>
<DL><DT>
<h3>SET SHADOW -  determines if shadow lines are displayed or not </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] SHADOW <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET SHADOW command indicates whether <A HREF = "glossary.html#SHADOWLINE">shadow line</A> s are to be           displayed. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETDISPLAY">SET DISPLAY</A>, <A HREF = "commset.html#SETSELECT">SET SELECT</A>, <A HREF = "comm.html#ALL">ALL</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Completed. </DD>
</DL><P>
<HR>
<A NAME="SETSLK"></A>
<DL><DT>
<h3>SET SLK -  set Soft Label Key definitions </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] SLK <I>n|OFF [text]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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, or the last line of           the screen. <P></DD>
<DD> The  <I>n</I>  argument of the command represents the label           number from left to right, with the first label numbered 1. <P></DD>
<DD> <I>OFF</I>  turns off display of the Soft Label Keys. This is the same as           executing [SET] SLK n with no optional text for each label           displayed. <P></DD>
<DD> The main use for this command is to describe the function assigned           to a function key, in place of a <A HREF = "glossary.html#RESERVEDLINE">reserved line</A> . <P></DD>
<DD> 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. <P></DD>
<DD> The number of Soft Label Keys displayed is dependent on which           curses library THE is using.  PDCurses can display 10 keys with           the length of the  <I>text</I>  argument 7 characters on a screen that           is 80 columns wide.  The number of characters that can be           displayed increases with the width of the screen.           Other curses implementations, limit the number of Soft Label Keys           to 8, with a text width of 8 characters.  Some curses           implementations do not support Soft Label Keys. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETSPAN"></A>
<DL><DT>
<h3>SET SPAN -  specify if a string target can span multiple lines (unavailable) </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] SPAN <I>ON|OFF [Blank|Noblank [n|*]]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF Blank 2 <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Not started. </DD>
</DL><P>
<HR>
<A NAME="SETSPILL"></A>
<DL><DT>
<h3>SET SPILL -  specify if a string target can span multiple lines (unavailable) </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] SPILL <I>ON|OFF|WORD</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Not started. </DD>
</DL><P>
<HR>
<A NAME="SETSTATOPT"></A>
<DL><DT>
<h3>SET STATOPT -  set display options on statusline </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] STATOPT <I>ON option column [length [prompt] ]</I> <P></DD>
<DD> [SET] STATOPT <I>OFF option|*</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET STATOPT command allows the user to specify which internal           settings of THE are to be displayed on the <A HREF = "glossary.html#STATUSLINE">status line</A> . <P></DD>
<DD> The  <I>option</I>  argument is any value returned by the <A HREF = "comm.html#EXTRACT">EXTRACT</A>            command. eg NBFILE.1. <P></DD>
<DD> The syntax of the ON option, displays the specified value, at the           position in the <A HREF = "glossary.html#STATUSLINE">status line</A>  specified by  <I>column</I> .  If supplied,            <I>length</I>  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            <I>prompt</I>  argument, allows the user to specify a string to display           immediately before the returned value. <P></DD>
<DD> OFF, removes the specified  <I>option</I>  from displaying.  If  <I>*</I>            is specified, all displayed options will be removed. <P></DD>
<DD> <I>column</I>  is relative to the start of the <A HREF = "glossary.html#STATUSLINE">status line</A> .  The           value of  <I>column</I>  must be > 9, so that the version of THE is           not obscured. <P></DD>
<DD> Options will be displayed in the order in which they are set. <P></DD>
<DD> If <A HREF = "commset.html#SETCLOCK">SET CLOCK</A> or <A HREF = "commset.html#SETHEX">SET HEX</A>  are ON, these will take precedence           over options specified with this command. <P></DD>
<DD> The more values you display the longer it will take THE to display           the <A HREF = "glossary.html#STATUSLINE">status line</A> .  Also, some values that are available via <A HREF = "comm.html#EXTRACT">EXTRACT</A>  are not really suitable for use here. eg CURLINE.3. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON NBFILE.1 13 0 Files= <P></DD>
<DD> ON WIDTH.1 23 0 Width= <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETSTATUSLINE"></A>
<DL><DT>
<h3>SET STATUSLINE -  set position of status line </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] STATUSLine <I>Top|Bottom|Off|GUI</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD>  <P></DD>
<DD> The SET STATUSLINE command determines the position of the <A HREF = "glossary.html#STATUSLINE">status line</A>  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. <P></DD>
<DD> 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. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
</DD><DD>   Added GUI option for THEdit port.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> Bottom <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete </DD>
</DL><P>
<HR>
<A NAME="SETSTAY"></A>
<DL><DT>
<h3>SET STAY -  set condition of cursor position after CHANGE/LOCATE commands </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] STAY <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET STAY set command determines what line is displayed as the           current line after an unsuccessful <A HREF = "comm.html#LOCATE">LOCATE</A> or successful <A HREF = "comm.html#CHANGE">CHANGE</A>            command. <P></DD>
<DD> With STAY ON, the <A HREF = "glossary.html#CURRENTLINE">current line</A>  remains where it currently is. <P></DD>
<DD> With STAY OFF, after an unsuccessful <A HREF = "comm.html#LOCATE">LOCATE</A> , the <A HREF = "glossary.html#CURRENTLINE">current line</A> becomes the <A HREF = "glossary.html#BOTTOM-OF-FILELINE">Bottom-of-File line</A> (or <A HREF = "glossary.html#TOP-OF-FILELINE">Top-of-File line</A>  if direction           is backwards). <P></DD>
<DD> After a successful <A HREF = "comm.html#CHANGE">CHANGE</A> , the <A HREF = "glossary.html#CURRENTLINE">current line</A> is the last           line affected by the <A HREF = "comm.html#CHANGE">CHANGE</A>  command. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete </DD>
</DL><P>
<HR>
<A NAME="SETSYNONYM"></A>
<DL><DT>
<h3>SET SYNONYM -  define synonyms for commands (unavailable) </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] SYNonym <I>ON|OFF</I> <P></DD>
<DD> [SET] SYNonym <I>[LINEND char] newname [n] definition</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET SYNONYM command allows the user to define synonyms for           commands or macros. <P></DD>
<DD> The first format indicates if synonym processing is to be performed. <P></DD>
<DD> The second format defines a command synonym. <P></DD>
<DD> The synonym is  <I>newname</I> , which effectively adds a new THE           command with the definition specified by  <I>definition</I> .  The  <I>n</I>            parameter defines the minimum length of the abbreviation for           the new command           An optional LINEND character can be specified prior to  <I>newname</I>            if the  <I>definition</I>  contains multiple commands. <P></DD>
<DD> <I>definition</I>  can be of the form:           [REXX] command [args] [#command [args] [...]]           (where # represents the LINEND character specified prior to            <I>newname</I> ) <P></DD>
<DD> 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. <P></DD>
<DD> Only 1 level of synonym processing is carried out; therefore           a synonym cannot be specified in the  <I>definition</I> . <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible. Does not support format that can reorder parameters.
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Incomplete. </DD>
</DL><P>
<HR>
<A NAME="SETTABKEY"></A>
<DL><DT>
<h3>SET TABKEY -  set characteristics of the SOS TABF command </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] TABKey <I>Tab|Character Tab|Character</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET TABKEY sets the action to be taken when the <A HREF = "commsos.html#SOSTABF">SOS TABF</A> command is executed. Depending on the insert mode, the <A HREF = "commsos.html#SOSTABF">SOS TABF</A>            command will either display a raw tab character or will move to           the next tab column. <P></DD>
<DD> The first operand refers to the behaviour of the <A HREF = "commsos.html#SOSTABF">SOS TABF</A> command           when <A HREF = "commset.html#SETINSERTMODE">SET INSERTMODE</A>  is OFF. <P></DD>
<DD> The second operand specifies the behaviour when the <A HREF = "commsos.html#SOSTABF">SOS TABF</A> command is executed when <A HREF = "commset.html#SETINSERTMODE">SET INSERTMODE</A>  is ON. <P></DD>
<DD> All options can be specified as the current EQUIVCHAR to retain the           existing value. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> Tab Character <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETEQUIVCHAR">SET EQUIVCHAR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete </DD>
</DL><P>
<HR>
<A NAME="SETTABLINE"></A>
<DL><DT>
<h3>SET TABLINE -  set position and status of tab line on screen </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] TABLine <I>ON|OFF [M[+n|-n]|[+|-]n]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET TABLINE command sets the position and status of the <A HREF = "glossary.html#TABLINE">tab line</A>            for the current view. <P></DD>
<DD> The first form of parameters is: <P></DD>
<DD>   M[+n|-n]
</DD><DD>   this sets the <A HREF = "glossary.html#TABLINE">tab line</A>  to be relative to the middle of
</DD><DD>   the screen. A positive value adds to the middle line number,
</DD><DD>   a negative subtracts from it.
</DD><DD>   eg. M+3 on a 24 line screen will be line 15
</DD><DD>   M-5 on a 24 line screen will be line 7
<P></DD>
<DD> The second form of parameters is: <P></DD>
<DD>   [+|-]n
</DD><DD>   this sets the <A HREF = "glossary.html#TABLINE">tab line</A>  to be relative to the top of the
</DD><DD>   screen (if positive or no sign) or relative to the bottom
</DD><DD>   of the screen if negative.
</DD><DD>   eg. +3 or 3 will set current line to line 3
</DD><DD>   -3 on a 24 line screen will be line 21
<P></DD>
<DD> 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. <P></DD>
<DD> It is an error to try to position the TABL line on the same           line as <A HREF = "commset.html#SETCURLINE">SET CURLINE</A> . <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF -3 <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETTABS"></A>
<DL><DT>
<h3>SET TABS -  set tab columns or tab length </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] TABS <I>n1 [n2 ... n32]</I> <P></DD>
<DD> [SET] TABS <I>INCR n</I> <P></DD>
<DD> [SET] TABS <I>OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET TABS command determines the position of tab columns in THE. <P></DD>
<DD> The first format of SET TABS, specifies individual tab columns. Each           column must be greater than the column to its left. <P></DD>
<DD> The second format specifies the tab increment to use. ie each tab           column will be set at each  <I>n</I>  columns. <P></DD>
<DD> The third format specifies that no tab columns are to be set. <P></DD>
<DD> Tab columns are used by <A HREF = "commsos.html#SOSTABF">SOS TABF</A> , <A HREF = "commsos.html#SOSTABB">SOS TABB</A> and <A HREF = "commsos.html#SOSSETTAB">SOS SETTAB</A> commands to position the cursor and also by the <A HREF = "comm.html#COMPRESS">COMPRESS</A> and <A HREF = "comm.html#EXPAND">EXPAND</A>  commands. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible. Does not support OFF option.
</DD><DD>   KEDIT: Compatible. Does not support OFF option.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> INCR 8 <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETTABSIN"></A>
<DL><DT>
<h3>SET TABSIN -  set tab processing on file input </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] TABSIn <I>ON|OFF [n]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET TABSIN command determines if tabs read from a file are to be           expanded to spaces and if so how many spaces. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Does not support TABQUOTE option.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF 8 <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETTABSOUT">SET TABSOUT</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETTABSOUT"></A>
<DL><DT>
<h3>SET TABSOUT -  set tab processing on file output </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] TABSOut <I>ON|OFF [n]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET TABSOUT command determines if spaces written to a file are to           be compressed to tabs and if so how many spaces. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF 8 <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETTABSIN">SET TABSIN</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETTARGETSAVE"></A>
<DL><DT>
<h3>SET TARGETSAVE -  set type(s) of targets to save for subsequent LOCATEs </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] TARGETSAVE <I>ALL|NONE| STRING REGEXP ABSOLUTE RELATIVE POINT BLANK</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET TARGETSAVE command allows you to specify which target           types are saved for subsequent calls to the LOCATE command without any           parameters. <P></DD>
<DD> By default; SET TARGETSAVE ALL, the LOCATE command without any           parameters, locates the last target irrespective of the type of target. <P></DD>
<DD> SET TARGETSAVE NONE turns off saving of targets, but does not delete           any already saved target. <P></DD>
<DD> Any combination of the target types, STRING, REGEXP, ABSOLUTE, RELATIVE,           POINT, or BLANK can be supplied. eg. SET TARGETSAVE STRING POINT. <P></DD>
<DD> As an example, having SET TARGETTYPE STRING then the only target saved           will be one that has a string target component.           ie. if you executed LOCATE /fred/ then LOCATE :3 then LOCATE, the final           LOCATE will look for /fred/ NOT :3 <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ALL <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#LOCATE">LOCATE</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETTHIGHLIGHT"></A>
<DL><DT>
<h3>SET THIGHLIGHT -  specify if text highlighting is supported </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] THIGHlight <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET THIGHLIGHT command allows the user to specify if a the result           of a string <A HREF = "comm.html#LOCATE">LOCATE</A> command should be highlighted.  The colour that is           used to highlight the found string is set by the THIGHLIGHT option           of <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A> .           The found string is highlighted until a new line is added or deleted, a           command is issued from the command line, another <A HREF = "comm.html#LOCATE">LOCATE</A> or <A HREF = "comm.html#CLOCATE">CLOCATE</A> command is executed, a block is marked, or <A HREF = "comm.html#RESET">RESET</A>  THIGHLIGHT is executed. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON - THE/KEDIT/KEDITW OFF - XEDIT/ISPF <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#LOCATE">LOCATE</A>, <A HREF = "commset.html#SETCOLOUR">SET COLOUR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETTIMECHECK"></A>
<DL><DT>
<h3>SET TIMECHECK -  specify if time stamp checking done </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] TIMECHECK <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETTOFEOF"></A>
<DL><DT>
<h3>SET TOFEOF -  specify if TOF and BOF lines are displayed </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] TOFEOF <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET TOFEOF command allows the user to specify if the <A HREF = "glossary.html#TOP-OF-FILELINE">Top-of-File line</A> and the <A HREF = "glossary.html#BOTTOM-OF-FILELINE">Bottom-of-File line</A>  are displayed. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETTRAILING"></A>
<DL><DT>
<h3>SET TRAILING -  specify how to treat trailing blanks on lines </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] TRAILING <I>ON|OFF|REMOVE|SINGLE|EMPTY</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DD> 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. <P></DD>
<DD> 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. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible. REMOVE is an THE extension.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete.  Some trailing blank behaviour while editing files incomplete. </DD>
</DL><P>
<HR>
<A NAME="SETTRUNC"></A>
<DL><DT>
<h3>SET TRUNC -  specify the truncation column </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] TRunc <I>n|*</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET TRUNC set command determines the truncation column.  This           is the rightmost column of text upon which THE commands are           effective. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> * <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Incomplete. </DD>
</DL><P>
<HR>
<A NAME="SETTYPEAHEAD"></A>
<DL><DT>
<h3>SET TYPEAHEAD -  set behaviour of screen redraw </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] TYPEAhead <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET TYPEAHEAD set command determines whether or not THE uses the           curses screen display optimization techniques. <P></DD>
<DD> With TYPEAHEAD ON, curses will abort screen display if a keystroke           is pending. <P></DD>
<DD> With TYPEAHEAD OFF, curses will not abort screen display if a           keystroke is pending. <P></DD>
<DD> For BSD based curses, this function has no effect. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETUNDOING"></A>
<DL><DT>
<h3>SET UNDOING -  turn on or off undo facility for the current file </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] UNDOING <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET UNDOING command allows the user to turn on or off the           undo facility for the current file. <P></DD>
<DD> 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. <P></DD>
<DD> Setting UNDOING to OFF will increase the speed at which THE can           execute CHANGE and DELETE commands. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Does not support optional arguments.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> ON <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETUNTAA"></A>
<DL><DT>
<h3>SET UNTAA -  specifies if "Unsigned Numerical Targets Are Absolute" </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] UNTAA <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET UNTAA command allows the user to turn on or off the           behaviour of unsigned numerical targets. <P></DD>
<DD> 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. <P></DD>
<DD> Caution:  This SET command affects all numerical targets, not           just targets in the LOCATE command. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETVERIFY"></A>
<DL><DT>
<h3>SET VERIFY -  set column display limits </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] Verify <I>first [last]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET VERIFY command sets the column limits for the display of the           current file.  <I>first</I>  specifies the first column to be displayed           and  <I>last</I>  specifies the last column to be displayed. <P></DD>
<DD> If no  <I>last</I>  option is specified  '*'  is assumed. <P></DD>
<DD> All options can be specified as the current EQUIVCHAR to retain the           existing value. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Does not implement HEX display nor multiple column pairs.
</DD><DD>   KEDIT: Does not implement HEX display nor multiple column pairs.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> 1 * <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETZONE">SET ZONE</A>, <A HREF = "commset.html#SETEQUIVCHAR">SET EQUIVCHAR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETWIDTH"></A>
<DL><DT>
<h3>SET WIDTH -  set width of maximum line that THE can edit </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] WIDTH <I>n</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> 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. <P></DD>
<DD> The value  <I>n</I>  MUST be between 10 and 2000000000. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> 512 <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETWORD"></A>
<DL><DT>
<h3>SET WORD -  controls what THE considers a word to be </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] WORD <I>NONBlank|ALPHAnum</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET WORD set command determines what sequence of characters THE           considers a word to be. This is used in command such as <A HREF = "commsos.html#SOSDELWORD">SOS DELWORD</A> , <A HREF = "commsos.html#SOSTABWORDF">SOS TABWORDF</A> and <A HREF = "comm.html#MARK">MARK</A>  WORD to specify the boundaries of the word. <P></DD>
<DD> The default setting for SET WORD is  <I>NONBlank</I> . THE treats all           sequences of characters separated by a blank (ASCII 32) as words. <P></DD>
<DD> With  <I>ALPHAnum</I>  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. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> NONBlank <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETWORDWRAP"></A>
<DL><DT>
<h3>SET WORDWRAP -  set wordwrap feature on or off </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] WORDWrap <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET WORDWRAP set command determines whether wordwrap occurs when           the cursor moves past the right margin (as set by the <A HREF = "commset.html#SETMARGINS">SET MARGINS</A>            command). <P></DD>
<DD> 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. <P></DD>
<DD> With WORDWRAP OFF, no word wrap occurs. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETMARGINS">SET MARGINS</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETWRAP"></A>
<DL><DT>
<h3>SET WRAP -  enable/disable string locates around the end of the file </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] WRap <I>ON|OFF</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET WRAP set command determines whether THE will look for a           string target off the ends of the file. <P></DD>
<DD> 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). <P></DD>
<DD> 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. <P></DD>
<DD> If the string target is located after wrapping around the end of           the file, the message  'Wrapped...'  is displayed. <P></DD>
<DD> Commands affected by SET WRAP are; <A HREF = "comm.html#LOCATE">LOCATE</A> , <A HREF = "comm.html#FIND">FIND</A> , <A HREF = "comm.html#NFIND">NFIND</A> , <A HREF = "comm.html#FINDUP">FINDUP</A> and <A HREF = "comm.html#NFINDUP">NFINDUP</A> . <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> OFF <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "comm.html#LOCATE">LOCATE</A>, <A HREF = "comm.html#FIND">FIND</A>, <A HREF = "comm.html#NFIND">NFIND</A>, <A HREF = "comm.html#FINDUP">FINDUP</A>, <A HREF = "comm.html#NFINDUP">NFINDUP</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETXTERMINAL"></A>
<DL><DT>
<h3>SET XTERMINAL -  set X terminal to execute under X </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] XTERMinal <I>program</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET XTERMINAL set command allows the user to specify the full           quallified file name of the program to run when the <A HREF = "comm.html#OS">OS</A> , <A HREF = "comm.html#DOS">DOS</A> or <A HREF = "comm.html#EXCLAIMARK">!</A>            command is entered without parameters when running the X version           of THE. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: N/A
</DD><DD>   KEDIT: N/A
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> System dependent but usually one of: <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<A NAME="SETZONE"></A>
<DL><DT>
<h3>SET ZONE -  set column limits for editing </h3></DT>
<DT> <B>Syntax:</B> <BR></DT>
<DD> [SET] Zone <I>first [last]</I> <P></DD>
<DT> <B>Description:</B> <BR></DT>
<DD> The SET ZONE command sets the column limits for various other editor           commands, such as <A HREF = "comm.html#LOCATE">LOCATE</A> and <A HREF = "comm.html#CHANGE">CHANGE</A> . It effectively restricts           to the specified columns those parts of the file which can be           acted upon. <P></DD>
<DD> If no  <I>last</I>  option is specified  '*'  is assumed. <P></DD>
<DD> All options can be specified as the current EQUIVCHAR to retain the           existing value. <P></DD>
<DT> <B>Compatibility:</B> <BR></DT>
<DD>   XEDIT: Compatible.
</DD><DD>   KEDIT: Compatible.
<P></DD>
<DT> <B>Default:</B> <BR></DT>
<DD> 1 * <P></DD>
<DT> <B>See Also:</B> <BR></DT>
<DD>  <A HREF = "commset.html#SETVERIFY">SET VERIFY</A>, <A HREF = "commset.html#SETEQUIVCHAR">SET EQUIVCHAR</A> <P></DD>
<DT> <B>Status:</B> <BR></DT>
<DD> Complete. </DD>
</DL><P>
<HR>
<ADDRESS>
The Hessling Editor is Copyright &copy; <A HREF = "http://www.rexx.org/">Mark Hessling</A>, 1990-2010
&lt;<A HREF = "mailto:mark@rexx.org">mark@rexx.org</A>&gt;
<BR>Generated on: 7 Jul 2010
</ADDRESS><HR>
Return to <A HREF = "index.html#TOC"> Table of Contents </A><BR>
</BODY> </HTML>
the-doc 3.3~b4-1 / usr / share / doc / the / html / commset.html
