README2.TXT

Kurze Erklärungen zu "TOSPATCH.TTP" für TOS 2.06            Version 2.4

©1990    Σ-soft, Markus Fritze
©1992-93 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.


Haftungsausschluß:

Trotz  sorgfältiger  Arbeit  kann  für alle Schäden, die durch 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 "READROM2.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 READROM.FIL angegebenen TOS-Daten müssen stimmen.

-Man  will ein "TOS.IMG" in 8 EPROMs brennen. Also TOSPATCH.TTP mit dem
 Filenamen  "SPLIT2_8.FIL" aufrufen und wenig später hat man 8 einzelne
 TOS-Dateien  auf  dem  Datenträger.  Will man nur 4 EPROMs haben, gibt
 man als Filenamen "SPLIT2_4.FIL" an oder "SPLIT2_2.FIL" für 2 EPROMs.

-Man  will  einige Bytes im nicht gepatchen "TOS.IMG" ändern. Dazu lade
 man  die  Datei  "PATCH.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 alle selbsterklärend sein sollten.

-Das Relozieren funktioniert nur mit TOS 2.06 vom 14.11.1991, sonst muß
 die Patch-Liste  angepasst werden. Dazu werden  alle  Langworte, deren
 Wert  im Bereich $E00000-$E3FFFF liegt, reloziert. Die Patchliste 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 Original-TOS 2.06 für die
 Adresse  $3C0000  (Mega 4) zu relozieren, ist einfach TOSPATCH.TTP mit
 dem  Filenamen "RELOC206.FIL" aufzurufen. Um  die  Adresse  zu  ändern
 muß  man   die  Datei  mit  einem  Text-Editor  (wie gehabt)   ändern.
 Das so im Ram liegende 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 STE_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...


TurboAss erhält man bei:

   Σ-soft
   z.Hd. Markus Fritze
   Birkhahnkamp 38
   2000 Norderstedt 1
   Tel.:040/5223955 (NIE VOR 12 UHR!!!)

TosPatch  ist  Bestandteil des TurboAss-Assemblerpaketes. Das Paket ist
in  diversen  Mailboxen  downloadbar  (z.B.  die Version  V1.7.7 in der
Sigma-Soft  (040) 526 71 85  rep.  (040) 526 71 85),  als  PD-Disk  der
ST-Computer  zu  beziehen oder aber bei obiger Adresse zu erhalten. Für
50,-   DM  kann  man  dieses  Sharewareprogramm  dann  erwerben.  Darin
enthalten  ist  eine  ausgedruckte  Anleitung  mit  mehr als 250 Seiten
Umfang, sowie ein Updateservice.