Differences

This shows you the differences between two versions of the page.

--- manual:chapter6:stack:cmd_stkpick [2019/10/09 09:44]
claudio
+++ manual:chapter6:stack:cmd_stkpick [2019/10/22 15:24] (current)
jojo1973 Fixed internal link
@@ Line 1: / Line 1: @@
 ==== STKPICK ====
 ----
-<callout type="primary" color="" icon="fa fa-comment" title="Description">
+<callout type="primary" color="" icon="fa fa-book" title="Synopsis">
 ----
-Copy an object from a snapshot in a given level of the "stack of stacks" onto the current stack. Similar to ''PICK'' but selecting which snapshot to pick from.
+Pick an object from a snapshot in a given level of the Undo stack
 </callout>
-<callout color="crimson" icon="fa fa-indent" title="Stack Diagram">
+<callout color="green" icon="fa fa-indent" title="Stack Diagram">
 ----
-^  __Input Stack__  ^  ^  __Output Stack__  ^
+^  __Input Stack__  ^^  ^  __Output Stack__  ^
 |  **I<sub>snapshot</sub>**  |  **I<sub>level</sub>**  |  **→**  |  **O**  |
-|  //Level 2//  |  //Level 1//  |  **→**  |  //Level 1//  |
+|  //Level 2//  |  //Level 1//  |  //→//  |  //Level 1//  |
 {{page>manual:chapter6:aux:legend&nofooter&noeditbtn&inline}}
-| {{fa>times?lg&color=red}} **Support for inclusion in symbolic expressions**  |
+|**Type**| [[manual:chapter5:basics#commands|Command]]  ||
-| {{fa>times?lg&color=red}} **Support for parallel list processing**  |
+|**Parallel list processing**| [[manual:chapter5:listproc#group-1commands-that-cannot-parallel-process|Group 1]]  ||
-| {{fa>times?lg&color=red}} **Affected by flags**  |
+|**Affected by flags**| None  ||
 </callout>
-<callout type="warning" icon="fa fa-thumbs-down" title="Compatibility">
+<callout color="orangered" icon="fa fa-comment" title="Description">
 ----
-This command is new in newRPL, does not exist in userRPL.
+The ''STKPICK'' command retrieves an object at a given level from a given snapshot on the Undo stack.
+The command has little utility in interactive mode, since each time a command is typed and ''[[manual:chapter6:operators:cmd_ovr_xeq|XEQ]]''ted a snapshot of the stack is pushed on the Undo stack, altering the position of the intended snapshot.
+</callout>
+<callout type="danger" icon="true" title="Compatibility">
+----
+This command is new in newRPL and does not exist in userRPL.
 </callout>
 <callout type="info" icon="true" title="Usage">
 ----
-The following program:
+The following program
 <code>
 « 10 11 12 13
   STKPUSH
   CLEAR
- 3 STKPICK
+  "ABC"
+  STKPUSH
+  CLEAR
+ 3 STKPICK
 »
 </code>
-the code will ''PICK'' the third element (Level 1 argument) from snapshot on level 1 (Level 2 argument) of the "stack of stacks", resulting in the number 11 being left on the current stack.
+will ''[[manual:chapter6:stack:cmd_pick|PICK]]'' the third element (level 1 argument) from snapshot on level 2 (Level 2 argument) of the Undo stack, resulting in the number ''11'' being left on the current stack.
 </callout>
-<callout color="darkslategray" icon="fa fa-hand-o-right" title="Related Commands">
+<callout color="darkgray" icon="fa fa-hand-o-right" title="Related Commands">
+----
 {{page>manual:chapter6:stack&nofooter&noeditbtn&inline}}
 </callout>