README4.TXT

Kurze Erklärungen zu "TOSPATCH.TTP" für TOS 4.04           Version 2.0

©1990    Σ-soft, Markus Fritze
©1992-99 Markus Heiden

TosPatch  ermöglicht  das  einfache  Ändern (Patchen) des Tos. Für das
Einbinden  von  Patches  im  Tos braucht man weder einen Debugger noch
Programme  wie SPLITROM, o.ä. Lediglich ein Texteditor wie z.B. Tempus
ist nötig, um die Parameterdatei zu editieren.


TosPatch ist Freeware!

Das  heißt, daß das komplette TosPatch-Paket kostenfrei kopiert und in
nicht kommerzielle Mailboxen upgeloadet werden darf. Auch ein Vertrieb
auf  PD-Disketten ist erlaubt, wenn der Diskettenpreis ein Maximum von
DM  10.-   nicht  übersteigt.  Soll  TosPatch  als  Beilage  zu  einem
kommerziellen Produkt  vertrieben  werden,  so ist sich vorher mit mir
- Markus Heiden -  in Verbindung zu setzen. (Unter nicht kommerziellen
Mailboxen  verstehe ich  Boxen,  die  max.  die  zur Kostendeckung des
Mailboxbetriebs notwendigen Beiträge von ihren Usern fordern.)


Haftungsausschluß:

Trotz  sorgfältiger  Arbeit kann die Fehlerfreiheit von TosPatch nicht
garantiert  werden.  Somit kann für alle Schäden, die durch Verwendung
von  TosPatch  oder  eines  der  diesem  Paket  enthaltenen  Programme
entstehen  -  gleich  welcher Art und Höhe - seitens der Autoren keine
Haftung übernommen werden.


Beispiele für die Anwendung von TosPatch:

-Man  will  ein  TOS  aus  dem  Rechner  auslesen  und  in  eine Datei
 schreiben.   Dazu   ruft   man   TOSPATCH.TTP   mit   dem   Filenamen
 "READROM4.FIL"  auf.  Wenn  das  Programm fertig ist, sollte sich die
 Datei "TOS.IMG" auf dem Datenträger befinden.
 ACHTUNG: Das  Programm  unterstützt zur Zeit alle TOS-Versionen, d.h.
          die im READROM4.FIL angegebenen TOS-Daten müssen stimmen.

-Man will ein "TOS.IMG" in 2 EPROMs brennen. Also TOSPATCH.TTP mit dem
 Filenamen "SPLIT4_2.FIL" aufrufen und wenig später hat man 2 einzelne
 TOS-Dateien  auf  dem  Datenträger. Will man 4 EPROMs haben, gibt man
 als Filenamen "SPLIT4_4.FIL" an oder "SPLIT4_8.FIL" für 8 EPROMs.
 Will  man  ein  TOS  gleichzeitig  patchen,  kann man statt dessen im
 Patchfile    die    Zeile   ">[Anzahl der TOS-Files] [Reloc-Adresse]"
 entsprechend anpassen.

-Man  will einige Bytes im nicht gepatchen "TOS.IMG" ändern. Dazu lade
 man  die Datei "404_REL.FIL" in einen Text-Editor seiner Wahl, um das
 Format  zu ergründen. Ich hoffe, die umfangreichen Beispiele sprechen
 für  sich.  Wie  man  sieht,  kann  man wahlweise einige Bytes direkt
 ändern,  oder  aber  sogar  ganze  Dateien  includen.  Die Hexzahl am
 Zeilenanfang   entspricht   dabei  dem  Offset  zum  Dateianfang  von
 "TOS.IMG".  Das  "$"  kennzeichnet den Beginn einiger Hexbytes, sonst
 wird  ein  Filename angenommen. Zudem gibt es noch einige zusätzliche
 Möglichkeiten, welche meist selbsterklärend sein sollten. Eine genaue
 Beschreibung ist im File "BEFEHLE.TXT" zu finden.

-Das   Relozieren   funktioniert   nur  mit  dem  originalen  TOS 4.04
 vom   08.03.1993,   sonst   muß  die  Reloc-Liste  angepasst  werden.
 Dazu  werden  alle  Langworte,  deren Wert im Bereich $E00000-$E7FFFF
 liegt,  reloziert.  Die  Reloc-Liste gibt die Ausnahmen der Regel an,
 d.h.  die Langworte, die nicht reloziert werden dürfen. Die Langworte
 sind  dabei  relative  Offsets zum TOS-Anfang. Um z.B. ein "TOS.IMG",
 d.h.    das    originale    TOS 4.04    für   die   Adresse   $380000
 (z.B.  Mega  ST  4)  zu  relozieren, ist einfach TOSPATCH.TTP mit dem
 Filenamen  "RELOC404.FIL"  aufzurufen.  Um die Adresse zu ändern, muß
 man  die  Datei  mit  einem  Text-Editor  (wie  gehabt)  ändern.  Das
 relozierte  TOS  kann man dann mit LOADTOS.PRG starten. Ein so im Ram
 liegendes  TOS  kann man natürlich prima mit einem Debugger (z.B. dem
 Bugaboo  aus  dem TurboAss-Paket) bearbeiten (bis zum Absturz...) und
 neue  Patches  ausprobieren.  Wenn alles funktioniert, sollte man die
 Patches   allerdings   in   ASCII-Form  bringen,  damit  alles  schön
 übersichtlich bleibt (wo habe ich denn was geändert?).

ACHTUNG: Die   Patchfiles,  welche  ein  ausgelesenes  TOS  benötigen,
         erwarten dieses als TT_TOS.IMG in dem Verzeichnis, in welchem
         auch    TOSPATCH.TTP   steht.   Die   Ausnahme   bilden   die
         "SPLITRO?.FIL".  Sie erwarten ein TOS.IMG jedoch ebenfalls im
         Verzeichnis, in welchem TOSPATCH.TTP steht.


Welche Vorteile bringt denn nun TosPatch?

1. Man ist nicht mehr gezwungen das TOS.IMG als ganzes weiter zu geben
   (was ja auch zu rechtlichen Problemen führen kann).
2. Zudem  kann  man  seine  Patches prima über Mailboxen anderen Usern
   zugänglich machen (wie gesagt, ohne TOS.IMG).
3. Jeder  kann  leicht  erkennen,  was  geändert wird. Dies verringert
   Probleme  bei  Unverträglichkeiten  von Patches. Man kann ja leicht
   einen Teil entfernen (z.B. das Setzen das Fast-Load-Bits)
4. Man  kann  sich  schnell  fertige Dateien für den Eprommer erzeugen
   lassen.
5. Man kann ein TOS im Ram testen.


Bei Problemen kann man anfragen:

Mail an markus@markusheiden.de


Besonders gelungene Patches sind natürlich auch gesucht...

Also: Alle  Modifikationen  an  den  Sourcen und neue Patches BITTE an
      mich  senden.  Auch  Kritik  und  Verbesserungsvorschläge, sowie
      Bugreports, sind stets gefragt.


!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! Bitte wendet euch bezüglich TosPatch nicht mehr an               !!
!! Markus Fritze, sondern ausschließlich  an mich (Markus Heiden)!  !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

   Viel Spaß wünscht
     Markus Heiden

   Hamburg, den 01.03.1999