LIESMICH zum OMIKRON. TT-Paket 4.08                    Stand: 22.04.92

**************************************************************************
* WICHTIG beim Umstieg auf die Version 4.08:                             *
* Im Ranhmen der nderungen zur Version 4.08 wurden auch einige Aufruf-  *
* Konventionen der BASLIB_4 gendert. Es ist deshalb mglich, da ltere *
* Kompilate mit der neuen BASLIB nicht laufen. Sie sollten deshalb im    *
* Zweifelsfall ltere Programme nocheinmal mit Version 4.08 kompilieren. *
**************************************************************************

Diese Datei bercksichtigt alle Besonderheiten der Version 4.xx 
(TT-Paket) gegenber den Versionen 3.5 von Interpreter und Compiler.

Insbesondere finden Sie hier alle nderungen die die FPU-Option des TT-
Pakets betreffen.

Alle die Versionen 4.xx und 3.5 gemeinsam betreffenden nderungen und 
Verbessungen lesen Sie bitte in den Dateien ...
       LIESMICH.I - fr den Interpreter
  bzw. LIESMICH.C - fr den Compiler 
                                        nach.

Die TOS-Programme "HELP.TOS", "DEMO.TOS" (im Ordner "DEMO") und "CUTLIB.TOS" 
(im Ordner "CUTLIB") sind selbst entpackende Archive. Starten Sie 
diese Programme bitte erst nachdem Sie sie auf eine leere 
Diskette oder Ihre Festplatte kopiert haben.

Spezielle Hinweise bei Verwendung eines ATARI TT:
=================================================

Wie Sie vielleicht wissen gibt es in einem ATARI TT Computer zwei 
verschiedene Arten von Hauptspeicher: das ST-kompatible und das 
schnelle 32-Bit breite RAM (kurz ST-RAM und TT-RAM).
Das TT-RAM unterscheidet sich im wesentlichen dadurch vom ST-RAM, 
da dort keine DMA-Zugriffe, die im alten Timing des ATARI ST 
ablaufen, mglich sind (z.B. Bildschirm, Floppy-, Sound oder HD-
DMA). Dafr kann die CPU jedoch wesentlich schneller auf diesen 
Speicher zugreifen.

WICHTIG bei der Verwendung von OMIKRON.BASIC 4.0 / TT-PAKET:

***************************************************************************
* Compilate, die auf ATARI TT laufen und den eingebauten Coprozessor      *
* nutzen, verwenden die BASLIB_4. Es gibt keine FPULIB_4 !! Die BASLIB_4  *
* beinhaltet alle Funktionen, die Programme mit/ohne FPU Untersttzung    *
* bentigen.                                                              *
***************************************************************************

- der Interpreter luft momentan nur im ST-RAM (dies stellt 
praktisch keinerlei Einschrnkung dar).

- der Compiler und alle Compilate laufen sowohl im ST- als auch 
im TT-RAM (die entsprechenden Flags im Programmheader knnen also 
gesetzt werden).

- spezielle Hardware des ATARI TT kann uneingeschrnkt genutzt 
werden. Bei selbstverwalteter Verwendung von TT-RAM bleibt es der 
Verantwortung des Programmierers berlassen, dieses richtig 
einzusetzen (kein DMA ...).

- alle neuen Betriebssystemsfunktionen stehen zur Verfgung 
(siehe Beispielprogramme im Verzeichnis ATARI_TT)

- da die beiden RAM-Bereiche (ST-RAM und TT-RAM) normalerweise 
nicht durchgehend adressierbar sind, verwendet das dynamische 
Speichermodell des OMIKRON.BASIC immer nur einen der beiden 
Blcke. Beispiel: ihr ATARI TT sei mit 4 MB TT-RAM und 4 MB ST-
RAM bestckt. Jetzt ist "FRE(0)"  3 MB (ST-RAM) und 
"MEMORY(-1)"  4 MB (TT-RAM). Da der Speicher aber normalerweise 
nicht am Stck zur Verfgung steht, wrde der Aufruf 
"CLEAR 6000000" zum Fehler fhren. (Siehe Beispielprogramme im 
Verzeichnis ATARI_TT)

------------------------------------------------------------------------
Neue Features (ab Version 4.08):

- der Interpreter untersttzt nun auch die Coprozessor-FPU des ATARI TT. 
Dieses, eigentlich von Beginn an versprochene, Feature war zwischen-
zeitlich durch ein Versehen verloren gegangen und ist erst jetzt wieder 
in vollem Umfang verfgbar.
Folgende Funktionen werden bisher untersttzt:
SIN, COS, TAN, ARCSIN, ARCCOS, ARCTAN, SINH, COSH, TANH, EXP, LN, 
ARTANH, SQR und alle Funktionen, die auf den genannten Funktionen 
aufbauen (z.B. LOG oder ^).
Die Benutzung der FPU ist abhngig vom FPU-Cookie. Beim ATARI TT wird 
der Cookie vom Betriebssystem automatisch richtig gesetzt. Wenn eine 
Prozessorkarte verwendet wird, so ist jeder selbst fr die korrekte 
Initialiesierung des Cookie-Jar verantwortlich.

- einige neue DEMO-PROGRAMME:
 -  GEMFRAME.BAS: ein vollstndiges Programmskelett zur GEM-
    Programmierung.
 -  PLOT.BAS: eine Prozedur zum Zeichnen von Funktionsgraphen.
 -  SPEED.BAS: Benchmark-Programm mit Fliekommaberechnungen
 -  APFEL.BAS: ein ganz, ganz einfaches Fliekomma-Apfelmnnchen.
    (es soll keine Geschwindigkeitsrekorde brechen, es arbeitet ohne 
    Tricks und Kniffe. Nur ein simpler Algorithmus mit Fliekomma-
    Arithmetik).
 -  MATRIX.BAS: etwas Matrizen-Arithmetik.

- der Compiler bentigt nur noch zwei Durchlufe (frher drei). Dadurch 
hat sich die bersetzungszeit fast halbiert.

- bessere Optimierung bei Vergleichen mit komplexen Ausdrcken

- neues Steuerwort "68020" (schon lnger implementiert, aber noch nicht 
dokumentiert). Erzeugt optimierten Code fr Prozessoren 68020 und hher. 
Es werden einige spezielle Adressierungen und einige neue Opcodes 
verwendet, die Programme auf den genannten Prozessoren geringfgig 
schneller machen. Auf anderen Prozessoren laufen, die Compilate dann 
allerdings nicht mehr.

Beseitigte Compiler-Fehler (ab Version 4.08):

- (nur FPU-Option) die Fliekommakonstante 1000, die direkt dem ON-CHIP-ROM 
der FPU entnommen wurde, wurde leider mit der Konstante 10000 vertauscht.

- (nur FPU-Option) die Matrizeninversion funktionierte nicht, wenn 
Quell- und Zielmatrix identisch waren.

- (nur FPU-Option) die Matrixdivision war fehlerhaft (Folgefehler von 
s.o.)

- (nur FPU-Option) Zugriffe auf Flag-Array ( %F Felder ) fhrten zu 
Problemen.

- (nur FPU-Option) Stringzuweisungen konnten unter bestimmten Umstnden 
ganz daneben gehen.

- (nur FPU-Option) RND( N ) ergab Zufallszahl zwischen 0 und N-2 anstatt 
zwischen 0 und N-1.

- (nur FPU-Option) Compiler Konstanten mit Wortlnge ( %W ) konnten 
nicht an FLOAT zugewiesen werden.

- (nur FPU-Option) FOR-NEXT Schleifen mit variablem STEP erzeugten 
falsche Opcodes.

- (nur FPU-Option) MKD$ und MKS$ waren fehlerhaft.

- (nur FPU-Option) USING funktionierte im Gegensatz zu PRINT USING 
nicht.


LIESMICH zum OMIKRON. TT-Paket 4.07                    Stand: 03.02.92

Neue Features (ab Version 4.07):

- wieder ein neues Steuerwort zum direkten Setzen der Headerflags in 
Programmdateien: "FLAGS XXXX". "XXXX" steht fr die hexadezimale Schreib-
weise des reservierten Langworts, welches so in den Programmheader einge-
tragen wird. Sie knnen somit alle Einstellungen, wie FASTLOAD, 
TT-RAM benutzen oder TPA-Gre bereits im Quelltext einstellen. 
Die genaue Aufschlsselung des Langworts entnehmen Sie bitte dem Beispiel-
programm Flags im Ordner "DEMO\ATARI_TT\"

Beseitigte Fehler (ab Version 4.07):

- (nur FPU-Option) die ABS-Funktion fr Integer war fehlerhaft

- (nur FPU-Option) die Vorzeichenumkehr bei Variablen in 
Ausdrcken konnte unter Umstnden falsch ausgefhrt werden.

- (nur FPU-Option) der MOD Operator war fehlerhaft

Neue Features (ab Version 4.06):

- durch ein neues Steuerwort knnen nun auch Compilate fr die 
Bibliotheken der Version 3.5 erzeugt werden. Das Steuerwort lautet. "LIB35"
(siehe Beispielprogramm im Ordner "CUTLIB")

Beseitigte Fehler (ab Version 4.06):

- (nur FPU-Option) die Potenz-Funktion war noch nicht ganz fehlerfrei

- (nur FPU-Option) MIN() und MAX() dto.

- (nur FPU-Option) DIM mit Stringfeldern ging manchmal schief

- (nur FPU-Option) Probleme bei Modify-Operatoren sind beseitigt

- (nur FPU-Option) String-Vergleiche wurden auf Grund einer 
Typverwechslung leider meist falsch ausgewertet (oder Absturz)

- (nur FPU-Option) String-Addition dto.

- (nur FPU-Option) bei automatischer Typkonvertierung FLAOT -> INT 
konnten vereinzelt Fehler auftreten

- Interpreter: die Befehle DUMP und LDUMP fhrten zum Absturz

LIESMICH zum OMIKRON. TT-Paket 4.05                   Stand: 03.12.91

Beseitigte Fehler (speziell in Version 4.xx):

- (nur FPU-Option) die Input-Funktionen, welche Fliekomma-Werte von der 
Tastatur bzw. von der Datei lesen, funktionieren jetzt korrekt.

- (nur FPU-Option) die VAL-Funktion berliest SPACE (CHR$(32)) und TAB 
(CHR$(9)).

- (nur FPU-Option) Die Formelauswertung berechnet nun auch komplexe 
Ausdrcke problemlos (keine Fehlermelung)

- (nur FPU-Option) Zwischenzeitlich eingeschlichener Fehler bei der 
DIMensionierung von FLOAT-Felder beseitigt.

