EE V1.33  2012 Arbeitet aehnlich wie der Befehl ECHO, mit Er-
               satzparametern koennen zusaetzlich bestimmte
               Zeichen am Bildschirm ausgegeben werden.

Eingabebeispiel:   EE Kommentar 1 :Info -#3E Ablage#; Kommentar 2
Bildschirmausgabe: Info -> Ablage

Der erste Doppelpunkt startet die Bildschirmausgabe,
#; beendet die Bildschirmausgabe

#00 bis #FF  als Ersatz fuer den Hexwert eines auszugebenden Zeichens

#3E >    #7C |    #1B <ESC>    #0C FF  (Seitenvorschub)
#3C <    #25 %    #09 <TAB>    #07 BEL (Klingelzeichen)
#0D CR allein     #0A LF allein

#V  Zeilenvorschub (CR+LF)
#P  am Zeilenende kein Zeilenvorschub
#Rxx (xx = 00..FF), Errorlevel erzeugen (Vorgabe hexadezimal)
#U  Warnton 880 Hz kurz
#W  Warnton 440 Hz lang
#X  Klingelzeichen (Ausgabe ueber BIOS)
##  einmal # ausgeben
#;  ab hier wird die Kommandozeile nicht mehr ausgewertet

#[...] Tastenaufruf
---------------------------------------------------------------
Zwischen den Klammern [] koennen die Zeichen A...Z, 0...9 und das
Leerzeichen eingetragen werden. Das Programm erwartet die Eingabe
einer Taste. Stimmt die eingegebene Taste mit einem der Zeichen 
ueberein, wird das Programm fortgesetzt und ein Errorlevel 1...n
erzeugt, wobei n die Stellung des Zeichens zwischen den Klammern
ist. A...Z ist gleichbedeutend mit a...z. Wird das Leerzeichen
vorgegeben, erzeugt beim Aufruf die Enter-Taste den gleichen
Errorlevel wie das Leerzeichen. Anstelle der Ziffern 0..9 koennen
auch die Funktionstasten F1..F10 bedient werden (0=F10). 
Beispiel:  XE :#[d7T ]
Wirkung:   D oder d erzeugen Errorlevel 1
           7 oder F7 erzeugt Errorlevel 2
           T oder t erzeugen Errorlevel 3
           Leerzeichen oder  Enter-Taste erzeugen Errorlevel 4
           ESC      erzeugt  Errorlevel 0 (fest eingestellt)
Zwischen den Klammern duerfen max. 40 Zeichen stehen. Werden Zeichen
mehrfach verwendet, wird nur das erste davon beruecksichtigt. 
Beispiel:  XE :#[A 5 u a]
Wirkung:   A oder a erzeugen Errorlevel 1
           Leerzeichen oder  Enter-Taste erzeugen Errorlevel 2
           5 oder F5 erzeugt Errorlevel 3
           U oder u erzeugen Errorlevel 5
           ESC      erzeugt  Errorlevel 0 (fest eingestellt)
           Errorlevels 4, 6 und 7 werden nicht erzeugt
                                  wegen der Mehrfachbelegung.
Wird eine vorbestimmte Taste bedient, wird das entsprechende Zeichen
auf den Bildschirm geschrieben. Fuer ESC, Leerzeichen und Enter wird
ein Leerzeichen ausgegeben. Will man aus bestimmten Gruenden diesen
Tastenprompt nicht, setzt man an den Anfang der Kommandozeilenverlaen-
gerung die Zeichenfolge #=Z oder #Z  
Beispiel:  XE :#=ZTextText#[ABC123 ]Mehr Text
Ausgabe:   TextTextMehr Text  (die Tasteneingabe hat keine Ausgabe
                               zur Folge)
Besondere Eigenschaft: Wird kein Zeichen zwischen [] angegeben,
wird jede Taste akzeptiert und Errorlevel 0 erzeugt (vgl. ESC).

#{...} Einfuegen einer Text-Zeichenfolge (Textstring) aus einer Datei
---------------------------------------------------------------------
Zwischen den Klammern bei #{...} wird der vollstaendige Name der Datei
eingetragen, aus der die Zeichenfolge entnommen und auf den Bildschirm
gebracht werden soll. Aus der Datei werden maximal die ersten 128 Zei-
chen entnommen. Eventuell in der Datei vorhandene Zeichen CR, LF oder
CTRL-Z werden ignoriert.
Beispiel: EE :#{C:\TEXTE\SPEZIAL\SCHREIB.TXT}
Der Dateiname und die Verzeichnisnamen muessen den DOS-Vereinbarungen
entsprechen. Lange Dateinamen werden nicht erkannt. Wird die angege-
bene Datei nicht gefunden, so wird nichts eingefuegt (auch keine
Fehlermeldung).

#={...} Einfuegen des Inhalts aus einer Datei
---------------------------------------------
Zwischen den Klammern bei #={...} wird der vollstaendige Name der Datei
eingetragen, aus der der Inhalt entnommen und auf den Bildschirm gebracht
werden soll. Falls TABs in der Datei enthalten sind, werden diese durch
eine passende Anzahl von Leerzeichen ersetzt. Die Datei kann beliebig
lang sein.

Beispiel: EE :#={C:\TEXTE\SPEZIAL\SCHREIB.TXT}

Der Dateiname und die Verzeichnisnamen muessen den DOS-Vereinbarungen
entsprechen. Lange Dateinamen werden nicht erkannt. Wird die angege-
bene Datei nicht gefunden, so wird nichts eingefuegt (auch keine
Fehlermeldung).

#=(...) oder #(...) Aufruf zum Eingeben einer Zeichenfolge (string)
-------------------------------------------------------------------
Zwischen den Klammern bei #=(...) oder #(...) wird der vollstaendige
Name einer Datei eingetragen. Die Funktion erwartet die Eingabe einer
Zeichenfolge (max. 128 Zeichen) ueber die Tastatur, die mit <Enter>
abgeschlossen wird. Die Zeichenfolge wird dann in der angegebenen Datei
abgespeichert. Die letzten Zeichen in der Datei sind CR/LF. Wenn diese
Datei als Batch-Datei lauffaehig ist, kann sie z.B. aus einem gerade
laufenden Batch-Programm mit CALL aufgerufen werden.

Details zum Programm
--------------------
Das Programm wurde in Assembler geschrieben. Im Zusammenhang mit dem
Ersatzparameter # haben Gross- und Kleinbuchstaben die gleiche Wir-
kung, z.B. #3A ist identisch mit #3a. Das Programm darf beliebig
weitergegeben werden, jedoch stets nur zusammen mit der Datei EE_D.TXT.

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