Kurze Erklrungen zu "TOSPATCH.TTP" fr TOS 3.06            Version 1.0
1990    -soft, Markus Fritze
1992-93 Markus Heiden (Anpassung an alle(?) TOS)

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.

Haftungsausschlu:

Trotz  sorgfltiger  Arbeit  kann  fr alle Schden, die durch 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 "READROM.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 READROM.FIL angegebenen TOS-Daten mssen stimmen.

-Man  will ein "TOS.IMG" in 8 EPROMs brennen. Also TOSPATCH.TTP mit dem
 Filenamen  "SPLIT3_8.FIL" aufrufen und wenig spter hat man 8 einzelne
 TOS-Dateien  auf  dem  Datentrger.  Will man nur 4 EPROMs haben, gibt
 man als Filenamen "SPLIT3_4.FIL" an oder "SPLIT3_2.FIL" fr 2 EPROMs.

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

-Das Relozieren funktioniert nur mit TOS 3.06 vom 24.09.1991, sonst mu
 die Patch-Liste  angepasst werden. Dazu werden  alle  Langworte, deren
 Wert  im Bereich $E00000-$E7FFFF liegt, reloziert. Die Patchliste 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 Original-TOS 3.06 fr die
 Adresse  $380000  (4MB ST-RAM) zu relozieren, ist einfach TOSPATCH.TTP
 mit  dem Filenamen "RELOC306.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 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?).

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 bei mir anfragen:
   -soft
   z.Hd. Markus Fritze
   Birkhahnkamp 38
   2000 Norderstedt 1
   Tel.:040/5223955 (NIE VOR 12 UHR!!!)


Achtung:
--------
Bei  Problemen  mit  den neueren Version, d.h. TOSPATCH V2.0 und hher,
bitte nur ffentliche Mails in die D-Box Hamburg (Nummer s.u.) setzen.


Besonders gelungene Patches sind natrlich auch gesucht...

Der  Bugaboo  ist  Bestandteil des TurboAss-Assemblerpaketes. Das Paket
ist  in  diversen Mailboxen downloadbar (z.B. die Version V1.7.7 in der
D-Box   Hamburg   (040)8324543   rep  (040)8324543),  als  PD-Disk  der
ST-Computer  zu  beziehen oder aber bei obiger Adresse zu erhalten. Fr
50,-   DM  kann  man  dieses  Sharewareprogramm  dann  erwerben.  Darin
enthalten  ist  eine  ausgedruckte  Anleitung  mit  mehr als 250 Seiten
Umfang, sowie ein Updateservice.
