SIREDIT parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
 
(5 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Template:SIREDIT parameter subtitle}}
==Summary==
==Summary==
<dl>
<dl>
Line 14: Line 15:


==Description==
==Description==
This is a bitmask parameter that controls various enhancements to the <var class="product">Model 204</var> fullscreen
This is a bitmask parameter that controls various enhancements to the [[Model 204 full-screen editor]]. The meaning of the bits are:
editor. The meaning of the bits are:
<table class="thJustBold">
<dl>
<tr><th>X'01'</th>
<dt>X'01'
<td>Switch to <var>[[*LOWER command|*LOWER]]</var> mode upon entry to the editor, and revert to prior setting
<dd>Switch to <var>*LOWER</var> mode upon entry to the editor, and revert to prior setting
upon exit. This allows command mode to work in <var>[[*UPPER command|*UPPER]]</var> mode so that
upon exit. This allows command mode to work in <var>*UPPER</var> mode so that
commands are automatically uppercased, while allowing the editor to work in mixed-case mode.
commands are automatically uppercased, while allowing the editor to work in mixed-case mode.
 
<p>
Since most <var class="product">Model 204</var> commands take entirely uppercase input, <var>*UPPER</var> mode
Since most <var class="product">Model 204</var> commands take entirely uppercase input, <var>*UPPER</var> mode
is almost always preferable in command mode. On the other hand, most
is almost always preferable in command mode. On the other hand, most
modern <var class="product">User Language</var> programs use mixed case, so <var>*LOWER</var> mode is
modern <var class="product">SOUL</var> programs use mixed case, so <var>*LOWER</var> mode is preferable inside the editor. The <var>SIREDIT</var> X'01' bit provides the best of both worlds with no effort. </p>
preferable inside the editor. The <var>SIREDIT</var> X'01' bit allows one to get the best of
<p>
both worlds with no effort.
This bit has no effect if the user is already in <var>*LOWER</var> mode on entry to the editor. </p></td></tr>


This bit has no effect if the user is already in <var>*LOWER</var> mode on entry to the editor.
<tr><th>X'02'</th>
<dt>X'02'
<td> Change the <var>[[LINEND parameter|LINEND]]</var> character for the current procedure to carriage return (X'0D'). This allows procedures to include semicolons as data, and it also makes it easier to edit a procedure that has been uploaded from an HTML generator.</td></tr>
<dd> Change the <var>LINEND</var> character for the current procedure to carriage return
 
(X'0D'). This allows procedures to include semicolons as data, and it also
<tr><th>X'04'</th>
makes it easier to edit a procedure that has been uploaded from an HTML
<td>Always force the current <var>[[MODEL_parameter|3270 Mod 2]]</var> behavior (24 lines by eighty characters), even if the editor is invoked by a thread using a Mod 5 session. This bit takes precedence over the following bit.</td></tr>
generator.
 
<dt>X'04'  
<tr><th>X'08'</th>
<dd>Always force the current 3270 Mod 2 behavior (24 lines by eighty characters),
<td>Allow Mod 5 sessions in [[DBCS_feature|DBCS]] environments. Ordinarily the widescreen (Mod 5) support is disabled under DBCS environments. When this bit is set, even DBCS sessions are eligible for widescreen support.</td></tr>
even if the editor is invoked by a thread using a Mod 5 session. This bit takes
 
precedence over the following bit.
<tr><th>X'10'</th>
<dt>X'08'  
<td>Provide case-insensitive locate in non-DBCS environments. Thus, the editor command will locate both of the following lines, regardless of the setting of <var>*LOWER/*UPPER</var> or the <var>SIREDIT</var> X'01' bit:
<dd>Allow Mod 5 sessions in DBCS environments. Ordinarily the widescreen (Mod
5) support is disabled under DBCS environments. When this bit is set, even
DBCS sessions are eligible for widescreen support.
<dt>X'10'  
<dd>Provide case-insensitive locate in non-DBCS environments. Thus, the editor
command will locate both of the following lines, regardless of the setting of <var>*LOWER/*UPPER</var> or the <var>SIREDIT</var> X'01' bit:


<p class="code">This is sometimes hard to find due to mixed
<p class="code">This is sometimes hard to find due to mixed
case, while “this is” is all lower case.</p>
case, while &#x201C;this is&#x201D; is all lowercase.</p></td></tr>


<dt>X'20'  
<tr><th>X'20'</th>
<dd>Provide case-insensitive search strings for the replace command, while still retaining the case as entered on the replacement string, assuming that either <var>*LOWER</var> is in effect or the X'01' bit of <var>SIREDIT</var> is set. Under these conditions, and using the text from the previous example, the command:
<td>Provide case-insensitive search strings for the editor <var>Replace</var> command, while still retaining the case as entered on the replacement string, assuming that either <var>*LOWER</var> is in effect or the X'01' bit of <var>SIREDIT</var> is set.  
<p>
Under these conditions, and using the text from the X'10' example above, this command changes occurrences on both lines: </p>
<p class="code">r/this is/This Is/* all</p>
<p class="code">r/this is/This Is/* all</p>
<p>
The result is: </p>
<p class="code">This Is sometimes hard to find due to mixed
case, while &#x201C;This Is&#x201D; is all lowercase. </p></td></tr>


will change occurrences on both lines, resulting in:
<tr><th>X'40'</th>
<p class="code">This Is sometimes hard to find due to mixed
<td>Allow matching of single-quote (<tt>'</tt>) to double-quote (<tt>"</tt>) and vice versa. This is useful when looking at procedures that contain code where both single and double quotes can be used to enclose string literals. This includes SOUL, Javascript, XSLT, and anything else that uses XML.
case, while “This Is” is all lowercase. </p>
<p>
</dl>
Note that this feature does not affect <var>Replace</var> commands, and it does not care whether the quotes are actually being used to enclosed string literals. For example, the string <code>That"s odd</code> would match <code>That's odd</code> if the <var>SIREDIT</var> X'40' bit is set. </p>
<p>
The arbitrary quote matching feature was first made available in <var class="product">Sirius Mods</var> 8.1 and Model&nbsp;204 version 7.5. </p></td></tr>
</table>


==See also==
==See also==
<ul>
<ul>
<li>In addition to the <var>SIREDIT</var> parameter, the <var class="product">Sirius Mods</var> provide some additional [[:Category:Editor_commands|fullscreen editor commands]].
<li>[[:Category:Editor commands|Editor commands]]
<li>[[SoulEdit]] </li>
</ul>
</ul>
[[Category:User parameters]]
[[Category:User parameters]]
[[Category:Parameters]]
[[Category:Parameters]]

Latest revision as of 15:37, 31 May 2017

Sirius EDIT flags

Summary

Default value
0
Parameter type
User
Where set
User resettable
Related products
All
Introduced
Before Sirius Mods 6.7

Description

This is a bitmask parameter that controls various enhancements to the Model 204 full-screen editor. The meaning of the bits are:

X'01' Switch to *LOWER mode upon entry to the editor, and revert to prior setting

upon exit. This allows command mode to work in *UPPER mode so that commands are automatically uppercased, while allowing the editor to work in mixed-case mode.

Since most Model 204 commands take entirely uppercase input, *UPPER mode is almost always preferable in command mode. On the other hand, most modern SOUL programs use mixed case, so *LOWER mode is preferable inside the editor. The SIREDIT X'01' bit provides the best of both worlds with no effort.

This bit has no effect if the user is already in *LOWER mode on entry to the editor.

X'02' Change the LINEND character for the current procedure to carriage return (X'0D'). This allows procedures to include semicolons as data, and it also makes it easier to edit a procedure that has been uploaded from an HTML generator.
X'04' Always force the current 3270 Mod 2 behavior (24 lines by eighty characters), even if the editor is invoked by a thread using a Mod 5 session. This bit takes precedence over the following bit.
X'08' Allow Mod 5 sessions in DBCS environments. Ordinarily the widescreen (Mod 5) support is disabled under DBCS environments. When this bit is set, even DBCS sessions are eligible for widescreen support.
X'10' Provide case-insensitive locate in non-DBCS environments. Thus, the editor command will locate both of the following lines, regardless of the setting of *LOWER/*UPPER or the SIREDIT X'01' bit:

This is sometimes hard to find due to mixed case, while “this is” is all lowercase.

X'20' Provide case-insensitive search strings for the editor Replace command, while still retaining the case as entered on the replacement string, assuming that either *LOWER is in effect or the X'01' bit of SIREDIT is set.

Under these conditions, and using the text from the X'10' example above, this command changes occurrences on both lines:

r/this is/This Is/* all

The result is:

This Is sometimes hard to find due to mixed case, while “This Is” is all lowercase.

X'40' Allow matching of single-quote (') to double-quote (") and vice versa. This is useful when looking at procedures that contain code where both single and double quotes can be used to enclose string literals. This includes SOUL, Javascript, XSLT, and anything else that uses XML.

Note that this feature does not affect Replace commands, and it does not care whether the quotes are actually being used to enclosed string literals. For example, the string That"s odd would match That's odd if the SIREDIT X'40' bit is set.

The arbitrary quote matching feature was first made available in Sirius Mods 8.1 and Model 204 version 7.5.

See also

Retrieved from "https://m204wiki.rocketsoftware.com/index.php?title=SIREDIT_parameter&oldid=103205"