manual:chapter2:cmdline

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
manual:chapter2:cmdline [2017/10/07 05:40]
claudio [Autocompletion of commands]
manual:chapter2:cmdline [2019/11/25 13:19]
jojo1973 [Modes of operation]
Line 1: Line 1:
-===== The Command Line =====+===== The command line ===== 
 ==== Modes of operation ==== ==== Modes of operation ====
 +
 The command line editor is an area of the screen that opens up whenever the user needs to input data on the calculator.  Also, for an object already on the stack, the command line editor can be invoked using the keyboard shortcut **DN** (down keypad arrow). The command line editor is an area of the screen that opens up whenever the user needs to input data on the calculator.  Also, for an object already on the stack, the command line editor can be invoked using the keyboard shortcut **DN** (down keypad arrow).
  
 The command line has several different modes of operation, indicated by the letter of the blinking cursor. The command line has several different modes of operation, indicated by the letter of the blinking cursor.
-The editor will switch between modes of operation automatically most of the time based on context. The user can manually switch by using the ''ENTRY'' key (**RS-Alpha**). +The editor will switch between modes of operation automatically most of the time based on context. The user can manually switch by using the **ENTRY** key (**RS-AL**). 
-==='D' - Direct mode===+ 
 +=== 'D' - Direct mode === 
 When a number is first pressed, the editor opens up in direct mode. In this mode, commands and operations will close the editor, compile what was typed, and perform the operation all in a single keystroke. For example typing ''2'' and pressing **1/X** will immediately produce an answer of ''0.5''. When a number is first pressed, the editor opens up in direct mode. In this mode, commands and operations will close the editor, compile what was typed, and perform the operation all in a single keystroke. For example typing ''2'' and pressing **1/X** will immediately produce an answer of ''0.5''.
-==='A' - Algebraic mode=== 
-This mode is specifically for entering symbolic expressions. It is activated when the user types the single quotes ''%%''%%'', or it can be entered into manually using ''ENTRY''. In this mode, commands and operators will not perform their functions, but rather will insert themselves into the expression as text. For example pressing **SIN** in this mode will insert the text ''SIN()''. 
-==='P' - Programming mode=== 
-This is the default mode for programming in RPL, it is activated automatically when the user enters the program delimiters ''« »''. In this mode, functions and operators will be inserted into the editor as commands, and automatically separated with spaces. For example pressing **SIN** in this mode will insert the text ''SIN'' separated with spaces as needed. 
-==='C' or 'L' - Alphanumeric mode=== 
-This is the preferred mode for entering arbitrary text. It is activated manually using **ALPHA**, or automatically when the user inserts the double quotes ''%%""%%''. In this mode most keys will insert letters, numbers and symbols. The 'C' in the blinking cursor stands for Capitals, and will produce capital letters. On the other hand 'L' stands for Lowercase, and will insert lowercase letters. To switch between 'C' and 'L' modes, press the **ALPHA** key once. A second press of **ALPHA** without pressing any other key in between will disable alphanumeric mode, and return to the previous mode. To temporarily alternate between 'C' and 'L', press **ALPHA<sup>hold</sup>**, and the cursor will change from 'C' to 'L' or vice versa. This change is only temporary while holding **ALPHA** and pressing other keys. When releasing **ALPHA** the mode will revert back. Alphanumeric mode can also be used temporarily. When in any other mode, press **ALPHA<sup>hold</sup>** key and the cursor will change to 'C' or 'L'. Without releasing **ALPHA** you can type letters and symbols. Upon releasing **ALPHA**, the editor will return back to the previous mode of operation, ending alphanumeric mode. 
  
-----+=== 'A' Algebraic mode === 
 + 
 +This mode is specifically designed for entering symbolic expressions. It is activated when the user types the __single quotes__ ''%%' '%%'', or it can be entered into manually using **ENTRY**. In this mode, commands and operators will not perform their functions, but rather will insert themselves into the expression as text. For example pressing **SIN** in this mode will insert the text ''[[manual:chapter6:transcendentals:cmd_sin|SIN()]]''
 + 
 +=== 'P' Programming mode === 
 + 
 +This is the default mode for programming in RPL, it is activated automatically when the user enters the __program delimiters__ ''« »''. In this mode, functions and operators will be inserted into the editor as commands, and automatically separated with spaces. For example pressing **SIN** in this mode will insert the text ''[[manual:chapter6:transcendentals:cmd_sin|SIN]]'' separated with spaces as needed. 
 + 
 +=== 'C' or 'L' Alphanumeric mode === 
 + 
 +This is the preferred mode for entering arbitrary text. It is activated manually using **AL**, or automatically when the user inserts the __double quotes__ ''%%" "%%''. In this mode most keys will insert letters, numbers and symbols. The ''C'' in the blinking cursor stands for __Capitals__, and will produce capital letters. On the other hand ''L'' stands for __Lowercase__, and will insert lowercase letters. 
 + 
 +To switch between ''C'' and ''L'' modes, press the **AL** key once. A second press of **AL** without pressing any other key in between will disable alphanumeric mode, and return to the previous mode. To temporarily alternate between ''C'' and ''L'', press **AL<sup>hold</sup>**, and the cursor will change from ''C'' to ''L'' or vice versa. This change is only temporary while holding **AL** and pressing other keys. When releasing **AL** the mode will revert back. 
 + 
 +Alphanumeric mode can also be used temporarily. When in any other mode, press **AL<sup>hold</sup>** key and the cursor will change to ''C'' or ''L''. Without releasing **AL** you can type letters and symbols. Upon releasing **AL**, the editor will return back to the previous mode of operation, ending alphanumeric mode.
  
 ==== Navigation ==== ==== Navigation ====
 +
 To move the cursor through the text, use the cursor keys in the keyboard. Depending on the shifts, they will perform different operations: To move the cursor through the text, use the cursor keys in the keyboard. Depending on the shifts, they will perform different operations:
-  CursorsMove one character left, right, up or down. + 
-  * Cursor right at the end of the line: It will move to the start of the next line. +  * **LF**, **RT**, **UP**, **DN**: Moves one character left, right, up or down; 
-  * **RS-RT**: Moves to the end of the current line. +  * **RT** at the end of the line: Moves to the start of the next line; 
-  * **RS-LF**: Moves to the start of the current line. +  * **RS-RT**: Moves to the end of the current line; 
-  * **RS-UP**: Moves to the first line of text. +  * **RS-LF**: Moves to the start of the current line; 
-  * **RS-DN**: Moves to the last line of text. +  * **RS-UP**: Moves to the first line of text; 
-  * **RS<sup>hold</sup>-UP**: Moves up one page of text. +  * **RS-DN**: Moves to the last line of text; 
-  * **RS<sup>hold</sup>-DN**: Moves down one page of text. +  * **RS<sup>hold</sup>-UP**: Moves up one page of text; 
-  * **RS<sup>hold</sup>-RT**: Moves right one page.+  * **RS<sup>hold</sup>-DN**: Moves down one page of text; 
 +  * **RS<sup>hold</sup>-RT**: Moves right one page;
   * **RS<sup>hold</sup>-LF**: Moves left one page.   * **RS<sup>hold</sup>-LF**: Moves left one page.
- 
----- 
  
 ==== Autocompletion of commands ==== ==== Autocompletion of commands ====
Line 35: Line 47:
 {{ :manual:chapter2:cmd-line.png?400|}} {{ :manual:chapter2:cmd-line.png?400|}}
  
-When the user is typing text, the status area will offer suggestions to quickly type RPL commands based on the partial word immediately to the left of the cursor. For example, pressing the key **X** will insert the letter X into the editor, and immediately suggest ''XROOT'' in the status area. If the partial word typed doesn't match any RPL commands, there will be no suggestion in the status area.\\+When the user is typing text, the status area will offer suggestions to quickly type RPL commands based on the partial word immediately to the left of the cursor. For example, pressing the key **X** will insert the letter ''X'' into the editor, and immediately suggest ''[[manual:chapter6:operators:cmd_ovr_xroot|XROOT]]'' in the status area. If the partial word typed doesn't match any RPL commands, there will be no suggestion in the status area. 
 When a suggestion is being displayed, the following keys become active: When a suggestion is being displayed, the following keys become active:
-  * **Alpha<sup>hold</sup>-UP**: Shows the previous suggestion. 
-  * **Alpha<sup>hold</sup>-DN**: Shows the next suggestion. 
-  * **Alpha<sup>hold</sup>-RT**: Insert the suggestion into the editor. 
-The autocomplete feature works best when the editor is in programming mode 'P', used in combination with the temporary alphanumeric mode. For example, Press **ALPHA<sup>hold</sup>**, then press **C** to get suggested ''CMP'', then pressing **O** will suggest ''COPYCLIP'', and finally pressing **RT** will insert ''COPYCLIP'' into the editor. Now you can release **ALPHA** to return to programming mode. 
  
-----+  * **AL<sup>hold</sup>-UP**: Shows the previous suggestion; 
 +  * **AL<sup>hold</sup>-DN**: Shows the next suggestion; 
 +  * **AL<sup>hold</sup>-RT**: Inserts the suggestion into the editor. 
 + 
 +The autocomplete feature works best when the editor is in programming mode ''P'', used in combination with the temporary alphanumeric mode. For example, Press **AL<sup>hold</sup>**, then press **C** to get suggested ''[[manual:chapter6:operators:cmd_ovr_cmp|CMP]]'', then pressing **O** will suggest ''[[manual:chapter6:ui:cmd_copyclip|COPYCLIP]]'', and finally pressing **RT** will insert ''[[manual:chapter6:ui:cmd_copyclip|COPYCLIP]]'' into the editor. Now you can release **AL** to return to programming mode. 
 + 
 +==== Text selection and copy/paste operations ====
  
-====Text selection and copy/paste operations==== 
 To select text when inside the editor, use the following keys: To select text when inside the editor, use the following keys:
-  * **LS-LF**: Define the start of the selection at the cursor location. + 
-  * **LS-RT**: Define the end of the selection at the cursor location. +  * **LS-LF**: Defines the start of the selection at the cursor location; 
-  * **LS<sup>hold</sup>-LF**: Copy the selection to the clipboard. +  * **LS-RT**: Defines the end of the selection at the cursor location; 
-  * **LS<sup>hold</sup>-RT**: Paste the clipboard at the cursor location. +  * **LS<sup>hold</sup>-LF**: Copies the selection to the clipboard; 
-  * **LS<sup>hold</sup>-DN**: Cut the selection into the clipboard.+  * **LS<sup>hold</sup>-RT**: Pastes the clipboard at the cursor location; 
 +  * **LS<sup>hold</sup>-DN**: Cuts the selection into the clipboard. 
 The clipboard is also shared with the stack, so objects from the stack can be pasted into the editor and text from the editor can be pasted into the stack. The clipboard is also shared with the stack, so objects from the stack can be pasted into the editor and text from the editor can be pasted into the stack.
  
-----+==== Using the menus while in the editor ==== 
 + 
 +When the editor is open, the menu keys behave slightly different from their actions when at the stack. 
 +For complete information see [[manual:chapter2:menus#the-vars-menu|The Vars Menu]]. This section has a summary of the menu workings when in the editor. 
 + 
 +  * Most commands in the menu will insert the command name to the command line. When the editor is in algebraic mode ''A'', some commands will be inserted as a function, including opening and closing parenthesis; 
 + 
 +  * if the menu is showing variables, using **{A/L}** will insert the name of the corresponding variable in the editor; 
 +    * when using **LS-{A/L}** or **RS-{A/L}** (which normally do ''[[manual:chapter6:dirs:cmd_sto|STO]]'' and ''[[manual:chapter6:dirs:cmd_rcl|RCL]]'' respectively), the ''[[manual:chapter6:dirs:cmd_sto|STO]]'' or ''[[manual:chapter6:dirs:cmd_rcl|RCL]]'' will also be inserted; 
 +    * finally, when using **RS<sup>hold</sup>-{A/L}** the content of the corresponding variable will be inserted as text in the editor.
  
 +  * If the menu tab is displaying a directory, the menu key will change to the directory instead of inserting its name. This allows traversing directories while editing text, transparently. The **LS-UP** (''[[manual:chapter6:dirs:cmd_updir|UPDIR]]'') and **LS<sup>hold</sup>-UP** (''[[manual:chapter6:dirs:cmd_home|HOME]]'') shortcuts are also active during the editing session.
  
  • manual/chapter2/cmdline.txt
  • Last modified: 2019/12/01 13:49
  • by jojo1973