
Kurze Erklrungen zu "TOSPATCH.TTP" fr TOS 4.04           Version 2.0

1990    -soft, Markus Fritze
1992-99 Markus Heiden

TosPatch  ermglicht  das  einfache  ndern (Patchen) des Tos. Fr das
Einbinden  von  Patches  im  Tos braucht man weder einen Debugger noch
Programme  wie SPLITROM, o.. Lediglich ein Texteditor wie z.B. Tempus
ist ntig, um die Parameterdatei zu editieren.


TosPatch ist Freeware!

Das  heit, 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 Beitrge von ihren Usern fordern.)


Haftungsausschlu:

Trotz  sorgfltiger  Arbeit kann die Fehlerfreiheit von TosPatch nicht
garantiert  werden.  Somit kann fr alle Schden, die durch Verwendung
von  TosPatch  oder  eines  der  diesem  Paket  enthaltenen  Programme
entstehen  -  gleich  welcher Art und Hhe - seitens der Autoren keine
Haftung bernommen werden.


Beispiele fr 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 Datentrger befinden.
 ACHTUNG: Das  Programm  untersttzt zur Zeit alle TOS-Versionen, d.h.
          die im READROM4.FIL angegebenen TOS-Daten mssen stimmen.

-Man will ein "TOS.IMG" in 2 EPROMs brennen. Also TOSPATCH.TTP mit dem
 Filenamen "SPLIT4_2.FIL" aufrufen und wenig spter hat man 2 einzelne
 TOS-Dateien  auf  dem  Datentrger. Will man 4 EPROMs haben, gibt man
 als Filenamen "SPLIT4_4.FIL" an oder "SPLIT4_8.FIL" fr 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 ergrnden. Ich hoffe, die umfangreichen Beispiele sprechen
 fr  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 zustzliche
 Mglichkeiten, welche meist selbsterklrend 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 drfen. Die Langworte
 sind  dabei  relative  Offsets zum TOS-Anfang. Um z.B. ein "TOS.IMG",
 d.h.    das    originale    TOS 4.04    fr   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 natrlich 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  schn
 bersichtlich bleibt (wo habe ich denn was gendert?).

ACHTUNG: Die   Patchfiles,  welche  ein  ausgelesenes  TOS  bentigen,
         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 fhren kann).
2. Zudem  kann  man  seine  Patches prima ber Mailboxen anderen Usern
   zugnglich machen (wie gesagt, ohne TOS.IMG).
3. Jeder  kann  leicht  erkennen,  was  gendert wird. Dies verringert
   Probleme  bei  Unvertrglichkeiten  von Patches. Man kann ja leicht
   einen Teil entfernen (z.B. das Setzen das Fast-Load-Bits)
4. Man  kann  sich  schnell  fertige Dateien fr den Eprommer erzeugen
   lassen.
5. Man kann ein TOS im Ram testen.


Bei Problemen kann man anfragen:

Mail an Markus_Heiden@public.uni-hamburg.de


Besonders gelungene Patches sind natrlich auch gesucht...

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


!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! Bitte wendet euch bezglich TosPatch nicht mehr an               !!
!! Markus Fritze, sondern ausschlielich  an mich (Markus Heiden)!  !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

   Viel Spa wnscht
     Markus Heiden

   Hamburg, den 01.03.1999

