Informationen zu SYSOK v1.1.9
=============================

Status
------

SYSOK, COOKIES und SCREEN sind Freeware, d.h. sie drfen alle drei zusammen,
in unverndertem Zustand und nur zusammen mit allen begleitenden Dateien
(insbesondere dieser, die Sie gerade lesen) kostenlos (s.u.) kopiert werden.
Einer Verbreitung im privaten Bereich und im MAUS- oder anderen
Mailbox-Netzen steht nichts entgegen.

Vom Kopierrecht ausgenommen sind Public Domain Versande, Zeitschriften,
Verlage und Softwarefirmen, sowie alle Personengruppen, Vereine, Firmen oder
hnliche Vereinigungen, die fr die Verteilung und/oder den Versand von
Software - insbesondere meiner Dateien - ein Entgeld verlangen. Den eben
genannten Einrichtungen untersage ich ausdrcklich die Verteilung sowohl
meiner oben genannten Programme als auch den begleitenden Dateien (in welcher
Form auch immer) ohne meine schriftliche Genehmigung!

Jegliche nderungen oder Patches am Programm oder den begleitenden Texten
(insbesondere dieser Textdatei, die Sie gerade lesen) sind generell untersagt
und verstoen gegen das Urheberrecht! Bei Versten behalte ich mir den
Rechtsweg vor!

Systemvoraussetzungen
---------------------

SYSOK, COOKIES und SCREEN sind TOS-Programme und knnen in Verbindung mit
CLIs (z.B. Mupfel) oder auch vom normalen Desktop aus benutzt werden. Soweit
ich das nachprfen konnte, arbeiten sie unter allen TOS-Versionen (inklusive
MultiTOS, MagiCMac und anderen kompatiblen Multitasking-Systemen mit und ohne
Speicherschutz) ab einer Auflsung von 80x24 Zeichen.

Probleme mit vektorverbiegenden Programmen (AUTO-Ordner-Programme) oder
Accessories sind sehr unwahrscheinlich, doch kann ich sie nicht vollstndig ausschlieen.

SYSOK und COOKIES bentigen die XBRA-Liste XBRALIST.TXT. Weiterhin bentigt
COOKIES die Datei COOKIES, die aber beide in der jeweils aktuellen Version
beigelegt sind.

Zweck
-----

  - SYSOK gibt wichtige Systemdaten (TOS-, DOS- und andere Versionsnummern,
  CPU-Typ, etc.) und die Inhalte bestimmter, wichtiger Zeiger aus. Dabei werden
  XBRA-Ketten verfolgt und die XBRA-ID anhand von XBRALIST.TXT entschlsselt.
  So sollte man ausreichende Informationen ber alle installierten, residenten
  Programme erhalten.

  - COOKIES gibt die Bedeutung der ihm bekannten Cookies im Cookie-Jar im
  Klartext aus. Unbekannte Cookies werden anhand der COOKIES- und XBRA-Liste
  (und zwar in dieser Reihenfolge) interpretiert.

  - SCREEN liefert Angaben ber die Bildwechselfrequenz, den Grafikmodus, die
  Auflsung und andere Grafik-Informationen.

Lieferumfang
------------

Zum Lieferumfang von SYSOK gehren folgende Dateien:

  Name         | Inhalt
  -------------+-----------------------------------------------------
  COOKIES      | Liste aller bekannten Cookie-IDs
  COOKIES.1    | Hilfe-Datei zu COOKIES.TTP fr GEMINI v1.9x
  COOKIES.5    | Hilfe-Datei zu COOKIES fr GEMINI v1.9x
  COOKIES.MAN  | Hilfe-Datei zu COOKIES.TTP fr GEMINI v1.x
  COOKIES.OPT  | Optionen-Datei zu COOKIES.TTP fr GEMINI v1.9x
  COOKIES.TTP  | TOS-Programm
  FILE_ID.DIZ  | Kurzbeschreibung der Programme fr Datelisten
  HISTORIE.TXT | alle nderungen seit der ersten Version
  LIESMICH.TXT | die Datei, die Sie gerade lesen
  SCREEN.1     | Hilfe-Datei zu SCREEN.TTP fr GEMINI v1.9x
  SCREEN.MAN   | Hilfe-Datei zu SCREEN.TTP fr GEMINI v1.x
  SCREEN.OPT   | Optionen-Datei zu SCREEN.TTP fr GEMINI v1.9x
  SCREEN.TTP   | TOS-Programm
  SYSOK.1      | Hilfe-Datei zu SYSOK.TTP fr GEMINI v1.9x
  SYSOK.MAN    | Hilfe-Datei zu SYSOK.TTP fr GEMINI v1.x
  SYSOK.OPT    | Optionen-Datei zu SYSOK.TTP fr GEMINI v1.9x
  SYSOK.TTP    | TOS-Programm
  XBRALIST.TXT | Liste aller bekannten XBRA-IDs

Sollte eine dieser Dateien fehlen, schreiben Sie mir, woher Sie SYSOK bezogen
haben. Ich werde mich bemhen, Ihnen die fehlenden Dateien zukommen zu
lassen. Legen Sie aber bitte eine formatierte Diskette und einen frankierten
und adressierten Rckumschlag bei, da ich Ihnen sonst nicht helfen kann.

Installation
------------

Das SYSOK-Archiv enthlt eine vollstndige Verzeichnisstruktur, die von
GEMINI empfohlen wird und die auch bei anderen Benutzeroberflchen benutzt
werden sollte. Sie mssen das Archiv also nur noch auspacken, alle Dateien in
das GEMINI-Verzeichnis kopieren und knnen dann sofort loslegen.

Allerdings sind ein paar Dateien sozusagen doppelt vorhanden, um alle
GEMINI-Versionen zu untersttzen. Diese stren zwar nicht den Betrieb, doch
nehmen sie unntig Platz auf dem Laufwerk weg.

Benutzen Sie also GEMINI v1.x, sollten Sie die Verzeichnisse (und ihren
Inhalt) "CAT1", "CAT5" und "OPTIONS" im Verzeichnis "MAN" lschen. Sie
bentigen nur die Dateien mit der Endung ".MAN" im Verzeichnis "MAN".

Benutzen Sie hingegen GEMINI v1.9x oder neuer, knnen Sie alle Dateien mit
der Endung ".MAN" im Verzeichnis "MAN" lschen. Diese werden Sie nicht mehr brauchen.

Probleme?
---------

Wenn Sie Probleme mit der Installation oder einem der Programme haben,
sollten Sie die Hilfe-Dateien durchlesen, die den Programmen beigelegt sind.
Nach erfolgreicher Installation kann man dies unter Unix-Shells wie der
Mupfel bequem mit "man" (also z.B.: man cookies) tun. Erst wenn Sie danach
nicht weiterkommen, zgern Sie nicht, sich an mich zu wenden.

Vermuten Sie hingegen einen Fehler in einem meiner Programme, sollten Sie
zuerst immer alle installierten Accessorys und AUTO-Ordner-Programm
deaktivieren (einfach den letzten Buchstaben in 'K' oder 'X' ndern; z.B.:
DOLL.ACC -> DOLL.ACK), den Rechner neu booten (z.B.: aus- und dann wieder
einschalten) und das jeweilige Programm erneut starten. Tritt der Fehler dann
nicht mehr auf, macht wahrscheinlich eines der (nun deaktivierten) Accessorys
oder AUTO-Ordner-Programme Probleme.

Wollen Sie herausfinden, welches Accessory oder AUTO-Ordner-Programm den
Fehler verursacht, ndern Sie nacheinander den Namen jeweils eines der
Accessorys in den ursprnglichen zurck, booten den Rechner und starten dann
wieder das eine von meinen Programmen, das zuerst Probleme machte.
Entsprechend verfahren Sie mit den AUTO-Ordner-Programmen.

Wenn dann der Fehler erneut auftritt, liegt es wahrscheinlich an dem zuletzt
umbenannten Accessory bzw. AUTO-Ordner-Programm. Ich empfehle Ihnen dann,
sich an den Autor des fehlerhaften Accessorys bzw. AUTO-Ordner-Programmes zu
wenden und eine neue verbesserte Version anzufordern.

In jedem Fall sollten Sie sich mit dem Problem auch an mich wenden und mir
den Namen des fehlerhaften Accessorys oder AUTO-Ordner-Programmes zuschicken.

Geben aber bei jedem Schreiben an mich immer mglichst viele der
nachfolgenden Daten an, damit es mir leichter fllt, Ihnen zu helfen:

  - Ihren Absender und -wenn Sie mchten- Ihre Telefonnummer fr Rckfragen
  - eine mglichst genaue Beschreibung des Fehlers (Bomben mit Anzahl,
  TOS-Fehlernummer, etc.) bzw. Ihres Problems
  - die Version von SYSOK
  - den Typ Ihres Rechners (520ST, Mega STE, Falcon030, etc.)
  - die TOS-Version (1.02, 2.06, 4.04, etc.)
  - die Speicherkapazitt (wenn mglich auch aufgeteilt in ST- und TT-RAM)
  - die Oberflche, von der Sie das jeweilige Programm gestartet haben (zum
  Beispiel Desktop, GEMINI, Mupfel, EASE, etc.)
  - alle eventuell resident installierten Programme (AUTO-Ordner-Programme)
  - alle installierten Accessorys

Wenn mglich, schicken Sie mir doch auch einen Ausdruck von SYSOK zu. Starten
Sie dazu einfach SYSOK und drcken im Hauptmen die Taste . Anschlieend
finden Sie im Klemmbrett eine Datei, die Sie ausdrucken und an mich schicken
oder mit der Tastenkombination + direkt in eine eMail oder einen anderen Text
einfgen knnen.

Ich werde mich immer behmen, Ihr Problem zu lsen.

Bemerkungen
-----------

Haben Sie eine Idee, wie eines der Programme verbessert werden kann,
verlieren Sie keine Zeit, und teilen Sie mir Ihre Einflle mit. Ich bin fr
sinnvolle Vorschlge immer zu haben. Aus diesem Grunde sind die Programme
schlielich Freeware.

Ich freue mich natrlich sehr, wenn Sie mich einfach mal loben wollen. So
sehe ich, ob meine Programme irgendjemandem gefallen. Haben Sie keine Angst,
mir Ihr Lob mitzuteilen.

Wenn Sie die Programme nicht so toll finden, interessiert mich das auch.
Haben Sie also auch keine Angst, mir Ihre (negative) Kritik mitzuteilen und
mal richtig Dampf abzulassen. Damit meine ich brigens KEINE Beleidigungen!

Sie knnen mir natrlich jederzeit auch eine (sehr) kleine oder (sehr) groe
Spende zukommen lassen (unabhngig davon, ob Ihnen die Programme gefallen
oder nicht;-). Auch wenn es sich rein uerlich um "nur" kleine Utilities
handelt, steckt eine Menge Arbeit dahinter, die Sie mit etwas finanzieller
Untersttzung belohnen knnen. Danke!

Wo bin ich?
-----------

Wenn Sie mit mir in Kontakt treten wollen, haben Sie folgende Mglichkeiten:

Briefpost:
  Oliver Kinne
  Paul-Schmidt-Strae 1
  D-12105 Berlin
  Germany

Elektronische Post:
  Oliver_Kinne@b.maus.de

  ACHTUNG! WICHTIG! Bitte beachten Sie, da an obige Adresse geschriebene
  Mails, die grer als 16kB sind, etwas kosten und Sie als Absender dafr
  aufkommen mssen! Benutzen Sie stattdessen die Briefpost oder die folgende
  eMail-Adresse, bei der ich allerdings nur unregelmig zu erreichen bin.

  oliver_kinne@tfh-berlin.de

  WorldWideWeb: http://www.tfh-berlin.de/usr1/odd/s581061/public_html/welcome.html

Bankverbindung:
  Oliver Kinne
  Kto: 535367-104
  BLZ: 100 100 10
  bei: Postbank Berlin

Wie konnte man so etwas programmieren?
--------------------------------------

SYSOK, COOKIES und SCREEN wurden mit GFA-Basic v3.5 und TurboAss entwickelt.

Last, not least, thanx to
-------------------------

Ich danke ganz herzlich folgenden Personen (in alphabetischer Reihenfolge):

  - Herrn Bauersachs (meinem ehemaligen Informatik-Lehrer:'-)
  - Thorsten Bergner (dem Beta-Tester mit dem anderen System-Utility;-)
  - Thomas Binder (fr die TOS2GEM-Dokumentation)
  - Erik Dick (fr die COOKIES-Datei; und es war doch nicht Hansi Richstein:-)
  - Thomas Dorner (fr den Trick mit os_magic)
  - Robert Federle (fr seine hardwarenahe CPU-Erkennungs-Routine)
  - Alvar Freude (fr seine TurboAss-FPU-EQUs; er wei, was ich meine;-)
  - Peter Hellinger (fr seine Liste der Rckgabewerte von vq_gdos())
  - Karsten Isakovic (dem emsigen Beta-Tester fr seine Hinweise und die von
  ihm erweiterte COOKIES-Datei)
  - Dirk Katzschke (fr seine hardwarenahe FPU-Erkennungs-Routine)
  - Julian Reschke (fr die XBRA- und Cookies-Liste und seine Hilfe durch PMs)
  - Stefan Schne (dem ebenfalls emsigen Beta-Tester und ewigen Kritiker;-)
  - Uwe Seimet (fr die Tips zu XHDI und den Aufbau des USPK-Cookies)

Auerdem gehen meine Gre an:

  - alle aus der GFA-Basic-Gruppe im MAUS-Netz, die mir bisher geholfen haben
  (und wir warten immernoch gemeinsam auf die 4.0;-)
  - die Welt auerhalb meines Schlafzimmers

Berlin, den 19.Mai 1995
