EE V1.33  2012 Works similar to the ECHO command, using
               replacement parameters special characters
               can be sent to the screen.

Invocation example:   EE Comment 1 :Info -#3E Text#; Comment 2
Screnn display: Info -> Text

The first colon starts the screen display,
#; terminates the screen display

#00 to #FF  as replacement for the hex value of a character to be output

#3E >    #7C |    #1B <ESC>    #0C FF  (Form Feed)
#3C <    #25 %    #09 <TAB>    #07 BEL (Bell)
#0D CR alone      #0A LF alone

#V  New Line (CR+LF)
#P  No new line at the line end
#Rxx (xx = 00..FF), Create errorlevel (value in hexadecimal)
#U  Warning tone 880 Hz short
#W  Warning tone 440 Hz long
#X  Bell (output via BIOS)
##  outputs # once
#;  personal comment begins here, command line is no longer interpreted

#[...] Key call
---------------------------------------------------------------
Between the brackets [] the characters A...Z, 0...9 and SPACE
can be inserted. The program waits for an entry from the key-
board. If the entered character is equal to one of the characters
inserted between the brackets, the program is continued and an
errorlevel (1...n) is generated. The position of the character
between the [] determines the value of the errorlevel produced.
A...Z means the same as a...z. If SPACE is defined between the [],
the entry of the ENTER key causes the same as the SPACE key.
Instead of 0..9, the function keys F1..F10 can also be
used (0=F10).

Example:   XE :#[d7T ]
Result:    D or d  produce errorlevel 1
           7 or F7 produce errorlevel 2
           T or t  produce errorlevel 3
           SPACE or ENTER key produce errorlevel 4
           ESC     produces errorlevel 0 (fixed setting)
A maximum of 40 characters may be inserted between the brackets.
If characters are used several times, only the first ones are valid.
Example:   XE :#[A 5 u a]
Result:    A or a  produce  errorlevel 1
           SPACE or ENTER key produce errorlevel 2
           5 or F5 produce errorlevel 3
           U or u  produce errorlevel 5
           ESC     produces errorlevel 0 (fixed setting)
           Errorlevels 4, 6 and 7 can never be produced because
                               SPACE and 'a' are used several times.
If a preselected key is pressed, the entered character is output to
the screen. Instead of ESC, SPACE or ENTER always a SPACE is output.
If this sreen output is not desired, it can be suppressed by
inserting #=Z (or #Z) at the beginning of the command line.
Example:   XE :#=ZTextText#[ABC123 ]More text
Output:    TextTextMore text  (the keyboard entry has no effect to
                               the screen output)
Special feature: If no character is inserted between [], any key
is accepted and errorlevel 0 is generated (like with ESC).

#{...} Insertion of a text string from a file
--------------------------------------------------------------------
Between the brackets of #{...} the complete path name of that file
must be inserted, from which the text string is to be taken in order
to send it to the screen. From the file, only a maximum of 128 char-
acters are considered. Possibly existing CTRL-Z or CR/LF characters
are omitted.
  
Example: EE :#{C:\TEXTS\SPECIAL\WRITE.TXT}

File names and directory names must meet the DOS specifications.
Long file names are not accepted. If the given file is not found,
nothing will be sent to the screen (neither an error message).

#={...} Insertion of the contents of a file
--------------------------------------------------------------------
Between the brackets of #={...} the complete path name of that file
must be inserted, from which the contents is to be taken in order
to send it to the screen. If the file contains TABs, these are re-
placed by a suitable number of blanks. The file may be of any length.
  
Example: EE :#={C:\TEXTS\SPECIAL\WRITE.TXT}

File names and directory names must meet the DOS specifications.
Long file names are not accepted. If the given file is not found,
nothing will be sent to the screen (neither an error message).


#=(...) or #(...) Call upon an entry of a character string
----------------------------------------------------------
Between the brackets of #=(...) or #(...) a complete path name of
a file must be entered. This function waits for a string entered via
the keyboard and terminated with <Enter>. The maximum length of the
string is 128 characters. The string is then stored in the specified
file. The last two characters in the file are CR/LF. If this file is
executable as a batch program, it can be run from a just running batch
program using the CALL command.

Program details
---------------
The EE program was completely written in assambly language.
Upper and lower case letters have the same meaning if used together
with # parameters (#3a is identical to #3A). The program may be dis-
tributed free of charge (freeware). Never distribute the program with-
out its documentation.

---------------------------------------------------------------------
EE (Extended Echo) (C) Claussen D-69181 Leimen, Germany
FREEWARE               claussen.leimen@t-online.de
                       http://www.claus-juergen-claussen.de/
---------------------------------------------------------------------
