VolksForth/doc/atari-st/CHANGES.ORG

Änderungen im volksForth Atari ST

• Version 3.80 gegenüber 3.7 ff
  • FORTH_83.SCR
  • FILEINT.SCR
  • PRINTER.SCR
  • ASSEMBLE.SCR
  • DOUBLE.SCR
  • FILESAVE.SCR
  • FORTHKER.PRG
  • STARTUP.SCR
  • DIVERSES.SCR
  • TOOLS.SCR
  • STRINGS.SCR
  • LINE_A.SCR
  • DEMO.SCR
  • TASKER.SCR
  • Subdirectory GEM
    • BASICS.SCR
    • AES.SCR
    • VDI.SCR
    • SUPERGEM.SCR
    • GEMDEFS.SCR
    • EDITOR.SCR
    • EDWINDOW.SCR
• Änderungen ab Version 3.80
  • FORTH_83.SCR
  • GEM\BASICS.SCR
  • GEM\AES.SCR
  • GEM\GEMDEFS.SCR
  • GEM§UPERGEM.SCR
  • PRINTER.SCR

Version 3.80 gegenüber 3.7 ff

Wir haben versucht, in diesem Dokument alle Änderungen seit Version 3.7 zu erfassen. Dies ist für alle interessant, die bereits fertige Programme haben und diese nun anpassen möchten. Drei Hauptänderungen müssen dabei berücksichtigt werden: Das Fileinterface, die Änderungen im GEM und die Relokabilität des Systems.

Nicht verschweigen wollen wir, daß wir eine Fülle kleiner Fehler und Unschönheiten korrigiert haben, nicht zuletzt aufgrund von Rückmeldungen der volksFORTH-83 Benutzer!

FORTH_83.SCR

• Das System ist relokatibel. Betroffen sind alle Assemblerworte, die mit dem Register D7 gearbeitet haben. Das Wort MEMPAGE gibt es nicht mehr. Stattdessen gibt es das neue Wort FORTHSTART , das eine Langadresse liefert, die den Anfang des Systems kennzeichnet. Dort befinden sich die Informationen, die GEM-Dos zum Aufbau der Basepage braucht.
• UP ist eine Variable geworden (bisher Register A3).
• Im Kernel enthalten sind jetzt die Worte, die unter DOUBLE zusammengefaßt waren, also 2@, 2!, 2VARIABLE, 2CONSTANT, 2OVER, 2SWAP und D-.
• Ebenfalls im Kernel sind die Langoperationen, die auf den gesamten Ram-Speicher arbeiten können als da sind: LC@, LC!, L@, L!, LCMOVE (fehlerfrei), L2@, L2! und LN+! .
• UM/MOD erzeugt die Fehlermeldung "division overflow".
• Der Fehler in -ROLL wurde behoben.
• drvinit ist mit : drvinit noop ; definiert. Damit ist es möglich, dort Routinen zu patchen, die nach dem Booten des Systems ausgeführt werden sollen. Davon macht z.B. der Editor Gebrauch.
• Es gibt ein (LOAD, dem Screennummer und Position im Block übergeben werden.
• Im Direktzugriff werden nur die Laufwerke A und B unterstützt, allerdings sowohl einseitige als auch doppelseitige Laufwerke. Umschaltung erfolgt beim Lesen oder Schreiben automatisch. Dazu dienen die Worte GETBLOCKS und MEDIACH?.
• Neu ist das deferred word MAKEVIEW, das in CREATE das Viewfield erzeugt.
• >name ist erheblich schneller, weil nfa? jetzt in Code definiert ist.
• Die Uservariable FILE ist in ISFILE umbenannt worden. Ebenso ist das Wort FILE@ durch ISFILE@ ersetzt. Zusätzlich gibt es die Variable FROMFILE. CONVEY z.B. kopiert Screens von FROMFILE nach ISFILE.
• Das deferred word (DISKERR ist nicht mehr vorhanden. Stattdessen wird bei allen Diskoperationen ein ABORT" im Fehlerfalle ausgeführt.
• Die Worte BACKUP und EMPTYBUF sind sichtbar.
• Im FORGET-Bereich ist das Wort REMOVE sichtbar. Neu ist das deferred word CUSTOM-REMOVE.
• Die 68000 Errortraps führen auf ein ABORT" und räumen den Systemstack richtig auf.
• Das System arbeitet nach wie vor im Supervisormodus. Bisher wurde der SSP beim Verlassen des Systems nicht wieder restauriert. Das ist jetzt der Fall und damit hoffentlich das mysteriöse Verhalten einiger Programme (z.B. 1st_Word) im Anschluß an FORTH behoben.
• Das System enthält voreingestellt nur noch &10 Diskbuffer.

FILEINT.SCR

• Das gabs in Version 3.7 noch gar nicht. Hier sind deswegen die Änderungen seit Version 3.71 aufgeführt.
• Das File FILESAVE.SCR gibt es nicht mehr. SAVESYSTEM ist jetzt am Anfang des Fileinterface definiert.
• In GETDRIVE wurde der Systemstack nicht korrekt gerichtet. Das führte bisweilen zum Absturz.
• CAPACITY enthält ein OPEN.
• Analog zu A: und B: gibt es jetzt auch die Worte C: und D:.
• In (VIEW wird überprüft, ob das File überhaupt vorhanden ist, bevor ISFILE geändert wird.
• ?DISKABORT läuft auf ein ABORT" ; es werden nicht mehr alle, sondern nur die wichtigsten Fehlermeldungen im Klartext ausgegeben, für den Rest gibt es die Fehlernummer.
• PATHES wurde auf 30 Zeichen verkürzt.
• WORKSPACE ist jetzt sichtbar.
• Im System selbst ist eine 'Disk Transfer Area' (DTA) enthalten. Diese wird anstelle der des Systems benutzt. Vielleicht verschwinden damit rätselhafte Fehler beim Umschalten von Laufwerken mit DIR (?!?!)
• OPEN, CLOSE, MAKE und USE testen, ob der Wert in ISFILE ein FCB ist.
• Die Worte KILLFILE, KILLDIR und EMPTYFILE sind gestrichen.
• (MORE ist neu; wird von MORE aufgerufen, ist aber schneller, weil nicht jedemal ein CLOSE ausgeführt wird.
• (MAKEVIEW ist jetzt headerlos.
• CONVEY überprüft, ob die Blöcke überhaupt existieren.
• FILES zeigt die Subdirectories nicht mehr mit "" an, sondern mit einem "D", damit mans auch drucken kann. Die Filelänge wird in der gewählten Zahlenbasis und nicht mehr zwangsweise in decimal ausgegeben.

PRINTER.SCR

• Die Epson-Anpassung wurde verbessert, sodaß sie nun auch auf Epson-Druckern selbst läuft. Die Kompatiblen können nämlich meistens mehr als das Original. Zusätzlich wurde eine Umlaut-Wandlung eingebaut.
• Der Code zum Ausdrucken formatierter Listings wurde verbessert. Zusätzlich wurde das Wort PRINTALL aufgenommen, das ein komplettes File ohne Shadows druckt.
• Das Wort SPOOL wurde durch SPOOL' ersetzt. SPOOL' erlaubt die Angabe eines Druckkommandos wie LISTING oder PTHRU und ist damit flexibler.

ASSEMBLE.SCR

• Dieses File gehört nicht mehr zum Arbeitssystem, sondern kann wahlweise zugeladen werden. Mit 2 LOADFROM ASSEMBLE.SCR wird der Assembler auf den HEAP geladen.
• Aufgrund der Relokation wurden einige neue Makros eingeführt, ebenso hat sich die Belegung der Register geändert (Näheres im File ASSEMBLE.DOC)

DOUBLE.SCR

• gibt es nicht mehr. Die entsprechenden Worte befinden sich im Kernelsystem.

FILESAVE.SCR

• gibt es nicht mehr. Die entsprechenden Worte befinden sich im File FILEINT.SCR.

FORTHKER.PRG

• enthält jetzt bereits das Fileinterface.
• Das System ist auf DECIMAL voreingestellt.

STARTUP.SCR

• enthält nur noch die INCLUDE-Anweisungen, um aus FORTHKER.PRG ein Arbeitssystem zusammenzustellen.

DIVERSES.SCR

• ist neu und enthält häufig benutzte Worte, die wir nirgendwo unterbringen konnten.
• Das Wort .BLK enthält die Sequenz BASE PUSH HEX nicht mehr.

TOOLS.SCR

• Im Decompiler ist L (für Literal) durch K (für Konstante) ersetzt worden. Das vermeidet Namenskonflikte beim Aufruf des Editors.
• NPUSH im Tracer ist durch CPUSH ersetzt worden. Dieses Wort befindet sich jetzt in DIVERSES.SCR, da es auch im Editor benutzt wird.

STRINGS.SCR

• Neu ist das Wort 0", das einen counted und 0-terminated String im Dicitonary ablegt. 0" ist statesmart, kann also sowhl im Interpreter- als auch im Compilermodus benutzt werden.
• TEXT funktioniert jetzt tatsächlich so, wie es dokumentiert ist.

LINE_A.SCR

• Insgesamt wurde dieses File 'entrümpelt' und stellt jetzt nur noch die Grundfunktionen zur Verfügung. Andere sind z.B. nach DEMO.SCR ausgelagert. Im Einzelnen sind folgende Worte betroffen: Variable BKGRND OVERWRITE TRANSPARENT INVTRANS EXORWRITE RSET RDRAW HOME PATTERN PATTERNS ARROW
• A_SETUP ist sichtbar und damit auch für neue Definitionen zu gebrauchen.
• Die Variablen sind auf "_" statt "." umgestellt worden, also XMIN_CLIP statt XMIN.CLIP, Y_MAX statt Y.MAX usw. Dies gilt auch für die Funktionen SHOW_MOUSE HIDE_MOUSE PUT_PIXEL GET_PIXEL und FORM_MOUSE.
• +SPRITE und -SPRITE funktionieren jetzt, können sich aber mit normalen Hardwaresprites nicht messen.
• Die Copyraster-Funktionen sind gestrichen. Die entsprechenden VDI-Funktionen sind ebenso schnell, daher muß diese aufwendige Definition nicht wiederholt werden (File VDI.SCR im Ordner GEM, Screen $10 ff).

DEMO.SCR

• Die Demos wurden z.T. umgeschrieben und sind jetzt noch viel hübscher !! (Dank an GFA-Basic)

TASKER.SCR

• Die Uhr als Demonstration des Multitasking war nicht sehr gelungen und ist daher gestrichen.
• Beim FORGET einer Task wird jetzt tatsächlich der gesamte Speicherbereich freigegeben.
• Die Syntax des Spoolers wurde geändert (s.PRINTER.SCR)

Subdirectory GEM

BASICS.SCR

• Die Arrays INTIN, INTOUT usw. wurden drastisch verkürzt.
• Die Pointernamen im GLOBAL-Array wurden gestrichen (Platzverschwendung)
• Neue Worte sind C_WIDTH C_HEIGHT B_WIDTH und B_HEIGHT. Sie bezeichnen Positionen im Array SIZES.
• Das Wort AES hat einen Stackparameter, nämlich #addrout, weniger. Dieser wird automatisch gesetzt. Alle AES-Aufrufe haben damit einen Parameter weniger.
• Die Variable OBJC_TREE wird universeller verwendet und ist daher schon hier statt wie bisher in AES.SCR definiert.
• Der Fehler in S_CLIP wurde korrigiert.

AES.SCR

• An vielen Stellen wird der Inhalt von OBJC_TREE implizit übergeben. Das vereinfacht die Parameterübergabe. Betroffen sind die Worte MENU_BAR MENU_ICHECK MENU_IENABLE MENU_TNORMAL MENU_TNEXT FORM_DO FORM_CENTER
• Bei FSEL_INPUT sind die Stringarrays sichtbar geworden, sodaß man sie auch benutzen kann !! Sie heißen jetzt INPATH und INSEL.
• Die Screennummern im Loadscreen haben sich geändert (aufpassen, wenn LOADFROM AES.SCR verwendet wird.)

VDI.SCR

• mem>scr und scr>mem sind jetzt Defining-Words, mit denen sich Worte konstruieren lassen, die das tun, was die beiden vorher gemacht haben; dabei läßt sich aber ein MFDB (Memory Form Definition Block) mitgeben. Damit ist es jetzt möglich, mit mehreren MFDBs zu arbeiten. Syntax ist an den Beispielen in VDI.SCR zu sehen. Im Editor werden zwei MFDBs benutzt.
• Die Screennummern im Loadscreen haben sich geändert (aufpassen, wenn LOADFROM VDI.SCR verwendet wird.)

SUPERGEM.SCR

• Neues File, das einige sinnvolle Befehle enthält, die die Arbeit mit GEM erleichtern.

GEMDEFS.SCR

• Neues File, enthält GEM-Definitionen in der Art von 'C'-#defines, um Quelltexte lesbarer zu machen.

EDITOR.SCR

• Neu !!! Enthält den GEM-Editor (hätten Sie's erraten?) und ist vollständig mit Kommentarscreens versehen. Soll unter anderem zeigen, wie man unter FORTH GEM programmieren kann.

EDWINDOW.SCR

• Ebenfalls komplett geändert. Enthält die Routinen für das GEM-Window des Editors. Auch dieses File kann als Beispiel für eigene Programme benutzt werden.

Änderungen ab Version 3.80

18.11.86

Natürlich gibt es auch in Version 3.80 noch kleinere Änderungen. Sie sind bisher jedoch nicht so gravierend, daß sie eine neue Versionsnummer nötig machen.

FORTH_83.SCR

• Die Worte OUT, WRAP, MEDIACH? und GETBLOCKS sind nicht mehr sichtbar.
• Aus Geschwindigkeitsgründen sind die Worte *, M*, M/MOD, /MOD, /, MOD und MINIMAX, also die wichtigsten Arithmetik-Routinen in Maschinencode geschrieben.

GEM\BASICS.SCR

• enthält jetzt die Worte SHOW_C und HIDE_C, die bisher in VDI.SCR bzw. SUPERGEM.SCR definiert waren.
• Das Wort SETARRAYS ist jetzt sichtbar.
• Das Global-Array wurde um zwei Worte verlängert (wer weiß, warum ?!)

GEM\AES.SCR

• Der Message-Buffer bei EVNT_MESAG wurde auf 16 Bytes verkürzt.
• Bei MENU_REGISTER ist der Rückgabewert 0 kein Fehler; das Wort wurde entsprechend korrigiert.

GEM\GEMDEFS.SCR

• Dieses File enthält keine Labels mehr, sondern spezielle Konstanten. Diese werden komplett auf den Heap geladen. Die Wirkung ist dieselbe wie vorher, aber es ist kein Vocabulary mehr nötig.

GEM§UPERGEM.SCR

• GETNUMBER wurde so geändert, daß jetzt auch führende Leerzeichen überlesen werden. Diese führten bislang zur Fehlermeldung '?'.

PRINTER.SCR

• In PTHRU ist jetzt ein ARGUMENTS enthalten. Damit werden versehentliche falsche Eingaben weitgehend neutralisiert.
• Das Wort >PRINTER, das den Ausgabevektor für den Drucker beinhaltet ist sichtbar geworden.