@DATABASE XOpa.guide

@NODE main
@TITLE XOpa-Dokumentation

@{b}XOpa 1.03-Dokumentation                                         @{ub}

Diese Dokumentation enthält die folgenden Kapitel:

    I. @{"Einführung" LINK einführung}
   II. @{"Installation" LINK Install}
  III. @{"Kurzübersicht" LINK kurz}
   IV. @{"Menüs" LINK Menus}
    V. @{"Anzeigeleiste" LINK Anzeige}
   VI. @{"Funktionsleiste" LINK Funks}
  VII. @{"Requester" LINK Requester}
 VIII. @{"ToolTypes" LINK ToolTypes}
   IX. @{"Strukturmodus" LINK Struktur}
    X. @{"Über das Programm" LINK Über}

Die Dokumentation für XOpa bezieht sich auf die Version 1.03
vom 3. Oktober 1994.
Letzte Änderung der Dokumentation am 4.10.94. ©1994 bei Axel Dörfler.
@ENDNODE


@NODE Einführung
@TITLE "XOpa-Dokumentation:  Einführung"

@{b}I. Einführung zu XOpa@{ub}

XOpa ist so etwas wie ein Systemmonitor. Es stellt die
internen Informationen des Amigas nach außen in einer
verständlichen Form dar.
Darüberhinaus bietet es auch Funktionen, die diese Daten
verändern können.
So sind zu fast allen Anzeigemodi Funktionen anwählbar,
mit denen man umfangreiche Veränderungen durchführen
kann.

Allerdings kann man mit diesen Veränderungen, daß System
durcheinanderbringen, wenn man z.B. noch benötigte Objekte
entfernt. Es ist daher sinnvoll alle wichtigen Daten vor
der Benutzung des Programmes abzuspeichern, und nicht wild
das System zu manipulieren.

Das Programm ist sehr nützlich, wenn zum Beispiel beim
Programmieren Fehler dazu führen, daß sich ein Programm
nicht mehr beenden läßt oder es beim Beenden Screens
und/oder Fenster offen läßt.

Das Programm benötigt zum Laufen mindestens Kickstart/
Workbench 2.0, unterstützt aber bei höheren OS-Versionen
viele neue Funktionen (weiße Menüs, ASL-ScreenMode-
Requester, Standardwartezeiger, ...).
Das Programm arbeitet mit den voreingestellten Systemzeichen-
sätzen problemlos zusammen, d. h., es ist "font-sensitiv".

Das Programm vereinigt hierbei fast alle üblichen Funktionen
von anderen Programmen dieser Art.
Durch die benutzerfreundliche und StyleGuide-konforme Oberfläche
und vor allem dem Strukturmodus, dem wohl umfangreichsten Pro-
grammteil, hat es den Konkurrenten allerdings etwas voraus.

Mit dem Strukturmodus kann man selbst die internen Systemstrukturen 
durchforsten, wobei sich die verfügbaren Strukturen durch die externe 
Strukturdefinitionsdatei, die im gleichen Verzeichnis wie XOpa sein
sollte, beliebig erweitern lassen.

Da die Strukturnamen und Begriffe des Systems natürlich in englischer
Sprache definiert sind (wie z.B. Screens), aber doch wohl den meisten
Anwendern bekannt sind, habe ich diese, um die erfahrenen Anwender
nicht zu verwirren, beibehalten.
Bei den Erklärungen der einzelnen @{"Anzeigemodi" LINK Anzeige}, steht aber im
Regelfall neben der deutschen Übersetzung der Begriffe auch, was
diese bedeutet.

Der im Text häufiger genannte Begriff "Objekt" ist normaler-
weise ein Eintrag aus der Liste, also ein Screen (Bildschirm),
Task (Programm) etc.

Weiterhin sollte sich dieses Guide im gleichen Verzeichnis wie XOpa
befinden, damit die Hilfefunktionen von XOpa funktionieren.
@ENDNODE


@NODE Install
@TITLE "XOpa-Dokumentation:  Installation"

@{b}II. Installation von XOpa@{ub}

Die Installation von XOpa auf Festplatte oder Diskette ist sehr
einfach zu handhaben, auch wenn hier der Commodore-Installer
nicht zum Einsatz kommt.
Wenn in den @{"ToolTypes" LINK ToolTypes} nicht anders angegeben, werden die
folgenden Dateien im gleichen Verzeichnis benötigt:

  · XOpa
  · XOpa.guide
  · XOpa.structs

Sie müssen also nur dafür sorgen, daß sich diese drei Dateien
im gleichen Verzeichnis befinden.
Wenn sich die Datei "XOpa.structs" nicht im gleichen Verzeichnis
befindet wie das Hauptprogramm und in den @{"ToolTypes" LINK ToolTypes} keine andere
Datei ausgewählt wurde ist der @{"Strukturmodus" LINK Struktur} nur eingeschränkt
benutzbar, da dann nur die internen 10 Strukturdefinitionen zur Ver-
fügung stehen.
Wenn die Datei "XOpa.guide" fehlt, sind die Hilfefunktionen von
XOpa nicht funktionstüchtig.
Ebenso benötigt wird die "amigaguide.library" im Verzeichnis "LIBS:"
oder im Kickstart-ROM um die Hilfefunktionen zu benutzen.
Die Library wird allerdings erst ab OS3.0 serienmäßig mitgeliefert,
eine Version für alle Betriebssystemversionen ist allerdings optional
auf Public-Domain-Serien erhältlich.
@ENDNODE


@NODE Kurz
@TITLE "XOpa-Dokumentation:  Kurzübersicht"

@{b}III. Kurzübersicht@{ub}
_______________________________________________________________________________________
 1.Menüs:

    @{"Projekt" LINK Menus 12}         @{"Optionen" LINK Menus 35}                    @{"Struktur" LINK Menus 67}           @{"Hilfe" LINK Menus 86}
     @{"Iconifizieren" LINK Menus 14}   @{"Speicher aufräumen       " LINK Menus 37}   @{"Andere Struktur " LINK Menus 69}   @{"Allgemein       " LINK Menus 89}
     @{"Über...      " LINK Menus 24}   @{"Aktuelle Anzeige drucken " LINK Menus 43}   @{"Node-Strukturen " LINK Menus 74}   @{"Kurzübersicht   " LINK Menus 89}
     @{"Ende         " LINK Menus 29}   ~~~~~~~~~~~~~~~~~~~~~~~~~~   ~~~~~~~~~~~~~~~~~   @{"Aktuelle Anzeige" LINK Menus 89}
                      @{"Task&Fenster-Relationen  " LINK Menus 47}   @{"Zurück          " LINK Menus 79}
                      @{"Sicherheitsabfragen      " LINK Menus 60}

_______________________________________________________________________________________
 2.Funktionsleiste:

    @{"   Add   " LINK Funks 9}@{" Remove " LINK Funks 36}@{" Signal " LINK Funks 51}@{" Priority " LINK Funks 57}@{"  Close  " LINK Funks 69}@{"  Freeze  " LINK Funks 75}@{" Fenster " LINK Funks 87}@{" Zurück " LINK Funks 100}

_______________________________________________________________________________________
 3.Anzeigeauswahl:

    @{"   Tasks    " LINK Anzeige   9}@{"  Screens   " LINK Anzeige  33}@{"   Ports   " LINK Anzeige  57}@{" Libraries  " LINK Anzeige  78}@{" Resources " LINK Anzeige 101}@{"  Devices   " LINK Anzeige 126}
    @{"   System   " LINK Anzeige 150}@{" Interrupts " LINK Anzeige 193}@{"  Assigns  " LINK Anzeige 216}@{" Residents  " LINK Anzeige 229}@{"   Fonts   " LINK Anzeige 244}@{"  Struktur  " LINK Anzeige 266}

@ENDNODE


@NODE ToolTypes
@TITLE "XOpa-Dokumentation:  ToolTypes"

@{b}VIII. Tool-Types@{ub}

Das Programm unterstützt mehrere ToolTypes, um bestimmte
Einstellungen nicht immer wieder treffen zu müssen.

Die folgenden Tools-Types werden unterstützt:

            · STRUCTS       - als Parameter Pfad und Dateiname für die externen
                              Strukturdefinitionen des @{"Strukturmodus" LINK Struktur}.
            · TASKWINDOWS   - Wählt standardmäßig den Menüpunkt
                              @{"«Task&Fenster-Relationen»" LINK Menus 47} an.
            · SECURITYCHECK - Wählt standardmäßig den Menüpunkt
                              @{"«Sicherheitsabfragen»" LINK Menus 60} an.

            · DISPLAY       - dieser ToolType unterstützt die folgenden
                              Parameter: TASKS, SCREENS, PORTS, LIBRARIES,
                                         RESOURCES, DEVICES, SYSTEM, INTERRUPTS,
                                         ABOUT, ASSIGNS, FONTS, RESIDENTS
                              Je nach Parameter wird ein @{"Anzeigemodus" LINK Anzeige} beim
                              Start automatisch eingestellt, standardmäßig
                              wird ABOUT (Informationen über XOpa) angezeigt.
            · WINDOW        - dieser ToolType benötigt vier Angaben für die
                              Fenstergröße: die X- und Y-Position, die Breite
                              und die Höhe des Fensters.
                              Die Angaben werden durch Schrägstriche getrennt,
                              wobei immer 3 Schrägstriche vorkommen müssen.
                              Es besteht die Möglichkeit, einzelne Angaben
                              wegzulassen. (z.B. WINDOW=0//600/)

Die ToolTypes werden natürlich nur gelesen, wenn das Programm von
der Workbench aus gestartet wird. Durch Einklammern eines ToolTypes
mit «()» wird dieses überlesen.
@ENDNODE


@NODE Requester
@TITLE "XOpa-Dokumentation:  Requester"

@{b}VII. Requester@{ub}

In diesem Kapitel finden Sie ein Erklärung für die verschiedenen
von XOpa geöffneten Requester. Dieses Kapitel umfaßt die Beschrei-
bung der folgenden Requester: @{"Bildschirm öffnen" LINK Requester 10}, @{"Assign für ein Verzeichnis" LINK Requester 29},
                              @{"Signal senden" LINK Requester 47}, @{"Priorität ändern" LINK Requester 63},
                              @{"Node-Strukturen" LINK Requester 83} und @{"Andere Struktur" LINK Requester 106}.


@{b}Bildschirm öffnen@{ub}

Der Requester erscheint, wenn Sie im @{"Screens-Anzeigemodus" LINK Anzeige 33} die
Taste @{"Add" LINK Funks 9} drücken.
In diesem Requester werden die Einstellungen für einen neuen
Bildschirm gemacht. Dieser ist in jedem Fall ein öffentlicher,
d.h. von anderen Programmen aus benutzbarer Bilschirm.
In dem Eingabefeld (Stringgadget) geben Sie bitte den Namen
des zu öffnenden Bildschirmes ein. Wenn Sie dort keine Angabe
machen wird ein Standardname benutzt.
Wenn Sie OS2.1 oder höher besitzen, können Sie nun noch einen
Bildschirmmodus einstellen (Modus-Gadget).
Unter Kickstart 2.0 ist dies nicht möglich, hier werden die
Werte des Workbench-Screens benutzt.
Wenn Sie auf das "Ok"-Gadget drücken wird der Bildschirm ge-
öffnet, ein Klick auf das "Abbrechen"-Gadget schließt das
Fenster ohne einen neuen Bildschirm zu öffnen.


@{b}Assign für ein Verzeichnis@{ub}

Diesen Requester rufen Sie auf, indem Sie die Taste @{"Add" LINK Funks 9} im Modus
@{"Assigns" LINK Anzeige 216} drücken.
Ein Assign für ein Verzeichnis ist eine Zuweisung mittels derer Sie
schnell auf ein bestimmtes Verzeichnis zugreifen können ("FONTS:" z.B.
ist normalerweise eine Zuweisung auf das Verzeichnis "SYS:Fonts").
Im oberen Eingabefeld geben Sie bitte den Namen der Zuweisung
an (z.B. "Fonts"). Ein Doppelpunkt ist hier nicht notwendig. Im
unteren Verzeichnis geben Sie bitte den Pfad für das Verzeichnis
auf das die Zuweisung zeigen soll (z.B. "SYS:Fonts").
Ein Klick auf das "Wählen..."-Gadget und ein Dateirequester er-
scheint, in dem Sie ein Verzeichnis wählen können.
Wenn Sie auf das "Ok"-Gadget drücken wird die Zuweisung generiert,
ein Klick auf das "Abbrechen"-Gadget schließt den Requester ohne
eine Zuweisung zu machen.


@{b}Signal senden@{ub}

Dieser Requester erscheint, wenn Sie im @{"Tasks-Anzeigemodus" LINK Anzeige 9} die
Funktionstaste @{"Signal" LINK Funks 51} gedrückt haben, nachdem Sie eine Auswahl
in der Liste vorgenommen haben.
Im oberen Feld können Sie eine Zahl im Hexadezimalsystem eingeben, die
nun an den internen Port des Tasks gesendet wird.
Durch die sogenannten Radio-Buttons (die runden Knöpfe am linken Fenster-
rand) haben Sie die Wahl zwischen der Möglichkeit dem Programm die ein-
gegebene Hexadezimalzahl zu senden und der Möglichkeit ihm Abbruchsignale
zu schicken.
Im Anfangszustand (direkt nach dem Öffnen des Requesters) ist es egal,
für welche der beiden Möglichkeiten Sie sich entscheiden, da beide ver-
suchen, das Programm abzubrechen.


@{b}Priorität ändern@{ub}

Dieser Requester erscheint dann, wenn Sie die Taste @{"Priority" LINK Funks 57} in
einem der Modi gedrückt haben, nachdem Sie eine Auswahl in der Liste vor-
genommen haben.
In dem Eingabefeld ist eine Priorität zwischen -128 und +127 einzugeben.
Falls Sie eine Zahl ausserhalb dieses Bereiches eingeben, setzt XOpa
die jeweilige Ober- oder Untergrenze ein.
Die Priorität eines Objektes hat verschiedene Auswirkungen auf bestimmte
Dinge, die Typabhängig sind.
Wenn Sie z.B. die Priorität eines @{"Tasks" LINK Anzeige 9} erhöhen, bewirkt dies, daß er mehr
und öfter Rechenzeit vom Prozessor zur Verfügung gestellt kriegt. Bei einer
Erniedrigung geschieht das Gegenteil und der Task bekommt weniger Rechenzeit.
Bei Prioritätenänderung von Speicherblöcken (z.B. Fast- & Chip-RAM) bewirkt
dies, das ein bestimmter Speicher vorgezogen oder vernachlässigt wird, wenn
ein Programm Speicher anfordert. So sollten Sie langsamen RAM-Erweiterungen
eine niedrige Priorität geben, um zu verhindern, daß Ihr Computer langsamer
wird auch wenn noch schnelles RAM frei wäre.


@{b}Node-Strukturen@{ub}

Dieser Requester ist immer vom @{"Struktur-Menü" LINK Menus 67} aus aufrufbar. Er hat folgende
Funktion: wenn Sie im @{"Strukturmodus" LINK Struktur} auf eine "Node" (ein Element einer Exec-
Liste) treffen, können Sie für bestimmte Typen eine Standardstruktur wählen,
da bei diesen nicht klar ist, welche Struktur angezeigt werden soll.
Beim Typ NT_GRAPHICS z.B. ist nur klar, daß es sich um eine Liste der gra-
phics.library handelt, aber nicht ob es nun eine "MonitorSpec"-Struktur oder
irgendetwas anderes ist.
Um Standardstrukturen für einen Typen einzustellen, drücken Sie solange
das Cycle-Gadget (das oberste Gadget) bis es den gewünschten Typ anzeigt.
Nun wählen Sie aus der Liste der verfügbaren Strukturen die gewünschte aus,
wobei Sie darauf achten sollten, keine Struktur anzuwählen, die nicht auf
der "Node"-Struktur basiert, da dies zu scheinbarem Fehlverhalten XOpas
führen kann.
Die folgenden Typen stehen hierbei zur Auswahl: NT_MESSAGE, NT_FREEMSG,
NT_REPLYMSG, NT_RESOURCE (normalerweise die Librarystruktur) und NT_GRAPHICS
(für Listen der graphics.library).
Die hier getroffenen Einstellungen werden allerdings nicht gespeichert,
allerdings gibt es voreingestellte Typen, die in den meisten Fällen zu-
treffen sollten.


@{b}Andere Struktur@{ub}

Diesen Requester können Sie nur aufrufen, wenn Sie sich im @{"Strukturmodus" LINK Struktur}
befinden, da Sie mit diesem Requester eine andere Struktur für die aktuelle
Adresse anzeigen lassen.
Zusätzlich können Sie im oberen Eingabefeld eine andere Adresse angeben,
die dargestellt werden soll. Diese Adresse müssen Sie im Hexadezimalsystem
(Ziffern von 0-f, 8-stellig) angeben.
In der Liste können Sie eine Struktur für die Anzeige aussuchen. Wenn
Sie dort keine Auswahl treffen, d.h. wenn kein Listeneintrag angewählt
wurde, wird die Anzeige auf eine spezielle Speicheranzeige umgeschaltet,
die auch dann angezeigt wird, wenn Sie auf einem einfachen, typenlosen
Zeiger einen Doppelklick machen.
Sie sollten darauf achten, eine Adresse im Bereich des vorhandenen Speicher
anzugeben, wenn Sie selber eine eingeben.
Dieser Requester erscheint nicht, wenn Sie sich keine Struktur anzeigen
lassen, z.B. direkt nach der Anwahl des @{"Strukturmodus" LINK Struktur}.









@ENDNODE


@NODE Struktur
@TITLE "XOpa-Dokumentation:  Strukturmodus"

@{b}IX. Strukturmodus von XOpa@{ub}

Der Strukturmodus gibt Ihnen einen Einblick in die Struktur-Interna des
Betriebssystems. Nachdem Sie den Modus ausgewählt haben wird eine Liste
der Libraries angezeigt, von denen eine Strukturdefinition existiert.
Mit einem Doppelklick auf eine dieser Libraries wird die interne Struktur
dieser angezeigt.
Bei einem Doppelklick auf einen Zeiger oder auf einen Zeiger auf eine
Struktur (dargestellt durch "^Strukturname") wird entweder in die je-
weilige Strukturdarstellung oder in eine Speicherdarstellung umgeschaltet.

Mit der Taste @{"Zurück" LINK Funks 100} können Sie nun die vorher angezeigte Struktur
wieder anzeigen lassen.

Weiterhin haben Sie die Möglichkeit sich beliebige Speicheradressen in
einer Struktur- oder Speicherdarstellung darzustellen (mittels
@{"«Andere Struktur»" LINK Requester 106}).

Die Strukturanzeige ist wie folgt aufgebaut:

  In der ersten Zeile steht die aktuelle Adresse und die aktuell dargestellte
  Struktur. Dann steht links der Name des Eintrages und rechts der Inhalt und Typ.
  Wenn eine Struktur in eine andere eingebettet wird das durch einen waagerechten
  Strich gefolgt von dem Namen der Struktur deutlich gemacht.
  Zusätzlich werden die folgenden Einträge eingerückt.

Im Speichermonitor steht links die Adresse, dann folgen die dort liegenden Daten
einmal in der Hexadezimaldarstellung und dann in einer ASCII-Darstellung.
Durch einen Doppelklick auf die letzte Zeile im Speichermonitor ("-> die nächsten
1024 Bytes") werden eben diese dargestellt.

Die Strukturdefinitionen für diesen Modus sind teilweise im Programm enthalten,
sie befinden sich aber größtenteils in einer externen Datei, normalerweise in
der Datei "XOpa.structs", durch die @{"ToolTypes" LINK toolTypes} kann man allerdings auch
eine andere Datei auswählen.
Durch die externe Strukturdefinitionsdatei hat man die Möglichkeit, seine
eigenen Strukturen, die innerhalb seiner Programme verwendet werden mit
XOpa auf deren Richtigkeit zu überprüfen und die Strukturdefinitionen nahezu
beliebig (Speichergrenze) zu erweitern.



@{b}Der Aufbau der Strukturdefinitionsdatei@{ub}

Damit XOpa die eingestellte Datei als Strukturdefinitionsdatei
erkennt, muß sie mit folgendem Eintrag beginnen:

  # --==**> XOpa-Strukturdefinition

Für die Definitionen gibt es die folgenden Befehle:

  #libraries - Danach folgt eine Liste der Libraries mit Struktur-
               definition. Als erstes muß der Name der Library ange-
               geben werden, dann folgt ein "=" und der Name der
               Struktur, die für diese Library benutzt werden soll.
               Achten Sie darauf, daß Sie keinen Schreibfehler machen,
               da die Strukturen sonst nicht benutzt werden können!
  #structs   - Danach folgt eine Liste der Strukturdefinitionen.
  #end       - Beendet einen Teil (z.B. #structs), ist aber nicht notwendig

  @struct    -Innerhalb der Strukturdefinitionen leitet dieser Befehl eine
              neue Struktur ein. Der Name ist mit einem "=" anzuschliessen.
              In den dann folgenden Definitionen ist erst der Name und
              dann der Typ mit einem Doppelpunkt davor anzugeben.

Kurzes Beispiel:

  # --==**> XOpa-Strukturdefinition

  #libraries
  intuition.library=IntuitionBase

  #structs
  @struct=IntuitionBase
  LibNode       :Library
  ...

Mit ";" am Anfang einer Zeile leitet man einen Kommentar ein.
Für die Definitionen stehen folgende Typen zur Auswahl:

   · BYTE,UBYTE,FLGBYTE - je 1 Byte lang
   · WORD,UWORD,FLGWORD - je 2 Bytes lang
   · LONG,FLGLONG       - je 4 Bytes lang
   · PTR,"^Struktur"    - auch 4 Bytes lang, beim Doppelklick springt
                          man an den Inhalt dieses Eintrages!
   · BPTR               - ähnlich "PTR", nur beschreibt dieser Typ einen
                          BCPL-Zeiger; d.h. die Adresse wird vor dem
                          Sprung mal 4 genommen.
   · "Struktur"         - richtet sich nach der Länge der angegebenen
                          Struktur. Diese Struktur muß bereits vorher
                          definiert worden sein!

"Struktur" ist durch den Namen der jeweiligen Struktur zu ersetzen.
Das Prefix "U" bedeutet "unsigned", also eine vorzeichenlose Zahl.
Die Vorsilbe "FLG" bewirkt, das die Zahl im Hexadezimalsystem angegeben
wird (dadurch werden die "Flags" deutlicher).

Falls noch irgendwelche Unklarheiten bestehen, schauen Sie sich bitte
die beiliegende Strukturdefinitionsdatei @{"«XOpa.structs»" LINK XOpa.structs/main} an.

Bereits im Programm sind derzeit die folgenden zehn Strukturen integriert:

  · SysBase, MinNode, Node, MinList, List, Library, IntVector,
    SoftIntList, MsgPort, Device

Für Erweiterungswünsche wenden Sie sich bitte an mich. Viel Spaß beim
ausprobieren des Strukturmodus`.
@ENDNODE


@NODE Funks
@TITLE "XOpa-Dokumentation:  Funktionsleiste"

@{b}VI. Funktionsleiste@{ub}

Hier sind die Erklärungen zu der Funktionsleiste. Dazu ist zu
beachten, daß nicht jede Funktion von jedem Anzeigemodus aus
aufrufbar ist (siehe @{"Anzeige" LINK Anzeige}) und sich viele
Funktionen erst nach Anwahl eines Eintrages anwählen lassen.


@{b}Add@{ub}
Diese Funktion ist nur in den Modi @{"Screens" LINK Anzeige 33}, @{"Assigns" LINK Anzeige 216} und @{"Fonts" LINK Anzeige 244} anwählbar.
Auf Deutsch bedeutet "Add" hinzufügen, und das ist es auch was diese Funktion macht.
Dabei ist das hinzuzufügende Objekt abhängig davon, in welchem Anzeigemodus Sie sich
befinden.
Je nachdem aus welchem Modus Sie sie benutzen, öffnet sich ein bestimmtes Fesnter:

   - im @{"Screens-Modus" LINK Anzeige 33} öffnet sich ein Requester, in dem man Einstellungen
     zum Öffnen eines Public-Screens trifft. (Siehe Requester @{"«Bildschirm öffnen»" LINK Requester 10})
   - im @{"Assigns-Modus" LINK Anzeige 216} wird ein Requester mit zwei Texteingabefeldern ge-
     öffnet. Im ersten geben Sie den Namen der Zuweisung ohne Doppelpunkt
     ein (z.B. so etwas wie "Fonts").
     Im zweiten Eingabefeld geben Sie den Pfadnamen an, auf den die
     Zuweisung zeigen soll (z.B. "SYS:Fonts" für die Zuweisung "Fonts:").
     Um die Eingabe zu bestätigen drücken Sie "Ok". Wenn Sie die Zuweisung
     nicht übernehmen wollen, drücken Sie entweder "Abbrechen" oder klicken
     Sie auf den Schließknopf in der Fensterleiste.
     (Siehe auch Requester @{"«Assign für Verzeichnis»" LINK Requester 29})
   - im @{"Fonts-Modus" LINK Anzeige 244} öffnet sich das übliche Zeichensatzauswahlfenster
     (ein ASL-Requester, zur Bedienung verweise ich auf die zu Ihrem
     Computer beiliegende Literatur).
     Dabei wird nicht nur der zuletzt angewählte Zeichensatz geöffnet, sondern
     auch alle, die das Auswahlfenster bei der Auswahl öffnet!

Die Funktion benötigt keinen vorher angewählten Eintrag.


@{b}Remove@{ub}
Diese Funktion ist von sehr vielen @{"Anzeigemodi" LINK Anzeige} aus aufrufbar.
Sie ist dazu da, Objekte aus den Systemlisten und dem Speicher zu entfernen.
Bei aktivierten @{"Sicherheitsabfragen" LINK Menus 60} werden Sie gefragt,
ob Sie das jeweilige Objekt wirklich entfernen wollen.
Bei einigen Modi gibt es noch ein paar zusätzliche Optionen (bei @{"Screens" LINK Anzeige 33}
können alle Fenster geschlossen werden, für Tasks siehe @{"Task-Fenster-Relationen" LINK Menus 47}).
Vor der Anwahl dieser Funktion muß der zu entfernende ein Eintrag in der
Liste ausgewählt worden sein, sonst tut diese Funktion gar nichts.

!! Diese Funktion ist mit Vorsicht zu geniessen, da das System    !!
!! die geschlossenen Objekte noch brauchen kann.                  !!
!! Wundern Sie sich also nicht, wenn der Rechner danach abstürzt. !!


@{b}Signal@{ub}
Mit dieser Funktion, die nur im @{"Tasks-Modus" LINK Anzeige 9} anwählbar ist, können Sie
einem zuvor angewähltem Task ein Signal zuschicken oder versuchen, ihn abzubrechen.
Nach der Anwahl dieser Funktion öffnet sich der Requester @{"«Signal senden»" LINK Requester 47}.


@{b}Priority@{ub}
Diese Funktion ist von sehr vielen @{"Anzeigemodi" LINK Anzeige} aus aufrufbar.
Prioritäten werden vom System verteilt, um z. B. festzulegen welcher Task
wieviel Rechenzeit bekommt, oder nach welcher Reihenfolge eine bestimmte
Liste durchgegangen wird (z.B. bei AllocMem() wird erst der Speicher mit
der höchsten Priorität verbraucht).
Mit dieser Funktion können Sie nun diese für einen Eintrag ändern, nach-
dem Sie ihn mit der Maus angewählt haben. Nach dem Klick auf den Knopf
(Gadget) öffnet sich der Requester @{"«Priorität ändern»" LINK Requester 63}.
Für nähere Informationen zur Funktion siehe dort.


@{b}Close@{ub}
Dieser Knopf (Gadget) hat im Prinzip die gleiche Funktion wie @{"Remove" LINK Funks 36}.
Es gibt ihn auch nur aus "Geschmacksgründen". (Man entfernt (remove) keinen
Bildschirm, man schließt (close) ihn!?


@{b}Freeze@{ub}
Diese Funktion kann nur vom @{"Tasks-Modus" LINK Anzeige 9} aus aufgerufen werden.
Die Exec-Library liest ständig die Taskliste ein und ruft die darin
enthaltenen Einträge auf.
Diese Funktion entfernt den angewählten Task von dieser Liste und hängt
ihn an eine spezielle Warteliste an, woraufhin dieser Task von Exec
"übergangen" wird; er ist eingefroren.
Ist bei Anwahl dieser Funktion ein bereits eingefrorener Task angewählt,
wird dieser wieder in die aktive Liste verschoben und setzt seine Aus-
führung fort.


@{b}Fenster@{ub}
Diese Funktion ist in den Anzeigemodi @{"Tasks" LINK Anzeige 9} und @{"Screens" LINK Anzeige 33} vor-
handen.
Nach dem Drücken dieses Knopfes (Gadgets) werden alle offenen Fenster des
angewählten Screens oder Tasks angezeigt. Wenn Sie das Gadget dann nochmals
drücken, wird die angezeigte Liste neu erstellt, um Änderungen (ein neues
Fenster wurde geöffnet) schnell sichtbar zu machen.
Dabei werden folgende Informationen angezeigt:

   · Adresse   - Die Adresse des Fensters im System
   · Pos(x,y)  - Die Position des Fensters auf dem Screen
   · Maße(x,y) - Breite und Höhe des Fensters
   · IDCMP     - Die IDCMP-Flags spezifizieren die Art der Nachrichten,
                 die das Fenster von Intuition bekommt. Nach dem Doppel-
                 klick auf einen Eintrag werden diese Flags nocheinmal
                 lesbar dargestellt
   · Flags     - Diese Flags bestimmen die Eigenschaften des Fensters.
                 Auch sie werden nochmal übersichtlich angezeigt, wenn
                 man auf einen Eintrag doppellt klickt
   · Titel     - Der aktuelle Fenstertitel

Durch einen Doppelklick auf einen Eintrag kann man weitere Informationen
über das Fenster bekommen. In diesem Modus ist dann das Zurück-Gadget an-
wählbar, das die eigentliche Fensterliste wieder anzeigt.


@{b}Zurück@{ub}
Diese Funktion ist eigentlich eine spezielle Funktion des @{"Strukturmodus" LINK Struktur},
wird allerdings auch bei der Fensterliste verwendet. (Siehe @{"Fenster" LINK Funks 87})
Der Strukturmodus merkt sich immer die zuletzt angezeigten Strukturen.
Drücken Sie nun auf dieses Gadget zeigt er die letzte Struktur wieder an.
Wiederholen Sie dieses wird Struktur davor angezeigt usw. bis die erste
angezeigte Struktur angezeigt wird. In diesem Fall wird das Gadget auch
vor einer Anwahl sichtbar gesperrt.
Dieser Knopf hat die gleiche Funktion wie der Menüpunkt @{"Zurück" LINK Menus 79} im
@{"Struktur-Menü" LINK Menus 67}.



@ENDNODE


@NODE Anzeige
@TITLE "XOpa-Dokumentation:  Anzeigeleiste"

@{b}V. Anzeigeleiste@{ub}

Hier finden Sie der Reihe nach alle über die Anzeigeknopfleisten (die
unteren beiden Reihen) aus aufrufbaren Anzeigemodi. Dabei werden neben
der Art der angezeigten Objekte auch die einzelnen, dazu angezeigten
Informationen erklärt.


@{b}Tasks@{ub}
Bei diesem Modus werden die im System laufenden Tasks
und Prozesse (Programme) angezeigt. Jedes im System laufende
Programm (auch XOpa oder z.B. DPaint) ist ein Task oder Prozeß.
Dabei werden folgende Informationen dargestellt:

   · Adresse   - Die Adresse des Tasks im System
   · Pri       - Die Priorität. Siehe auch Requester @{"«Ändere Priorität»" LINK Requester 63}
   · Stack     - Der vom Task für Variablen und Registerrettung
                 benutzte Speicher
   · Signale   - Die Signale die der Task benutzt
   · State     - Der Status des Tasks, z.B. run (am laufen),wait (warten),
                 frozen (Siehe auch @{"Freeze" LINK Funks 75}), ...
   · Code      - Bestimmte Eigenschaften des Tasks
   · Typ       - Task oder Prozeß. Bei einem Prozeß stehen weitere Daten zur
                 Verfügung. Ein Prozeß ist ein von Dos aus geladenes Programm
   · Name      - Name des Tasks. Wenn der Task von einer Shell aus geöffnet wird,
                 wird zusätzlich die Prozeßnummer angegeben.

Bei einem Doppelklick auf einen Eintrag erscheinen zusätzliche Informationen.
Dieser Modus unterstützt die folgenden Funktionen:

   @{"Remove" LINK Funks 36}, @{"Signal" LINK Funks 51}, @{"Priority" LINK Funks 57}, @{"Freeze" LINK Funks 75} und @{"Fenster" LINK Funks 87}

@{b}Screens@{ub}
Bei diesem Modus werden alle offenen Screens (Bildschirme) aufgelistet.
Dabei werden die folgenden Informationen dargestellt:

   · Adresse   - Adresse des Screens im System
   · Pos(x,y)  - Gibt die Position des Screens auf dem Monitor an
   · Maße(x,y) - Breite und Höhe des Screens
   · Dep       - Farbtiefe des Screens (z.B. 2 für vier Farben)
   · Modus     - Gibt die ab OS2.0 existierende ModeID an, zu der
                 allerdings genauere Informationen (bei Doppelklick)
                 anzeigbar sind.
   · Typ       - Es gibt bisher drei verschiedene Typen von Screen:
                          - "wbench" ist die Kennung des Workbench-Screens
                          - "public" für einen öffentlichen Screen, auf dem
                            jedes Programm ein Fenster öffnen darf
                          - "custom" schließlich ist ein privater Screen eines
                            Programmes
   · Titel     - Wie zu eraten wird hier der aktuelle Screen-Titel angezeigt.

Bei einem Doppelklick auf einen Eintrag erscheinen zusätzliche Informationen.
Dieser Modus unterstützt die folgenden Funktionen:

   @{"Add" LINK Funks 9}, @{"Close" LINK Funks 69} und @{"Fenster" LINK Funks 87}

@{b}Ports@{ub}
In diesem Modus wird die Systemliste der Ports (eine Art
Empfänger für Nachrichten) angezeigt.
Dabei werden die folgenden Informationen dargestellt:

   · Adresse   - Adresse des Ports im System
   · Pri       - Priorität des Ports. Siehe auch Requester @{"«Priorität ändern»" LINK Requester 63}
   · Flags     - Dort werden bestimmte Eigenschaften des Ports
                 angezeigt, normalerweise die Art der zu empfangenden
                 Nachricht.
   · SBit      - Gesetztes Signal-Bit für die Wait()-Funktion
   · Typ       - Eigentlich überflüssig, da immer "msgport"
   · Portname  - Dieser Name gibt den eigentlichen Portnamen an
   · Taskname  - Der Name des Tasks (Programmes) zu dem der Port gehört

Bei einem Doppelklick auf einen Eintrag wird in den @{"Strukturmodus" LINK Struktur} ge-
schaltet und eine MsgPort-Struktur mit der Adresse Eintrages angezeigt.
Dieser Modus unterstützt die folgenden Funktionen:

   @{"Remove" LINK Funks 36} und @{"Priority" LINK Funks 57}

@{b}Libraries@{ub}
Bei diesem Modus sehen Sie die zur Verfügung stehenden
Funktionsbibliotheken (Libraries).
Dabei werden die folgenden Informationen dargestellt:

   · Adresse   - Adresse der Library im System
   · Pri       - Priorität der Library. Siehe auch Requester @{"«Priorität ändern»" LINK Requester 63}
   · Version   - Die Version der Library. Was auch sonst?
   · OpenC     - Dieser Wert besagt, wie oft die Library von Programmen aus
                 geöffnet wurde. Wenn dieser Wert 0 ist, heißt das, das die
                 Library aus dem System entfernt werden kann.
   · Neg       - die Größe des Offset-Bereichs der Library mit den
                 Sprungadressen für die internen Befehle
   · Pos       - Anzahl der Bytes nach der Library-Struktur
   · Typ       - In diesem Fall wohl "library" !?
   · Name      - Der Name der Library

Bei einem Doppelklick auf einen Eintrag wird in den @{"Strukturmodus" LINK Struktur} ge-
schaltet und eine Library-Struktur mit der Adresse Eintrages angezeigt.
Dieser Modus unterstützt die folgenden Funktionen:

   @{"Remove" LINK Funks 36} und @{"Priority" LINK Funks 57}

@{b}Resources@{ub}
In diesem Modus werden die Resources des Systems in
der Liste aufgelistet. Diese regeln den Low-Level-
Zugriff auf Teile der Amiga-Hardware.
Dabei werden die folgenden Informationen dargestellt:

   · Adresse   - Adresse des Resources im System
   · Pri       - Priorität des Resources. Siehe auch Requester @{"«Priorität ändern»" LINK Requester 63}
   · Version   - Die Version des Resources. Was auch sonst?
   · OpenC     - Dieser Wert besagt, wie oft das Resource von Programmen aus
                 geöffnet wurde. Wenn dieser Wert 0 ist, heißt das, das das
                 Resource aus dem System entfernt werden kann.
   · Neg       - die Größe des Offset-Bereichs des Resources mit den
                 Sprungadressen für die internen Befehle
   · Pos       - Anzahl der Bytes nach der Library-Struktur
   · Typ       - In diesem Fall wohl "resource"
   · Name      - Der Name des Resources

Bei einem Doppelklick auf einen Eintrag wird in den @{"Strukturmodus" LINK Struktur} ge-
schaltet und die im Requester @{"«Node-Strukturen»" LINK Requester 83} angewählte
Struktur angezeigt (standardmäßig eine Library-Struktur).
Dieser Modus unterstützt die folgenden Funktionen:

   @{"Remove" LINK Funks 36} und @{"Priority" LINK Funks 57}

@{b}Devices@{ub}
Bei diesem Modus wird eine Liste aller Devices im System
dargestellt. Devices regeln den High-Level-Zugriff auf Teile
der Amiga-Hardware.
Dabei werden die folgenden Informationen dargestellt:

   · Adresse   - Adresse des Devices im System
   · Pri       - Priorität des Devices. Siehe auch Requester @{"«Priorität ändern»" LINK Requester 63}
   · Version   - Die Version des Devices. Was auch sonst?
   · OpenC     - Dieser Wert besagt, wie oft das Device von Programmen aus
                 geöffnet wurde. Wenn dieser Wert 0 ist, heißt das, das das
                 Device aus dem System entfernt werden kann.
   · Neg       - die Größe des Offset-Bereichs des Devices mit den
                 Sprungadressen für die internen Befehle
   · Pos       - Anzahl der Bytes nach der Library-Struktur
   · Typ       - In diesem Fall wohl "device"
   · Name      - Der Name des Devices

Bei einem Doppelklick auf einen Eintrag wird in den Strukturmodus ge-
schaltet und eine Device-Struktur mit der Adresse Eintrages angezeigt.
Dieser Modus unterstützt die folgenden Funktionen:

   @{"Remove" LINK Funks 36} und @{"Priority" LINK Funks 57}

@{b}System@{ub}
In diesem Modus werden verschiedene Daten dargestellt. Hier steht
welchen Prozessor Ihr Computer eingebaut hat, ob Sie einen mathe-
matischen Co-Prozessor besitzen, welches Chipset Sie haben, die
verschiedenen Versionen Ihres Betribssystems und falls der Rechner
bereits eine Guru-Meldung zeigen mußte (Absturz), steht hier die
zuletzt angezeigte.
Außerdem finden Sie hier eine Liste der Speicherblöcke und eine
Liste der Systemerweiterungen.
Eine Systemerweiterung ist z.B. eine Turbokarte oder ein SCSI-Host-
Adapter, solange die Karte in einem der ZORRO-Erweiterungsschächte
steckt.
Ein Speicherblock ist z.B. bei einem Standard-A4000 2MB-Chip-RAM.
In dieser Liste werden die folgenden Informationen dargestellt:

   · Adresse   - Die Adresse des Speicherblock-Eintrages im Speicher
   · Pri       - Priorität des Speichers. Siehe auch Requester @{"«Priorität ändern»" LINK Requester 63}
   · Lower     - Untere Adresse des Speicherblockes
   · Upper     - Die obere Adresse
   · Größe     - Die Größe des Speicherblockes (Upper-Lower)
   · Frei      - freier Speicher des Speicherblockes
   · Name      - Name des Speichers, z.B. "chip memory"

In der Liste der Systemerweiterungen werden folgende Informationen
angezeigt:

   · Adresse   - Adresse der Erweiterungskarte (Board)
   · Größe     - Auf der Karte vorhandener Speicher
   · Typ       - hier wird eine ungefähre Angabe gemacht, um was
                 für eine Karte es sich handeln könnte (z.B. RAM)
   · Prod.     - jede Karte bekommt eine Kennung vom Hersteller
   · Hersteller- jeder Hersteller bekommt von Commodore ein bestimmte
                 Nummer, diese wird, wenn möglich mit dem Namen des
                 Herstellers ausgegeben

Bei der Liste der Speicherblöcke (und nur da) ist es möglich die
Priorität eines Eintrages zu ändern, nachdem Sie ihn in der Liste
durch einfaches anklicken angewählt haben.
Dieser Modus unterstützt die folgende Funktion, die allerdings nur
auf die Speicherblock-Liste angewandt funktioniert:

   @{"Priority" LINK Funks 57}

@{b}Interrupts@{ub}
In diesem Modus werden die im System vorhandenen Interrupts
in der Liste angezeigt. Ein Interrupt ist eine Art Programm
das unter bestimmten Gegebenheiten aufgerufen wird, z.B. wenn
der Rasterstrahl des Monitors eine bestimmte Position erreicht
hat.
Dabei werden die folgenden Informationen dargestellt:

   · Adresse   - Adresse des Interrupts im System
   · Pri       - Priorität des Interrupts. Siehe auch Requester @{"«Priorität ändern»" LINK Requester 63}
   · Data      - Zeiger auf den Datenteil
   · Code      - Zeiger auf den Programmteil
   · Nr        - Interruptnummer (gibt an welcher Interruptkanal
                 benutzt wird)
   · Interrupt - Verständliche Bezeichnung für die Int.-Nummer
   · Ctrl      - Art des Interrupts (Control: handler/server)
   · Typ       - Entweder "interrupt" oder "unknown"
   · Name      - Name des Interruptes.

Dieser Modus unterstützt die folgenden Funktionen:

   @{"Remove" LINK Funks 36} und @{"Priority" LINK Funks 57}

@{b}Assigns@{ub}
In diesem Modus wird eine Liste der Verzeichnis-Zuweisungen
(Assigns) dargestellt.
Dabei werden die folgenden Informationen dargestellt:

   · Adresse     - Adresse der Zuweisung im System
   · Assign-Name - Name des Assigns, z.B. LIBS
   · Pfad        - der komplette Pfad für den assign

Dieser Modus unterstützt die folgenden Funktionen:

   @{"Add" LINK Funks 9} und @{"Remove" LINK Funks 36}

@{b}Residents@{ub}
In der angezeigten Liste finden Sie alle sich im Kickstart-ROM
befindlichen Teile des Betriebssystems.
Dabei werden die folgenden Informationen dargestellt:

   · Adresse   - Adresse des Objektes im ROM
   · Pri       - Priorität. Siehe auch Requester @{"«Priorität ändern»" LINK Requester 63}
   · Version   - Version des Objektes
   · Flags     - Flags in der Resident-Struktur
   · Typ       - Der Typ des Objektes (z.B. "library")
   · Name      - Der Name des Objektes

In diesem Modus stehen keine Funktionen zur Verfügung, da die
Daten im ROM stehen und somit nicht veränderbar sind.

@{b}Fonts@{ub}
In diesem Modus wird eine Liste der geöffneten Zeichen-
sätze (Fonts) angezeigt.
Dabei werden die folgenden Informationen dargestellt:

   · Adresse   - Adresse des Zeichensatzes im System
   · Breite    - normale Breite des Fonts in Pixeln
   · Höhe      - Höhe des Fonts
   · BaseLine  - Die Grundlinie des Fonts
   · LoChar    - Zeichen mit der kleinsten ASCII-Nummer
                 in der BitMap des Zeichensatzes
   · HiChar    - Zeichen mit der höchsten ASCII-Nummer des Fonts
   · OpenC     - Wie oft der Font geöffnet wurde (OpenCount)
   · CharData  - Wo die BitMap des Fonts im Speicher liegen
   · Name      - Der Name des Zeichensatzes

Bei einem Doppelklick auf einen Eintrag der Liste wird ein
Fenster geöffnet, in dem der Zeichensatz dargestellt wird.
Dieser Modus unterstützt die folgenden Funktionen:

   @{"Add" LINK Funks 9} und @{"Close" LINK Funks 69}

@{b}Struktur@{ub}
In diesem Modus können Sie sich die Systeminterna direkt in den
dafür vorgesehenen Strukturen anzeigen lassen. Dazu gibt es
viele Möglichkeiten (Siehe @{"Strukturmodus" LINK Struktur}).
Aus Sicherheitsgründen ist es aber hier nicht möglich, die
vorliegenden Daten zu manipulieren.
Dieser Modus unterstützt, wenn möglich, die folgende Funktion:

   @{"Zurück" LINK Funks 100}

















@ENDNODE


@NODE Menus
@TITLE "XOpa-Dokumentation:  Menüs"

@{b}IV. Menüs@{ub}

Hier werden die einzelnen Menüpunkte und ihre Auswirkungen
beschrieben.
Insgesamt sind vier Menüs vorhanden: @{"Projekt" LINK Menus 12}, @{"Optionen" LINK Menus 35},
                                     @{"Struktur" LINK Menus 67} und @{"Hilfe" LINK Menus 86}
Die Menüpunkte des vorletzten Menüs lassen sich bis auf Node-Strukturen
nur bei aktivem @{"Strukturmodus" LINK Struktur} anwählen. Wenn Sie, anstatt einen Menü-
punkt auszuwählen, die "Help"-Taste drücken, wird eine Hilfe angezeigt.


  @{u}@{b}Projekt-Menü@{ub}                                                    @{uu}

  · @{b}Iconifizeren@{ub}
    Diese Funktion schließt das Haupt-Fenster und öffnet dafür
    ein Piktogramm auf der Workbench, daß durch Doppelklick
    mit der Maus wieder durch das eigentliche Fenster getauscht
    werden kann.
    Dieses ist sehr nützlich um das XOpa-Fenster nicht immer
    offen halten zu müssen. Weiterhin wird es damit möglich,
    die Einstellungen der Workbench zu ändern ohne das Programm
    zu beenden und neu starten zu müssen.

  · @{b}Über...@{ub}
    Dieser Menüpunkt aktiviert den Anzeigemodus "Infos zu XOpa".
    In diesem wird unter anderem auf einige Dinge mit der Be-
    nutzung von XOpa hingewiesen.

  · @{b}Ende@{ub}
    Nach Anwahl dieses Menüpunktes wird das Programm ohne Sicher-
    heitsabfrage beendet (was auch sonst).



  @{u}@{b}Optionen-Menü@{ub}                                                   @{uu}

  · @{b}Speicher aufräumen@{ub}
    Bei Speichermangel bzw. wenn mehr Speicher als verfügbar
    angefordert wird, versucht das Betriebssystem unbenutzte
    Objekte zu entfernen um den freien Speicher zu vergrößern.
    Diese Funktion erzwingt eben diesen Vorgang.

  · @{b}Aktuelle Anzeige drucken@{ub}
    Wenn ein Drucker angeschlossen ist, wird auf diesem die
    aktuell angezeigte Liste ausgegeben.

  · @{b}Task&Fenster-Relationen@{ub}
    Wenn diese Funktion aktiv ist (siehe auch @{"ToolTypes" LINK ToolTypes}),
    versucht das Programm, wenn Sie ein Fenster oder Task
    schließen, das jeweilige Gegenstück gleich mit zu
    schließen.
    In der Praxis heißt das, daß, wenn Sie einen Task
    schließen, das Programm fragt, ob es die dem
    Task zugehörigen Fenster auch schließen soll und
    umgekehrt.
    Dies funktioniert nur, wenn festgestellt werden kann,
    welche Fenster zu einem Task gehören, was nicht immer
    der Fall ist.

  · @{b}Sicherheitsabfragen@{ub}
    Mit diesem Menüpunkt kann man einen Teil der vielleicht
    nervigen Sicherheitsabfragen an- oder abstellen.
    Siehe auch @{"ToolTypes" LINK ToolTypes}.



  @{u}@{b}Struktur-Menü@{ub}                                                   @{uu}

  · @{b}Andere Struktur@{ub}
    Dieser Menüpunkt ist nur im @{"Strukturmodus" LINK Struktur} benutzbar.
    Nach der Anwahl wird der Requester @{"«Andere Struktur»" LINK Requester 106} geöffnet,
    in dem Sie die aktuell dargestellte Struktur ändern können.

  · @{b}Node-Strukturen@{ub}
    Nach der Anwahl wird der Requester @{"«Node-Strukturen»" LINK Requester 83} geöffnet,
    in dem Sie die standardmäßig für bestimmte Node-Typen
    benutzten Strukturen einstellen können.

  · @{b}Zurück@{ub}
    Dieser Menüpunkt ist nur im @{"Strukturmodus" LINK Struktur} benutzbar.
    In diesem zeigt er, wenn möglich, die zuvor angezeigte Struktur
    an.



  @{u}@{b}Hilfe-Menü@{ub}                                                      @{uu}

  Dieses Menü erscheint nur, wenn Sie die AmigaGuide-Library installiert
  haben. Diese Library ist ab Version 3.0 im Lieferumfang des Betriebs-
  systems enthalten. Es ist jedoch eine Version für alle Betriebssystem-
  versionen als Public-Domain erhältlich.
  Falls nach Anwahl eines Menüpunktes ein Fehler angezeigt wird, über-
  prüfen Sie, ob sich die Datei "XOpa.guide" im Verzeichnis von XOpa
  befindet.

  · @{b}Allgemein@{ub}
    Nach Anwahl dieses Menüpunktes öffnet sich dieses AmigaGuide im
    @{"Hauptmenü" LINK Main}.

  · @{b}Kurzübersicht@{ub}
    Dieser Menüpunkt läßt das Kapitel @{"Kurzübersicht" LINK kurz} des Guides erscheinen.

  · @{b}Aktuelle Anzeige@{ub}
    Nach der Anwahl dieses Menüpunktes erscheint auch das AmigaGuide, allerdings
    versucht es, die Hilfe nach dem aktuellen @{"Anzeigemodus" LINK Anzeige} zu richten. Diese
    Funktion ist auch über die Taste "Help" zu erreichen.







@ENDNODE


@NODE über
@TITLE "XOpa-Dokumentation:  Über das Programm"

@{b}X. Über das Programm@{ub}
__ __      __ ______________________________
___\ \    / /
____\ \  / / ©©©  ©©©©   ©©©   Version 1.03
_____\ \/ / ©   © ©   © ©   ©     ________
______\  /  ©   © ©©©©  ©©©©©        _________
_____ /  \  ©   © ©     ©   ©           __________
____ / /\ \  ©©©  ©     ©   ©    ____________________
___ / /  \ \ ____________________________________________
__ /_/    \_\ _______________________________________


XOpa ist vollständig mit Kick-Pascal 2.12 der Maxon-Computer
GmbH programmiert worden.
Es läuft ab OS2.0 einwandfrei und wurde auf verschiedenen
Hardware-Plattformen erfolgreich getestet.
Neben dem Quellcode des Hauptprogrammes befinden sich noch
mehrere selbstgeschriebene Includes auf der Diskette, die 
für die OS3.0-Funktionen benötigt werden.
Diese Includes basieren auf den Original-Includes von Commodore.

Mit dem bereits verfügbaren MaxonPascal 3, bei dem die OS3.0-
Includes mitgeliefert werden, sind sie allerdings nicht mehr
notwendig.

Der meistens gut gegliederte Quellcode kann dadurch, daß er auch für
OS3.0 geschrieben wurde, als Beispiel für die Programmierung
der neuen Funktionen benutzt werden.

Seit der Version 1.00 wurden folgende Änderungen durchgeführt:

---------------- Version 1.01 vom 24.5.1994 -------------------
  · eine Hilfefunktion mittels AmigaGuide wurde integriert

---------------- Version 1.02 vom 9.6.1994 --------------------
  · der Add-Assign-Requester wurde erweitert (neues Gadget)
  · interne Programm- und Requesteraufräumarbeiten

---------------- Version 1.02 vom 10.6.1994 -------------------
  · kleiner Fehler in der Laderoutine (Kommentare) beseitigt
  · der Strukturmodus wurde um den "BPTR"-Typ erweitert

---------------- Version 1.02 vom 11.6.1994 -------------------
  · der Standard-Version-String wurde berichtigt
  · ein paar Tippfehler beseitigt
  · eine Menü-Hilfefunktion wurde hinzugefügt
  · nach dem Iconifizieren wird der Strukturmodus nicht mehr
    neu initialisiert (aktuelle Struktur wird beibehalten)

---------------- Version 1.02 vom 5.7.1994 --------------------
  · kleine Umstrukturierung im Quellcode
  · das Programm aktualisiert nun auch den Default-Font nach
    dem Iconifizieren (Listenfont wird geändert)

---------------- Version 1.03 vom 10.9.1994 -------------------
  · das Iconify-Icon wurde durch ein anderes ausgewechselt
  · dieses Icon ist in einem eigenen Chip-Data-Hunk mittels
    Assembler-Unterstützung untergebracht
  · "Zurück" im Strukturmodus merkt sich jetzt auch die
    Position der letzten Liste im ListView-Gadget

---------------- Version 1.03 vom 3.10.1994 -------------------
  · der ToolType "WINDOW" wurde hinzugefügt
  · Änderungen an Fehlertexten (Ciao Mädels...)


Alle gefundenen Fehler konnten beseitigt werden.
Falls Sie irgendwelche Erweiterungsvorschläge haben, oder
tatsächlich einen Fehler gefunden haben sollten, schreiben
Sie bitte an folgende Adresse:
                                Axel Dörfler
                                Heerstraße 53
                                D-49492 Westerkappeln

@ENDNODE

