*****************************************************************************

Input.shell usage.
------------------

<CR> is the RETURN/ENTER key.
Call as Execute S:Input.shell<CR>...

Ensure ENV: is assigned to ENVARC:...

There is no PROMPT built into the Input.shell script.
The variable INPUTSTRING is stored inside ENVARC:INPUTSTRING for permanent
usage.

The Input.shell script is the one below but a with an extra command to clear
INPUTSTRING from a previous call before typing in the text as required:

"""
; Input.shell

; Call as Execute S:Input.shell<CR>...
; Author: B.Walker, G0LCU.

; Use Echo in your main code to create a prompt for example:-
; Echo "Enter data, Ctrl-\ to exit:- " NOLINE

; Clear INPUTSTRING...
Echo "" NOLINE > ENVARC:INPUTSTRING

; Enter string and use Ctrl-\ to exit.
Copy * TO ENVARC:INPUTSTRING
"""

*****************************************************************************

Input the typed text into the INPUTSTRING variable and use Ctrl-\ to exit
and continue.

Example code on how to use it:
"""
; Your main script calling Input.shell.
;
; Create a prompt.
Echo "Enter data, Ctrl-\ to exit:- " NOLINE
; Execute S:Input.shell and ENTER your data and press Ctrl-\ when finished.
Execute S:Input.shell
; Transfer the INPUTSTRING variable to say MYVAR variable if you need to.
Echo "$INPUTSTRING" NOLINE > ENVARC:MYVAR
;
; More code inside here using MYVAR as the variable and not touching
; INPUTSTRING again until S:Input.shell is called again..
;
; On exiting your main script:
UnSetEnv MYVAR
; Continue with other cleanup routines.
"""

*****************************************************************************
