Function Editing - Revision history

WikiSysop: /* Editing An Anonymous Function/Operator (AFO) */

2019-03-19T14:36:26Z

Editing An Anonymous Function/Operator (AFO)

← Older revision		Revision as of 10:36, 19 March 2019
Line 59:		Line 59:
	</apll>		</apll>

	==Editing An Anonymous Function/Operator (~~AFO~~)==		==Editing An Anonymous Function/Operator/Hyperator (AFOH)==

	<p>If the function being edited is an ~~AFO~~, then '''Shift-Enter''' may be used (as above) to create additional physical but not logical lines, and '''Enter''' may be used to create additional both physical and logical lines.</p>		<p>If the function being edited is an AFOH, then '''Shift-Enter''' may be used (as above) to create additional physical but not logical lines, and '''Enter''' may be used to create additional both physical and logical lines.</p>

	<p>For example, type</p>		<p>For example, type</p>
Line 80:		Line 80:
	</apll>		</apll>

	<p>The '''Enter''' key is used to create a '''multi-physical-line''' ~~AFO~~, whereas '''Shift-Enter''' creates a '''multi-logical-line''' ~~AFO~~. The two types may appear together in a single ~~AFO~~.</p>		<p>The '''Enter''' key is used to create a '''multi-physical-line''' AFOH, whereas '''Shift-Enter''' creates a '''multi-logical-line''' AFOH. The two types may appear together in a single AFOH.</p>

	<p>Note that when editing an ~~AFO~~ in this way, the function header line may not be changed.</p>		<p>Note that when editing an AFOH in this way, the function header line may not be changed.</p>

	<p>Moreover, this method of editing an ~~AFO~~ also allows you to define additional entry points such as for an identity, prototype, or multiset function via the [[System_Labels\|System Labels]] <apll>⎕ID</apll>, <apll>⎕PRO</apll>, <apll>⎕MS</apll>, respectively. When system labels are used, they must appear at the start of a logical line.</p>		<p>Moreover, this method of editing an AFOH also allows you to define additional entry points such as for an identity, prototype, or multiset function via the [[System_Labels\|System Labels]] <apll>⎕ID</apll>, <apll>⎕PRO</apll>, <apll>⎕MS</apll>, respectively. When system labels are used, they must appear at the start of a logical line.</p>

	<p>For example, the above function <apll>h</apll> could be edited to include an identity function entry point as follows:</p>		<p>For example, the above function <apll>h</apll> could be edited to include an identity function entry point as follows:</p>

WikiSysop at 22:31, 14 January 2019

2019-01-14T22:31:18Z

← Older revision		Revision as of 18:31, 14 January 2019
Line 21:		Line 21:
	<p>For example,</p>		<p>For example,</p>

	<apll>[0]     &ensp;Z←L f R~~<br />~~		<apll>[0]     &ensp;Z←L f R
	[1]     &ensp;Z←~~<br />~~		[1]     &ensp;Z←
	<span style="color:blue;">➥</span>L ⍝ Left arg~~<br />~~		<span style="color:blue;">➥</span>L ⍝ Left arg
	<span style="color:blue;">➥</span>+ ⍝ Function~~<br />~~		<span style="color:blue;">➥</span>+ ⍝ Function
	<span style="color:blue;">➥</span>R ⍝ Right arg~~<br />~~		<span style="color:blue;">➥</span>R ⍝ Right arg
	</apll>		</apll>

	<p>Another use for Line Continuations is in function headers with a large number of local variables. The following example is taken from the <apll>ANALYZE</apll> function in the <apll>2by2</apll> workspace:</p>		<p>Another use for Line Continuations is in function headers with a large number of local variables. The following example is taken from the <apll>ANALYZE</apll> function in the <apll>2by2</apll> workspace:</p>

	<apll>[0]     &ensp;gTRACE←{bBstrNums} ANALYZE STRING;TCNL;TCNUL;LSTACK;RSTACK;CUROBJ;REDUCTIONS;OBJ;EVENT;UNK;DOP;DOPN;MOP;MOPN;IDX;F;MF;NF;A;SA;J;EOS;LP;RP;LBK;SEMI;RBK;ARBK;SRBK;LBC;RBC;SP;BSTR;SYNOBJ;RES;FFR;FR;AFR;HFR;GO;NAM;SPA;SPD;SPF;SPM;SPHY;SPNF;CS0;CS1;CSF;CSI;CSIA;CSIV;HY;MR;DR;HR;SPFR;SPMR;SPDR;SPHR;SPMN;SPDN;JD;SOS;LASTRIGHT;AFOG;AFOR;CSEF;CSFN;IO;ISPA;LNR;NNR;NR;SYNR;SYSN;VALR;NVAL;LftStkLen;RhtStkLen;⎕IO~~<br />~~		<apll>[0]     &ensp;gTRACE←{bBstrNums} ANALYZE STRING;TCNL;TCNUL;LSTACK;RSTACK;CUROBJ;REDUCTIONS;OBJ;EVENT;UNK;DOP;DOPN;MOP;MOPN;IDX;F;MF;NF;A;SA;J;EOS;LP;RP;LBK;SEMI;RBK;ARBK;SRBK;LBC;RBC;SP;BSTR;SYNOBJ;RES;FFR;FR;AFR;HFR;GO;NAM;SPA;SPD;SPF;SPM;SPHY;SPNF;CS0;CS1;CSF;CSI;CSIA;CSIV;HY;MR;DR;HR;SPFR;SPMR;SPDR;SPHR;SPMN;SPDN;JD;SOS;LASTRIGHT;AFOG;AFOR;CSEF;CSFN;IO;ISPA;LNR;NNR;NR;SYNR;SYSN;VALR;NVAL;LftStkLen;RhtStkLen;⎕IO
	[1] ...~~<br />~~		[1] ...
	</apll>		</apll>

	<p>which can be rewritten using Line Continuations as several short lines</p>		<p>which can be rewritten using Line Continuations as several short lines</p>

	<apll>[0]     &ensp;gTRACE←{bBstrNums} ANALYZE STRING;~~<br />~~		<apll>[0]     &ensp;gTRACE←{bBstrNums} ANALYZE STRING;
	<span style="color:blue;">➥</span>TCNL TCNUL LSTACK RSTACK CUROBJ REDUCTIONS~~<br />~~		<span style="color:blue;">➥</span>TCNL TCNUL LSTACK RSTACK CUROBJ REDUCTIONS
	<span style="color:blue;">➥</span>OBJ EVENT UNK DOP DOPN MOP MOPN IDX F MF NF A SA J EOS LP RP~~<br />~~		<span style="color:blue;">➥</span>OBJ EVENT UNK DOP DOPN MOP MOPN IDX F MF NF A SA J EOS LP RP
	<span style="color:blue;">➥</span>LBK SEMI RBK ARBK SRBK LBC RBC SP BSTR SYNOBJ RES FFR FR AFR~~<br />~~		<span style="color:blue;">➥</span>LBK SEMI RBK ARBK SRBK LBC RBC SP BSTR SYNOBJ RES FFR FR AFR
	<span style="color:blue;">➥</span>HFR GO NAM SPA SPD SPF SPM SPHY SPNF CS0 CS1 CSF CSI CSIA CSIV~~<br />~~		<span style="color:blue;">➥</span>HFR GO NAM SPA SPD SPF SPM SPHY SPNF CS0 CS1 CSF CSI CSIA CSIV
	<span style="color:blue;">➥</span>HY MR DR HR SPFR SPMR SPDR SPHR SPMN SPDN JD SOS LASTRIGHT AFOG~~<br />~~		<span style="color:blue;">➥</span>HY MR DR HR SPFR SPMR SPDR SPHR SPMN SPDN JD SOS LASTRIGHT AFOG
	<span style="color:blue;">➥</span>AFOR CSEF CSFN IO ISPA LNR NNR NR SYNR SYSN VALR NVAL LftStkLen RhtStkLen ⎕IO~~<br />~~		<span style="color:blue;">➥</span>AFOR CSEF CSFN IO ISPA LNR NNR NR SYNR SYSN VALR NVAL LftStkLen RhtStkLen ⎕IO
	[1] ...~~<br />~~		[1] ...
	</apll>		</apll>

	<p>which can then be further organized into groups of related local variables along with a trailing comment on each line, as opposed to the typical practice of the function header as a disorganized unordered pile onto which names are tossed.</p>		<p>which can then be further organized into groups of related local variables along with a trailing comment on each line, as opposed to the typical practice of the function header as a disorganized unordered pile onto which names are tossed.</p>

	<apll>[0]     &ensp;gTRACE←{bBstrNums} ANALYZE STRING;~~<br />~~		<apll>[0]     &ensp;gTRACE←{bBstrNums} ANALYZE STRING;
	<span style="color:blue;">➥</span>⎕IO BSTR CUROBJ EVENT LASTRIGHT OBJ REDUCTIONS RES SYNOBJ TCNL TCNUL ⍝ Local vars~~<br />~~		<span style="color:blue;">➥</span>⎕IO BSTR CUROBJ EVENT LASTRIGHT OBJ REDUCTIONS RES SYNOBJ TCNL TCNUL ⍝ Local vars
	<span style="color:blue;">➥</span>LftStkLen RhtStkLen LSTACK RSTACK                        &ensp; ⍝ Stack vars~~<br />~~		<span style="color:blue;">➥</span>LftStkLen RhtStkLen LSTACK RSTACK                        &ensp; ⍝ Stack vars
	<span style="color:blue;">➥</span>A AFOG AFOR AFR ARBK CS0 CS1 CSEF CSF CSFN CSI CSIA CSIV  ⍝ Syntax objects~~<br />~~		<span style="color:blue;">➥</span>A AFOG AFOR AFR ARBK CS0 CS1 CSEF CSF CSFN CSI CSIA CSIV  ⍝ Syntax objects
	<span style="color:blue;">➥</span>DOP DOPN DR EOS F FFR FR GO HFR HR HY IDX IO ISPA J JD    ⍝ Syntax objects~~<br />~~		<span style="color:blue;">➥</span>DOP DOPN DR EOS F FFR FR GO HFR HR HY IDX IO ISPA J JD    ⍝ Syntax objects
	<span style="color:blue;">➥</span>LBC LBK LNR LP MF MOP MOPN MR NAM NF NNR NR NVAL          ⍝ Syntax objects~~<br />~~		<span style="color:blue;">➥</span>LBC LBK LNR LP MF MOP MOPN MR NAM NF NNR NR NVAL          ⍝ Syntax objects
	<span style="color:blue;">➥</span>RBC RBK RP SA SEMI SOS SP SPA SPD SPDN SPDR SPF SPFR SPHR ⍝ Syntax objects~~<br />~~		<span style="color:blue;">➥</span>RBC RBK RP SA SEMI SOS SP SPA SPD SPDN SPDR SPF SPFR SPHR ⍝ Syntax objects
	<span style="color:blue;">➥</span>SPHY SPM SPMN SPMR SPNF SRBK SYNR SYSN UNK VALR           ⍝ Syntax objects~~<br />~~		<span style="color:blue;">➥</span>SPHY SPM SPMN SPMR SPNF SRBK SYNR SYSN UNK VALR           ⍝ Syntax objects
	[1] ...~~<br />~~		[1] ...
	</apll>		</apll>

Line 69:		Line 69:
	<p>and then edit this function via <apll>∇h</apll> or <apll>)EDIT h</apll> or double-clicking the name <apll>h</apll> to display a function editor window containing</p>		<p>and then edit this function via <apll>∇h</apll> or <apll>)EDIT h</apll> or double-clicking the name <apll>h</apll> to display a function editor window containing</p>

	<apll>[0]     &ensp;h~~<br />~~		<apll>[0]     &ensp;h
	[1]     &ensp;s←(+/⍵)÷2 ⋄ √×/s-0,⍵~~<br />~~		[1]     &ensp;s←(+/⍵)÷2 ⋄ √×/s-0,⍵
	</apll>		</apll>

	<p>This function may be edited further by deleting the diamond separator and pressing '''Enter''' at that point so as to split the line in two, resulting in</p>		<p>This function may be edited further by deleting the diamond separator and pressing '''Enter''' at that point so as to split the line in two, resulting in</p>

	<apll>[0]     &ensp;h~~<br />~~		<apll>[0]     &ensp;h
	[1]     &ensp;s←(+/⍵)÷2~~<br />~~		[1]     &ensp;s←(+/⍵)÷2
	[2]     &ensp;√×/s-0,⍵ ⍝ Heron's formula for triangle area~~<br />~~		[2]     &ensp;√×/s-0,⍵ ⍝ Heron's formula for triangle area
	</apll>		</apll>

Line 87:		Line 87:

	<p>For example, the above function <apll>h</apll> could be edited to include an identity function entry point as follows:</p>		<p>For example, the above function <apll>h</apll> could be edited to include an identity function entry point as follows:</p>
	<apll>[0]     &ensp;h~~<br />~~		<apll>[0]     &ensp;h
	[1]     &ensp;s←(+/⍵)÷2~~<br />~~		[1]     &ensp;s←(+/⍵)÷2
	[2]     &ensp;√×/s-0,⍵ ⍝ Heron's formula for triangle area~~<br />~~		[2]     &ensp;√×/s-0,⍵ ⍝ Heron's formula for triangle area
	[3]     &ensp;⎕ID:0~~<br />~~		[3]     &ensp;⎕ID:0
	</apll>		</apll>

	<p>which allows the function to be used where an identity function is required such as</p>		<p>which allows the function to be used where an identity function is required such as</p>

	<apll>      h/⍬~~<br />~~		<apll>      h/⍬
	0~~<br />~~		0
	</apll>		</apll>

WikiSysop at 20:54, 21 July 2017

2017-07-21T20:54:43Z

← Older revision		Revision as of 16:54, 21 July 2017
Line 99:		Line 99:
	</apll>		</apll>

	==Drag/Move vs. Drag/Copy==		==Drag and Move vs. Drag and Copy==

	In both the function and session editors, the mouse may '''Drag and Move''' or '''Drag and Copy''' a selection to another location. The former is equivalent to Cut and Paste, while the latter is equivalent to Copy and Paste, both in a single atomic operation. After selecting the text (which may span multiple lines), release the left mouse button. Then move the mouse back to any point within the selected text, press and hold the left mouse button and Move/Copy the text to its new location. During the Move/Copy, the text caret shows exactly the position of the insertion point~~. Release~~ the ~~left~~ mouse ~~button at~~ the ~~appropriate insertion point~~. ~~If, when~~ the left mouse button is released, the Ctrl-key ~~also~~ is pressed, ~~then~~ the operation becomes '''Drag and Copy''' which Copies the selected text (without Cutting it) ~~and Pastes it~~ at the insertion point. ~~During~~ the ~~Move~~/Copy ~~of the selected~~ text ~~the mouse cursor changes~~ to ~~indicate whether or not the Ctrl-key is pressed~~.		In both the function and session editors, the mouse may '''Drag and Move''' or '''Drag and Copy''' a selection to another location. The former is equivalent to Cut and Paste, while the latter is equivalent to Copy and Paste, both in a single atomic operation.

			After selecting the text (which may span multiple lines), release the left mouse button. Then move the mouse back to any point within the selected text, press and hold the left mouse button and Move/Copy the text to its new location. Release the left mouse button at the appropriate insertion point.

			During the Move/Copy, the '''text caret''' shows exactly the position of the insertion point, and the '''mouse cursor''' indicates whether or not the Ctrl-key is pressed. When the left mouse button is released, the state of the Ctrl-key is significant. If it is not pressed, the operation becomes '''Drag and Move''' which both Copies and Cuts the selected text; otherwise, the operation becomes '''Drag and Copy''' which Copies the selected text (without Cutting it) — in both case the selected text is Pasted at the insertion point. The Undo key (Ctrl-Z) restores all of the Cut/Copy/Pasted text to its previous state.

WikiSysop at 20:16, 21 July 2017

2017-07-21T20:16:46Z

← Older revision		Revision as of 16:16, 21 July 2017
Line 8:		Line 8:
	** Each function's undo buffer is saved with the function for reuse the next time that function is edited.		** Each function's undo buffer is saved with the function for reuse the next time that function is edited.
	** All function's undo buffers are saved with the workspace for reuse on the next load.		** All function's undo buffers are saved with the workspace for reuse on the next load.
	* In both the function and session editors, the mouse may '''Drag and Move''' or '''Drag and Copy''' a selection to another location. The former is equivalent to Cut and Paste, while the latter is equivalent to Copy and Paste, both in a single atomic operation. After selecting the text (which may span multiple lines), release the left mouse button. Then move the mouse back to any point within the selected text, press and hold the left mouse button and Move/Copy the text to its new location. During the Move/Copy, the text caret shows exactly the position of the insertion point. Release the left mouse button at the appropriate insertion point. If, when the left mouse button is released, the Ctrl-key also is pressed, then the operation becomes '''Drag and Copy''' which Copies the selected text (without Cutting it) and Pastes it at the insertion point. During the Move/Copy of the selected text the mouse cursor changes to indicate whether or not the Ctrl-key is pressed.
	* In the function header, except for the semicolon that separates the header template from the first local name, any semicolon may be replaced by one or more spaces as in <apll>[0] Z←L FOO R;⎕IO ⎕CT a b c</apll>.		* In the function header, except for the semicolon that separates the header template from the first local name, any semicolon may be replaced by one or more spaces as in <apll>[0] Z←L FOO R;⎕IO ⎕CT a b c</apll>.
	* While editing a function, several keystrokes are available:		* While editing a function, several keystrokes are available:
Line 99:		Line 98:
	0<br />		0<br />
	</apll>		</apll>

			==Drag/Move vs. Drag/Copy==

			In both the function and session editors, the mouse may '''Drag and Move''' or '''Drag and Copy''' a selection to another location. The former is equivalent to Cut and Paste, while the latter is equivalent to Copy and Paste, both in a single atomic operation. After selecting the text (which may span multiple lines), release the left mouse button. Then move the mouse back to any point within the selected text, press and hold the left mouse button and Move/Copy the text to its new location. During the Move/Copy, the text caret shows exactly the position of the insertion point. Release the left mouse button at the appropriate insertion point. If, when the left mouse button is released, the Ctrl-key also is pressed, then the operation becomes '''Drag and Copy''' which Copies the selected text (without Cutting it) and Pastes it at the insertion point. During the Move/Copy of the selected text the mouse cursor changes to indicate whether or not the Ctrl-key is pressed.

WikiSysop at 20:12, 21 July 2017

2017-07-21T20:12:00Z

← Older revision		Revision as of 16:12, 21 July 2017
Line 8:		Line 8:
	** Each function's undo buffer is saved with the function for reuse the next time that function is edited.		** Each function's undo buffer is saved with the function for reuse the next time that function is edited.
	** All function's undo buffers are saved with the workspace for reuse on the next load.		** All function's undo buffers are saved with the workspace for reuse on the next load.
	* In both the function and session editors, the mouse may '''Drag and Move''' a selection to another location ~~(a.k.a~~., ~~Cut~~ and Paste in a single atomic operation). After selecting the text (which may span multiple lines), release the left mouse button. Then move the mouse back to any point within the selected text, press and hold the left button and ~~move~~ the text to its new location. During the ~~move~~, the text caret shows exactly the position of the insertion point.		* In both the function and session editors, the mouse may '''Drag and Move''' or '''Drag and Copy''' a selection to another location. The former is equivalent to Cut and Paste, while the latter is equivalent to Copy and Paste, both in a single atomic operation. After selecting the text (which may span multiple lines), release the left mouse button. Then move the mouse back to any point within the selected text, press and hold the left mouse button and Move/Copy the text to its new location. During the Move/Copy, the text caret shows exactly the position of the insertion point. Release the left mouse button at the appropriate insertion point. If, when the left mouse button is released, the Ctrl-key also is pressed, then the operation becomes '''Drag and Copy''' which Copies the selected text (without Cutting it) and Pastes it at the insertion point. During the Move/Copy of the selected text the mouse cursor changes to indicate whether or not the Ctrl-key is pressed.
	* In the function header, except for the semicolon that separates the header template from the first local name, any semicolon may be replaced by one or more spaces as in <apll>[0] Z←L FOO R;⎕IO ⎕CT a b c</apll>.		* In the function header, except for the semicolon that separates the header template from the first local name, any semicolon may be replaced by one or more spaces as in <apll>[0] Z←L FOO R;⎕IO ⎕CT a b c</apll>.
	* While editing a function, several keystrokes are available:		* While editing a function, several keystrokes are available:

WikiSysop at 15:47, 13 April 2017

2017-04-13T15:47:22Z

WikiSysop at 23:51, 9 April 2017

2017-04-09T23:51:54Z

← Older revision		Revision as of 19:51, 9 April 2017
Line 85:		Line 85:
	<p>Note that when editing an AFO in this way, the function header line may not be changed.</p>		<p>Note that when editing an AFO in this way, the function header line may not be changed.</p>

	<p>Moreover, this method of editing an AFO also allows you to define additional entry points such as for an identity, prototype, or multiset function via the ~~'''~~System Labels~~'''~~ <apll>⎕ID</apll>, <apll>⎕PRO</apll>, <apll>⎕MS</apll>, respectively. When system labels are used, they must appear at the start of a logical line.</p>		<p>Moreover, this method of editing an AFO also allows you to define additional entry points such as for an identity, prototype, or multiset function via the [[System_Labels\|System Labels]] <apll>⎕ID</apll>, <apll>⎕PRO</apll>, <apll>⎕MS</apll>, respectively. When system labels are used, they must appear at the start of a logical line.</p>

	<p>For example, the above function <apll>h</apll> could be edited to include an identity function entry point as follows:</p>		<p>For example, the above function <apll>h</apll> could be edited to include an identity function entry point as follows:</p>

WikiSysop at 18:09, 28 March 2017

2017-03-28T18:09:19Z

WikiSysop: /* Editing An Anonymous Function/Operator (AFO) */

2017-03-25T15:38:46Z

Editing An Anonymous Function/Operator (AFO)

← Older revision		Revision as of 11:38, 25 March 2017
Line 80:		Line 80:
	</apll>		</apll>

	<p>The '''Enter''' key is used to create a '''multi-line''' AFO, whereas '''Shift-Enter''' creates a '''multi-~~statement~~''' AFO. The two types may appear together in a single AFO ~~which is both '''multi-statement''' and '''multi-line'''~~.</p>		<p>The '''Enter''' key is used to create a '''multi-physical-line''' AFO, whereas '''Shift-Enter''' creates a '''multi-logical-line''' AFO. The two types may appear together in a single AFO.</p>

	<p>Note that when editing an AFO in this way, the function header line may not be changed.</p>		<p>Note that when editing an AFO in this way, the function header line may not be changed.</p>

WikiSysop: /* Editing An Anonymous Function/Operator (AFO) */

2017-01-07T19:57:50Z

Editing An Anonymous Function/Operator (AFO)

← Older revision		Revision as of 15:57, 7 January 2017
Line 67:		Line 67:
	<apll>      h←{s←(+/⍵)÷2 ⋄ √×/s-0,⍵}</apll>		<apll>      h←{s←(+/⍵)÷2 ⋄ √×/s-0,⍵}</apll>

	<p>and then editing this function via <apll>∇h</apll> displays a function editor window containing</p>		<p>and then editing this function via <apll>∇h</apll> or <apll>)EDIT h</apll> or double-clicking the name <apll>h</apll> displays a function editor window containing</p>

	<apll>[0]     &ensp;h<br />		<apll>[0]     &ensp;h<br />

← Older revision		Revision as of 11:47, 13 April 2017
Line 8:		Line 8:
	** Each function's undo buffer is saved with the function for reuse the next time that function is edited.		** Each function's undo buffer is saved with the function for reuse the next time that function is edited.
	** All function's undo buffers are saved with the workspace for reuse on the next load.		** All function's undo buffers are saved with the workspace for reuse on the next load.
	* In both the function and session editors, the mouse may '''Drag and Move''' a selection to another location (a.k.a. Cut and Paste in a single atomic operation). After selecting the text (which may span multiple lines), release the left mouse button. Then move the mouse back to any point within the selected text, press and hold the left button and move the text to its new location. During the move, the text caret shows exactly the position of the insertion point.		* In both the function and session editors, the mouse may '''Drag and Move''' a selection to another location (a.k.a., Cut and Paste in a single atomic operation). After selecting the text (which may span multiple lines), release the left mouse button. Then move the mouse back to any point within the selected text, press and hold the left button and move the text to its new location. During the move, the text caret shows exactly the position of the insertion point.
	* In the function header, except for the semicolon that separates the header template from the first local name, any semicolon may be replaced by one or more spaces as in <apll>[0] Z←L FOO R;⎕IO ⎕CT a b c</apll>.		* In the function header, except for the semicolon that separates the header template from the first local name, any semicolon may be replaced by one or more spaces as in <apll>[0] Z←L FOO R;⎕IO ⎕CT a b c</apll>.
	* While editing a function, several keystrokes are available:		* While editing a function, several keystrokes are available:
Line 15:		Line 15:
	** To Quit without saving the function, press '''Ctrl-Q'''		** To Quit without saving the function, press '''Ctrl-Q'''
	** To create a new physical and logical line, press '''Enter'''; if the cursor is in the middle of a line, it breaks the line in two at that point		** To create a new physical and logical line, press '''Enter'''; if the cursor is in the middle of a line, it breaks the line in two at that point
	** To create a new physical but not logical line, press '''Shift-Enter'''; if the cursor is in the middle of a line, it ~~continues~~ the line onto the next physical line ~~at that point~~. The continued line is identified by a '''Line Continuation''' marker (by default, '<span style="color:blue;"><apll>➥</apll></span>' — U+27A5) at the start of the line.		** To create a new physical but not logical line, press '''Shift-Enter'''; if the cursor is in the middle of a line, it breaks the line at that point onto the next physical line. The continued line is identified by a '''Line Continuation''' marker (by default, '<span style="color:blue;"><apll>➥</apll></span>' — U+27A5) at the start of the line.
	** Multiple adjacent continued lines form a '''block''' which is treated as a single logical line.		** Multiple adjacent continued lines form a '''block''' which is treated as a single logical line.
	** The default '''Line Continuation''' marker may be changed by going to "Edit \| Customize..." then selecting "User Preferences" and then "Line Continuation".		** The default '''Line Continuation''' marker may be changed by going to "Edit \| Customize..." then selecting "User Preferences" and then "Line Continuation".
Line 47:		Line 47:
	</apll>		</apll>

	<p>which can then be further organized into groups of related local variables along with a trailing comment on each line, as opposed to the typical practice of the function header as a disorganized unordered pile ~~into~~ which names are tossed.</p>		<p>which can then be further organized into groups of related local variables along with a trailing comment on each line, as opposed to the typical practice of the function header as a disorganized unordered pile onto which names are tossed.</p>

	<apll>[0]     &ensp;gTRACE←{bBstrNums} ANALYZE STRING;<br />		<apll>[0]     &ensp;gTRACE←{bBstrNums} ANALYZE STRING;<br />

← Older revision		Revision as of 14:09, 28 March 2017
Line 6:		Line 6:
	** double-right-click on a function name in the session manager or function editor windows. The button to double-click may be changed from the menu "Edit \| Customize..." then selecting "User Preferences" and then "Reverse double-click"		** double-right-click on a function name in the session manager or function editor windows. The button to double-click may be changed from the menu "Edit \| Customize..." then selecting "User Preferences" and then "Reverse double-click"
	* The function editor supports a multilevel Undo. That is, pressing '''Ctrl-Z''' reverts back to the previous text.		* The function editor supports a multilevel Undo. That is, pressing '''Ctrl-Z''' reverts back to the previous text.
	* Each function's undo buffer is saved with the function for reuse the next time that function is edited.		** Each function's undo buffer is saved with the function for reuse the next time that function is edited.
	* All function's undo buffers are saved with the workspace for reuse on the next load.		** All function's undo buffers are saved with the workspace for reuse on the next load.
	* In the function header, except for the semicolon that separates the header template from the first local name, any semicolon may be replaced by one or more spaces.		* In both the function and session editors, the mouse may '''Drag and Move''' a selection to another location (a.k.a. Cut and Paste in a single atomic operation). After selecting the text (which may span multiple lines), release the left mouse button. Then move the mouse back to any point within the selected text, press and hold the left button and move the text to its new location. During the move, the text caret shows exactly the position of the insertion point.
			* In the function header, except for the semicolon that separates the header template from the first local name, any semicolon may be replaced by one or more spaces as in <apll>[0] Z←L FOO R;⎕IO ⎕CT a b c</apll>.
	* While editing a function, several keystrokes are available:		* While editing a function, several keystrokes are available:
	** To Save a function, press '''Ctrl-S'''		** To Save a function, press '''Ctrl-S'''
Line 14:		Line 15:
	** To Quit without saving the function, press '''Ctrl-Q'''		** To Quit without saving the function, press '''Ctrl-Q'''
	** To create a new physical and logical line, press '''Enter'''; if the cursor is in the middle of a line, it breaks the line in two at that point		** To create a new physical and logical line, press '''Enter'''; if the cursor is in the middle of a line, it breaks the line in two at that point
	** To create a new physical but not logical line, press '''Shift-Enter'''; if the cursor is in the middle of a line, it continues the line onto the next physical line at that point. The continued line is identified by a '''Line Continuation''' marker (by default, '<span style="color:blue;">➥</span>' — U+27A5) at the start of the line.		** To create a new physical but not logical line, press '''Shift-Enter'''; if the cursor is in the middle of a line, it continues the line onto the next physical line at that point. The continued line is identified by a '''Line Continuation''' marker (by default, '<span style="color:blue;"><apll>➥</apll></span>' — U+27A5) at the start of the line.
	** Multiple adjacent continued lines form a '''block''' which is treated as a single logical line.		** Multiple adjacent continued lines form a '''block''' which is treated as a single logical line.
	** The default '''Line Continuation''' marker may be changed by going to "Edit \| Customize..." then selecting "User Preferences" and then "Line Continuation".		** The default '''Line Continuation''' marker may be changed by going to "Edit \| Customize..." then selecting "User Preferences" and then "Line Continuation".
Line 63:		Line 64:
	<p>If the function being edited is an AFO, then '''Shift-Enter''' may be used (as above) to create additional physical but not logical lines, and '''Enter''' may be used to create additional both physical and logical lines.</p>		<p>If the function being edited is an AFO, then '''Shift-Enter''' may be used (as above) to create additional physical but not logical lines, and '''Enter''' may be used to create additional both physical and logical lines.</p>

	<p>For example,</p>		<p>For example, type</p>

	<apll>      h←{s←(+/⍵)÷2 ⋄ √×/s-0,⍵}</apll>		<apll>      h←{s←(+/⍵)÷2 ⋄ √×/s-0,⍵}</apll>

	<p>and then ~~editing~~ this function via <apll>∇h</apll> or <apll>)EDIT h</apll> or double-clicking the name <apll>h</apll> ~~displays~~ a function editor window containing</p>		<p>and then edit this function via <apll>∇h</apll> or <apll>)EDIT h</apll> or double-clicking the name <apll>h</apll> to display a function editor window containing</p>

	<apll>[0]     &ensp;h<br />		<apll>[0]     &ensp;h<br />