{ToolManager

{Eine Erweiterung für die Amiga Workbench

{

{Version 2.0

{26 September 1992

Copyright © 1990-92 Stefan Becker

Diese Dokumentation darf kopiert und weitergegeben werden solange die Copyright-Notiz und diese Erlaubnis unverändert auf allen Kopien enthalten ist.

Es wird keine Garantie gegeben, daß die Programme, die in dieser Dokumentation beschrieben werden, 100%ig zuverlässig sind. Sie benutzen diese Programme auf eigene Gefahr. Der Autor kann auf keinen Fall für irgendwelche Schäden verantwortlich gemacht werden, die durch die Anwendung dieser Programme entstehen.

Das Paket ist “freely distributable”, aber das Copyright liegt weiterhin bei Stefan Becker. Dies bedeutet, daß es von jedem kopiert werden darf solange er nicht mehr als eine angemessene Kopiergebühr dafür verlangt. Diese Gebühr darf nicht höher sein als US $5 oder 5 DM.

Dieses Limit gilt auch für deutsche Public-Domain Händler!!

Dieses Paket darf in Public-Domain Sammlungen aufgenommen werden, insbesondere in Fred Fishs Amiga Disk Library (CD ROM Versionen dieser Sammlung eingeschlossen). Die Distributionsdatei darf in Mailboxsystemen oder auf FTP Servern abgelegt werden. Wenn Sie dieses Paket weitergeben wollen, dann müssen Sie die originale Distributionsdatei ‘ToolManager2_0.lha’ benutzen.

Weder die Programme noch der Quelltext (oder Teile davon) dürfen ohne eine schriftliche Genehmigung des Autors in kommerziellen Programmen benutzt werden.

Die Programme und der Quelltext (oder Teile davon) dürfen auf keinen Fall auf irgendeiner Maschine benutzt werden, die für die Forschung, Entwicklung, Konstruktion, Tests oder Produktion von Waffen oder anderen militärischen Gütern benutzt wird. Dies gilt natürlich auch für alle Maschinen, die für das Training von Personen in irgendeiner der obengenannten Tätigkeiten benutzt werden.

1 Wichtige Bemerkungen

Willkommen zur wundervollen Welt von ToolManager 2.0 :-)

• - ToolManager und seine Konzepte wurden drastisch verändert (see section Die Entwicklung von ToolManager) seit der letzten Version (1.5).
• - Beginnend mit der Version 2.0 ist ToolManager GiftWare. Wenn Ihnen dieses Programm gefällt und Sie es sehr oft benutzen, dann sollten Sie darüber nachdenken, ob sie dem Autor eine kleine Spende schicken um die Arbeit zu honorieren, die er in dieses Programm gesteckt hat. Ich schlage eine Spende in der Größenordnung von US $10-$20 oder 10-20 DM vor. Bitte schicken Sie mir außerhalb Europas keine Schecks, da es meistens mehr Geld kostet, diesen Scheck einzulösen, als überhaupt Geld darauf ist.

  Wenn Sie keine Spende schicken oder es sich nicht erlauben können, dann müssen sie sich nicht schuldig fühlen. Sie sollten mir aber trotzdem einen Brief schicken, wenn sie ToolManager benutzen (Ich liebe es Post zu bekommen :-). See section Wohin man Bug reports, Kommentare & Spenden schickt.

• - Benutzer von ToolManager 1.X können mit dem Kapitel über die Schnellinstallation beginnen (see section Wie man ToolManager 2.0 schnell installiert). Einige Merkmale haben sich nicht geändert und der Rest ist relativ einfach durch Ausprobieren herauszufinden. Für eine genaue Beschreibung des neuen Konzeptes und der neuen Merkmale schlagen sie bitte in dem Referenzteil dieser Dokumentation nach (see section Beschreibung der ToolManager-Objekte).

  Jede noch laufende ToolManager 1.X Version muss entfernt werden oder die neue Version wird nicht funktionieren. Die neue Version kann leider die Konfigurationsdatei der alten Version nicht lesen.

• - Erstbenutzer sollten die ganze Dokumentation lesen, um das Konzept und den Zweck des Programmes zu verstehen. Beginnen sie mit Was ist ToolManager?.
• - ToolManager 2.0 benutzt einige Merkmale der AmigaOS Version V38, die (hoffentlich) für alle Benutzer zugänglich ist zu dem Zeitpunkt, an dem sie dies hier lesen. Wenn sie noch die Version 2.0 benutzen (sie wird in dieser Dokumentation als V37 bezeichnet), dann brauchen sie keine Angst zu haben, denn ToolManager arbeitet auch ohne diese neue Version. Alle erweiterten V38 Merkmale sind in dieser Dokumentation markiert.

2 Wohin man Bug reports, Kommentare & Spenden schickt

Der Autor kann unter folgenden Adressen erreicht werden:

Postadresse:

     Stefan Becker
     Holsteinstrasse 9
5100 Aachen
     GERMANY

InterNet Electronic Mail:

stefanb@pool.informatik.rwth-aachen.de

3 Wie man ToolManager 2.0 schnell installiert

Die grundlegende ToolManager 2.0 Installation besteht aus den folgenden vier Teilen:

‘Libs/toolmanager.library’ ⇒ ‘LIBS:’

Dies ist das Hauptprogramm von ToolManager. Es verwaltet alle Programme, Menüs, Piktogramme und Docks (see section Die ToolManager shared library Schnittstelle).

‘Prefs/ToolManager*’ ⇒ ‘SYS:Prefs’

Dies ist der Voreinsteller für die Konfiguration (see section Der Voreinsteller für ToolManager).

‘WBStartup/ToolManager*’ ⇒ ‘SYS:WBStartup’

Mit diesem Hilfsprogramm kann ToolManager gestartet und gestoppt werden. Wenn es in der WBStartup Schublade liegt, dann wird ToolManager immer automatisch beim Starten der Maschine geladen.

‘L/WBStart-Handler’ ⇒ ‘L:’

Dieses Programm startet Programme mit der Workbench-Startmethode. Es ist ein eigener Prozess, so daß man ToolManager auch dann noch verlassen kann, wenn man Workbenchprogramme gestartet hat.

4 Was ist ToolManager?

ToolManager ist ein flexibles Programm zur Verwaltung von Hilfsprogrammen in Ihrer Arbeitsumgebung. Es kann sowohl Workbench- oder CLI-Programme starten als auch ARexx-Skripte ausführen. Die Benutzeroberfläche besteht aus Menüs, Piktogrammen und Dock-Fenstern. Wenn Sie einen lauten Computer mögen, dann können Sie zu jedem dieser Dinge einen Ton hinzufügen. See section Tonobjekte.

ToolManger kann Einträge zu dem Workbench Tools Menü hinzufügen. Wenn Sie einen dieser Einträge auswählen, dann wird das dazugehörige Programm gestartet. Jedes Piktogramm, das zu diesem Zeitpunkt auf der Workbench ausgewählt ist, wird als Argument für dieses Programm benutzt. Menüeinträge sind nur dann möglich, wenn die Workbench läuft. See section Menüobjekte.

ToolManager kann Piktogramme zum Workbench-Fenster hinzufügen. Falls Sie ein solches Piktogramm doppelklicken, dann wird das dazugehörige Programm gestartet. Wenn Sie einige Piktogramme auf dieses Piktogramm schieben, dann wird das Programm mit diesen Piktogrammen als Argumenten gestartet. Piktogramme sind nur dann möglich, wenn die Workbench läuft. See section Piktogrammobjekte.

ToolManager kann ein Dock-Fenster aus einer Zusammenfassung von Programmen erstellen. Dieses Fenster kann auf jedem öffentlichen Schirm geöffnet werden. Jedes Programm wird durch ein Bild oder ein Textgadget repräsentiert. Um ein Programm zu starten brauchen Sie nur auf das Bild oder das Textgadget zu klicken. Falls das Fenster auf der Workbench geöffnet wurde und die Workbench läuft, dann können Sie auch einige Piktogramme auf das Bild oder das Textgadget schieben, um das Programm mit Argumenten zu starten. See section Dock-Objekte.

Weiterhin können Sie jedem Programm einen Tastenbefehl zuweisen. Wenn Sie diesen Tastenbefehl benutzen, dann wird das Programm gestartet. Beachten Sie dabei, daß in diesem Fall keine Argumente an das Programm übergeben werden können. See section Programmobjekte.

5 Die Konzepte hinter ToolManager

ToolManager 2.0 benutzt einen neuen objektorientierten Ansatz um ein flexibles und erweiterbares System zu ermöglichen. Dieser Ansatz machte viele Verbesserungen an den ToolManager 1.X Merkmalen möglich, z.B. man kann jetzt mehrere Dock-Fenster haben.

Ein Objekt ist eine Zusammenfassung von Daten, die seine Merkmale beschreiben. Jedes Objekt hat einen Namen und einen Typ. Sie können von jedem Typ so viele Objekte erzeugen wie sie möchten, allerdings muß der Name jedes Objektes eindeutig sein, da er dazu benutzt wird um das Objekt anzusprechen.

Momentan gibt es sechs verschiedene Objekttypen: Programm, Bild, Ton, Menü, Piktogramm und Dock. Die ersten drei Typen sind einfache Objekte, d.h. sie verweisen auf keine anderen Objekte. Sie stellen den komplexen Objekten Daten oder Dienste zur Verfügung.

Die letzten drei Typen sind komplexe Objekte, d.h. sie verweisen auf einfache Objekte und benötigen deren Daten oder Dienste. Der Verweis geschieht aufgrund des Namens und falls kein einfaches Objekt mit diesem Namen existiert, dann ignoriert das komplexe Objekt es. Beachten Sie dabei, daß dies die Funktionalität des komplexen Objektes beeinträchtigen kann, z.B. benötigt ein Piktogrammobjekt die Daten eines Bildobjekts, anderenfalls wird es kein Piktogramm erzeugen.

Für eine detailierte Beschreibung aller Objektparameter siehe Beschreibung der ToolManager-Objekte.

6 Beschreibungen für alle Dateien in der Distribution

Die ToolManager 2.0 Distribution besteht aus mehreren Verzeichnissen, die alle weiter unten erläutert werden.

6.1 Das Docs Verzeichnis

Dieses Verzeichnis enthält die Dokumentation für ToolManager. Die Dokumentation ist in vier verschiedenen Formaten und verschiedenen Sprachen vorhanden. Weiterhin existiert eine Datei in dem AutoDoc-Format, die die ToolManager shared library Schnittstelle beschreibt.

Prefix ‘TM_<Sprache>’

Diese Datei enthält die Dokumentation in der angegebenen Sprache. Momentan sind folgende Sprachen vorhanden: Deutsch, English, Svenska.

Postfix ‘.doc’

Diese Datei enthält die Dokumentation als einfacher ASCII-Text.

Postfix ‘.dvi’

Diese Datei enthält die Dokumentation in TeXs DVI-Format. Um daraus eine gedruckte Dokumentation zu erstellen, müssen sie diese Datei durch einen TeX Druckertreiber schicken.

Postfix ‘.guide’

Diese Datei enthält die Dokumentation im AmigaGuide-Format. Obwohl dieses Format nur aus einfachem ASCII-Text mit ein paar Befehlen besteht, benötigen Sie AmigaGuide um die Hypertext Verkettungen nutzen zu können. Der Autor hofft, daß AmigaGuide bald allen Amiga-Besitzern zur Verfügung steht.

Postfix ‘.tex’

Diese Datei enthält die Dokumentation im Texinfo-Format. Dieses Format wurde von der Free Software Foundation (FSF) erfunden. Zusammen mit dem ‘texinfo.tex’ Makropaket können sie TeX und ‘texindex’ benutzen, um eine Datei im DVI-Format zu erstellen (siehe oben).

‘toolmanager.doc’

Diese Datei beschreibt die ToolManager shared library Schnittstelle im AutoDoc-Format.

6.2 Das Goodies Verzeichnis

Dieses Verzeichnis enthält zusätzliche Programmpakete, die nützlich für ToolManager sind.

‘GetPubName.lha’

Dieses kleine Programm gibt den Namen des obersten öffentlichen Schirms auf die Standardausgabe oder in eine Umgebungsvariable aus. Es wurde geschrieben von Michael “Mick” Hohmann.

‘upd1_20.lha’

Das Programm upd wurde geschrieben von Jonas Petersson. Es ist ein kleines Program, daß einen ARexx-Port öffnet und auf Befehle wartet. Mit Hilfe von ARexx können Sie upd veranlassen digitalisierte Töne und Geräusche abzuspielen. ToolManager benutzt diese Eigenschaft um seine Tonobjekte zu realisieren. See section Tonobjekte.

ToolManager 1.5 Benutzer mögen sich wundern, wo das Hilfsprogramm DeleteTool geblieben ist. Es kann durch das Program BlackHole von der Fish Disk #622 ersetzt werden.

6.3 Das Graphics Verzeichnis

Dieses Verzeichnis enthält eine reichhaltige Sammlung von Bildern aus denen Sie wählen können. Laden Sie sie einfach als Bildobjekte in ToolManager (see section Bildobjekte).

Die Dateien wurden von verschiedenen Personen zur Verfügung gestellt (see section Der Autor möchte danken…). Jeder von ihnen hat ein eigenes Unterverzeichnis erhalten. Da diese Dateien von verschieden Personen erstellt wurden, stammen sie aus verschiedenen Umgebungen (Farbpalette, Tiefe, Auflösung, Größe) und haben unterschiedliche Desginstile. Es kann also durchaus vorkommen, daß sie nicht gut auf Ihrer Maschine aussehen.

Damit man die unterschiedlichen Formate, die von ToolManager unterstützt werden, unterscheiden kann, hat jeder Dateiname einen speziellen Postfix:

‘.anmb’

Dies ist eine IFF ANIM Datei, die von einem Mal- oder Animationsprogramm erstellt wurde. Sie kann mehrere Bilder enthalten. Obwohl ToolManager komplette ANIM Dateien laden kann, sollten sie eine ähnliche Funktion wie DPaints “AnimBrush” benutzen, um den interessanten Teil aus der Animation herauszuschneiden.

‘.brush’

Dies ist eine IFF ILBM Datei, die von einem Malprogramm erzeugt wurde. Sie enthält nur ein Bild.

‘.info’

Dies ist eine normale Amiga Piktogrammdatei, die durch IconEdit (oder etwas ähnliches) erzeugt wurde. Sie kann zwei Bilder enthalten.

6.4 Das L Verzeichnis

Dieses Verzeichnis enthält nur eine Datei, nämlich ‘WBStart-Handler’. Sie müssen diese Datei in das ‘L:’ Verzeichnis kopieren, sonst kann ToolManager keine Programmobjekte mit der Workbench-Startmethode starten (see section Programmobjekte).

Das komplette WBStart 1.2 Paket wird auf einer Fish Disk erscheinen.

6.5 Das Libs Verzeichnis

Dieses Verzeichnis enthält nur eine Datei, ‘toolmanager.library’. Dies ist das Hauptprogramm von ToolManager und muß in das ‘LIBS:’ Verzeichnis kopiert werden.

6.6 Das Locale Verzeichnis

Dieses Verzeichnis enthält alle Dateien für die Lokalisation von ToolManager. Da die locale.library erst in V38 enthalten ist, brauchen Sie keine dieser Dateien zu kopieren, falls sie noch V37 benutzen. Wenn Sie schon V38 benutzen, dann wählen Sie die Ihrer Sprache entsprechende Datei.

‘Catalogs/<Sprache>/toolmanager.catalog’

Dies ist eine Übersetzungsdatei für die angegebene Sprache. Kopieren Sie die Datei für Ihre Sprache in das Verzeichnis ‘LOCALE:Catalogs/<Sprache>’.

‘Languages/<Sprache>.language’

Einige Sprachen werden noch nicht unterstützt von der Standard V38 Locale Distribution. Daher haben einige Übersetzer eine ‘.language’ Datei mitgeliefert, damit ToolManager ihre Übersetzungsdateien benutzen kann. Kopieren Sie die Datei für Ihre Sprache in das Verzeichnis ‘LOCALE:Languages’. Es sind folgende zusätzlichen Sprachen verfügbar: Finnish (suomi), Eefeler Platt (eifel).

6.7 Das Prefs Verzeichnis

Der ToolManager Voreinsteller und sein Icon befinden sich in diesem Verzeichnis. Kopieren Sie beide Dateien in das Verzeichnis ‘SYS:Prefs’. Für weitere Informationen siehe Der Voreinsteller für ToolManager.

6.8 Das Programmers Verzeichnis

Dieses Verzeichnis enthält alle Dateien, die von den verschiedenen Programmiersprachen und deren Compilern benötigt werden, um die ToolManager shared library Schnittstelle zu benutzen. Das Unterverzeichnis ‘examples’ enthält mehrere Beispiele dazu. Für eine komplette Beschreibung der Schnittstelle lesen Sie bitte die Datei ‘Docs/toolmanager.doc’.

Momentan werden die folgenden Sprachen bzw. Compiler unterstützt: AmigaOberon, DICE C, M2Amiga Modula, MANX Aztec C and SAS C.

6.9 Das Scripts Verzeichnis

Dieses Verzeichnis enthält eine Sammlung von ARexx- und Shell-Skripten, die in ToolManager Programmobjekten benutzt werden können. Beachen Sie, daß diese Skriptdateien an Ihre persönliche Arbeitsumgebung oder Shell angepasst werden müssen.

6.10 Das Source Verzeichnis

Dieses Verzeichnis enthält den kompletten Quelltext zu ToolManager 2.0 und seinen Hilfsprogrammen. Jedes Programm hat sein eigenes Unterverzeichnis. Der Autor stellt den Quelltext als Beispiel für die Programmierung unter OS 2.0 zur Verfügung.

Das Unterverzeichnis ‘locale’ ist für Übersetzer interessant. Falls Ihre Sprache in dieser Version nicht unterstützt wird und Sie eine Übersetzung machen möchten, dann sollten Sie sich die Datei ‘empty.ct’ anschauen. Sie müssen nur die Leerzeilen füllen und die Datei zu mir senden. Die Übersetzung wird dann eventuell in der nächsten Version enthalten sein.

6.11 Das WBStartup Verzeichnis

Dieses Verzeichnis enthält nur ein Programm: ToolManager. Dieses Hilfsprogramm startet und stoppt ToolManager 2.0. Meistens wird dieses Programm in das Verzeichnis ‘SYS:WBStartup’ kopiert, aber man kann es auch von der Shell aus benutzen.

7 Beschreibung der ToolManager-Objekte

Dieses Kapitel beschreibt die ToolManager-Objekte im einzelnen. Jedes Objekt hat einen Typ und einen Namen. Der Name wird benutzt, um das Objekt anzusprechen. Es gibt sechs verschiedene Typen von Objekten:

7.1 Programmobjekte

Programmobjekte beschreiben Programme, die von ToolManager gestartet werden sollen. Es werden drei verschiedene Typen von Programmen unterstützt: CLI, Workbench und ARexx. Jedes Programmobjekt hat die folgenden Parameter. Die Vorgabewerte sind in Klammern gesetzt:

Aktuelles Verzeichnis (‘SYS:’)

Der Name des aktuellen Verzeichnisses für das Programm. ARexx-Programme ignorieren diesen Parameter.

Argumente (Ja)

Dieser Schalter kontrolliert die Argumentübergabe an das Programm. Falls ein Programm keine Argumente annimmt oder sie nicht benötigt, dann können Sie hiermit die Argumentübergabe abschalten.

Ausgabedatei (‘NIL:’)

Der Dateiname für die Ausgabedatei. Dieser Parameter ist nur sinnvoll für CLI Programme.

Befehl

Der Dateiname für das zu startende Programm. Der Name kann relativ zum aktuellen Verzeichnis sein.

Befehlspfad (Pfad des ToolManager-Prozesses)

Dieser Parameter setzt den Befehlspfad für das Programm. Es können mehrere Verzeichnisse angegeben werden in dem man sie mit “;” trennt. Dieser Parameter ist nur sinnvoll für CLI Programme.

Nach vorne (Nein)

Wenn dieser Parameter gesetzt ist, dann wird der mit Öffentlicher Schirm angegebene öffentliche Schirm nach vorne geholt, bevor das Programm gestartet wird.

Öffentlicher Schirm (Default)

Sie können mit diesem Parameter angeben, welcher öffentlicher Schirm nach vorne geholt werden soll, bevor das Programm gestartet wird. Dieser Parameter funktioniert nur im Zusammenhang mit Nach vorne.

Priorität (0)

Dieser Parameter setzt die Priorität des neuen Prozesses, in dem das Programm läuft.

Programmtyp (CLI)

Dies gibt den Typ des Programmes an. Es kann einer der drei folgenden Typen angegeben werden: CLI, WB oder ARexx.

Stack (4096)

Dieser Parameter setzt die Stackgröße des neuen Prozesses, in dem das Programm läuft.

Tastenbefehl

Sie können für jedes Programmobjekt einen Tastenbefehl angeben. Wenn Sie diesen Tastenbefehl benutzen wird das Programm gestartet. Beachten Sie: Das Programm wird ohne Argumente gestartet.

Verzögerung (0)

Nach der Aktivierung eines Programmobjekts wartet ToolManager Verzögerung Sekunden bevor er das Programm startet. Wenn dieser Wert negativ ist, dann wird das Programm alle Verzögerung Sekunden gestartet. Falls Sie ein Programmobjekt stoppen wollen, das auf die Ausführung wartet, aktivieren Sie es einfach noch einmal. Beachten Sie: Wenn Verzögerung gesetzt ist, dann wird das Programm ohne Argumente gestartet.

7.2 Bildobjekte

Bildobjekte geben die Bilddaten an, die von ToolManager für Piktogramme und Dock-Fenster benutzt werden. Dieser Objekttyp hat nur einen Parameter:

Dateiname

Dieser Parameter gibt den Namen der Datei an, aus der ToolManager die Bilddaten lesen soll. ToolManager versucht den Typ der Bilddaten automatisch zu erkennen:

1. Er versucht die Daten als IFF Daten zu laden. Momentan kann ToolManager ILBM (ein Bild) oder ANIM (zwei oder mehr Bilder) Dateien lesen.
2. Er versucht die Datei als Piktogrammdatei zu lesen. Ein Piktogramm kann ein oder zwei Bilder enthalten.

Animation werden momentan nur von Dock-Objekten unterstützt. Piktogrammobjekte entnehmen momentan nur das erste und das zweite Bild einer Animation um ein Piktogramm aus 2 Bildern zu erstellen. Wenn Sie eine Animation für ToolManager erstellen wollen, dann sollten Sie sich an folgende Regeln halten:

Bild 1

Dieses Bild sollte den inaktiven Zustand repräsentieren.

Bild 2

Dieses Bild sollte den selektierten Zustand repräsentieren. Normalerweise ist es eine invertierte Kopie des ersten Bildes.

Bild 3 bis N-1

Dies sind die Bilder der eigentlichen Animation. Jedes Bild wird für eine 1/3 Sekunde angezeigt.

Bild N

Das letzte Bild der Animation wird für eine Sekunde angezeigt. Danach wird wieder das erste Bild angezeigt.

7.3 Tonobjekte

Ein Tonobjekt wird benutzt, wenn ToolManager laut werden soll. ToolManager hat selber keinen eingebauten Spieler für digitalisierte Geräusche. Er benutzt ARexx, um einen externen Geräuscheabspieler anzusteuern. Dieser Objekttyp hat zwei Parameter:

Befehl

Dieser Parameter gibt den ARexx-Befehl an, den ToolManager an den externen Geräuscheabspieler senden soll. Für upd könnte dies etwas ähnliches wie file samples:boing sein, was upd anweist die IFF Datei ‘samples:boing’ abzuspielen. See section Das Goodies Verzeichnis.

ARexx-Port

Dieser Parameter gibt den Namen des ARexx-Ports an, an den ToolManager Befehl senden soll. Der voreingestellte Name ist PLAY, der Name für das Programm upd.

7.4 Menüobjekte

Menüobjekte erzeugen Menüeinträge im Workbench Tools Menü. Der Objektname wird benutzt als Menütext. Um ein solches Objekt zu aktivieren müssen Sie einfach den entsprechenden Menüeintrag selektieren. Menüobjekte sind nur verfügbar wenn die Workbench läuft.

Dieser Objekttyp hat zwei Parameter:

Programmobjekt

Dies ist der Name eines Programmobjektes, das aktiviert werden soll, wenn der Menüeintrag selektiert wurde. Jedes Piktogramm, das zu diesem Zeitpunkt ausgewählt ist, wird als Argument für das Programm benutzt.

Tonobjekt

Dies ist der Name eines Tonobjekts, das aktiviert werden soll, wenn der Menüeintrag selektiert wurde.

ToolManager 1.X Benutzer: Wenn Sie den alten Tooltyp “Dummy” simulieren wollen, dann erzeugen Sie einfach eine Menüobjekt und geben kein Programm- oder Tonobjekt an.

7.5 Piktogrammobjekte

Piktogrammobjekte beschreiben Applikationspiktogramme im Workbench-Fenster. Solch ein Objekt kann aktiviert werden durch Doppelklicken des Piktogramms oder indem einige Piktogramme auf das Applikationspiktogramm geschoben werden. Piktogrammobjekte sind nur verfügbar wenn die Workbench läuft.

Die Parameter für diesen Objekttyp sind wie folgt:

Bildobjekt

Dies ist der Name eines Bildobjekts. Die Bilddaten dieses Objektes werden dazu benutzt das Applikationspiktogramm zu erstellen.

Linke Kante (Vorgabe: 0)

Dies setzt die linke Kante für das Applikationspiktogramm.

Obere Kante (Vorgabe: 0)

Dies setzt die obere Kante für das Applikationspiktogramm.

Programmobjekt

Dies ist der Name eines Programmobjektes, das aktiviert werden soll wenn das Piktogramm selektiert wurde. Jedes Piktogramm, das auf das Applikationspiktogramm geschoben wurde, wird als Argument für das Programm benutzt.

Tonobjekt

Dies ist der Name eines Tonobjekts, das aktiviert werden soll wenn das Piktogramm selektiertiert wurde.

Zeige Namen (Vorgabe: Ja)

Wenn dieser Parameter gesetzt ist, dann wird der Objektname als Namen für das Applikationspiktogramm benutzt.

Die Workbench ist sehr eigensinnig mit Piktogrammpositionen. Wenn Sie eine Position gewählt haben, die der Workbench nicht zusagen, dann ignoriert sie sie einfach und legt das Piktogramm irgendwo anders hin.

7.6 Dock-Objekte

Dock-Objekte beschreiben Fenster. Diese Fenster fassen mehrere Programme zusammen, welche durch Bilder oder Textgadgets repräsentiert werden. Um ein Programm zu starten, braucht man nur auf das Bild oder das Textgadget zu klicken. Natürlich können auch Piktogramme auf das Bild oder das Textgadget geschoben werden, um das Programm mit Argumenten zu versorgen.

Jedes Dock-Objekt hat die folgenden Parameter. Die Vorgaben sind in Klammern gesetzt:

Aktiviert (Ja)

Ein Dock-Fenster kann aktiv (offen) oder nicht aktiv (geschlossen) sein.

Fensternamen

Dieser Parameter setzt den Namen des Dock-Fensters. Wenn Sie einen Fensternamen angeben, dann öffnet sich eine normales OS 2.0 Fenster mit Dragbar, Close-Gadget, Depth-Gadget und einem Rand. Wenn Sie keinen Namen angeben, dann öffnet sich ein Fenster, das keinen Rahmen und nur einen Dragbar hat.

Linke Kante (0)

Linke Kante des Dock-Fensters. Dieser Parameter wird ignoriert, wenn der Parameter Zentriert gesetzt ist.

Menü (No)

An jedes Dock-Fenster kann ein Menü angehängt werden. Dieses Menü hat zwei Einträge:

• Dock schliessen Schliessen des Dock-Fensters.
• TM beenden ToolManager beenden.

Muster (Nein)

Das Dock-Fenster richtet sich automatisch nach der Grösse des größten Bildes. Da jeder Eintrag die gleiche Grösse hat und kleinere Bilder zentriert werden, haben kleinere Bilder einen leeren Rand. Falls Sie diesen Rand nicht mögen, dann können Sie mit diesem Parameter ein Muster einschalten.

Obere Kante (0)

Obere Kante des Dock-Fensters. Dieser Parameter wird ignoriert, wenn der Parameter Zentriert gesetzt ist.

Öffentlicher Schirm (Default)

Dies gibt den öffentlichen Schirm an, auf dem das Dock-Fenster geöffnet werden soll. Wenn das Fenster mit Hilfe des Tastenbefehls geöffnet wurde, dann wird der öffentliche Schirm nach vorne geholt. Dieser Parameter wird ignoriert, wenn der Parameter Vorderster gesetzt ist.

PopUp (No)

Wenn dieser Parameter gesetzt ist, dann schliesst sich das Dock-Fenster automatisch, nachdem ein Eintrag ausgewählt wurde. Dieser Parameter ist besonders nützlich in Verbindung mit den Parametern Vorderster, Zentriert und einem Tastenbefehl der Klasse rawmouse (see section Wie man einen Tastenbefehl definiert).

Spalte (1)

Dieser Parameter setzt die Anzahl der Spalten in dem Dock-Fenster. Die Einträge werden zeilenweise einsortiert, beginnend mit der linken Spalte und fortlaufend bis zur rechten Spalte.

Tastenbefehl

Sie können für jedes Dock-Objekt einen Tastenbefehl angeben. Wenn Sie diesen Tastenbefehl benutzen, dann wird der Status des Dock-Fensters umgeschaltet, d.h. es wird geöffnet oder geschlossen.

Text (Nein)

Mit diesem Parameter können Sie zwischen Bildern und Textgadgets in Dock-Fenstern wählen. Dock-Fenster mit Textgadgets sind besonders nützlich in Verbindung mit dem Parameter PopUp.

Vertikal (No)

Dieser Parameter setzt die Richtung der Dragbar. Dieser Parameter wird ignoriert, wenn Sie einen Fensternamen mit dem Parameter Fensternamen angegeben haben.

Vorderster (Nein)

Wenn dieser Parameter gesetzt ist, dann öffnet sich das Dock-Fenster immer auf dem vordersten öffentlichen Schirm.

Zeichensatz (Zeichensatz des Schirms)

Wenn in einem Dock-Objekt der Parameter Text gesetzt ist, dann kann mit diesem Parameter der Zeichensatz für die Textgadgets gewählt werden.

Zentriert (Nein)

Wenn dieser Parameter gesetzt ist, dann wird das Dock-Fenster immer zentriert zur aktuellen Mausposition geöffnet.

8 Der Voreinsteller für ToolManager

Mit dem Voreinsteller können Sie die globale Konfiguration von ToolManager manipulieren. Diese Konfiguration wird automatisch beim Start von ToolManager geladen. Um den Voreinsteller zu starten, müssen Sie sein Piktogramm doppelklicken. Danach öffnet sich das Hauptfenster.

8.1 Gadgets im Hauptfenster

Das Hauptfenster hat mehrere Gruppen von Gadgets:

Objekttyp

Mit diesem zyklischem Auswahlgadget kann der Typ der Objekte gewählt werden, die Sie erzeugen oder ändern wollen.

Objektliste

Dieses Gadget zeigt die Liste aller Objekte des aktuellen Typs an. Sie können ein Objekt auswählen indem sie auf seinen Namen klicken. Wenn sie einen Eintrag doppelklicken, dann öffnet sich das Objektfenster.

Objekt verschieben

Wenn ein Objekt ausgewählt worden ist, dann kann es mit diesen Gadgets in der Liste verschoben werden. Das Sortieren Gadget dient dazu, die Liste alphabetisch zu sortieren.

Objekt manipulieren

Diese Gadgets manipulieren Objekte. Das Neu Gadget erzeugt ein neues Gadget vom aktuellen Typ. Dieses neue Objekt wird automatisch selektiert. Das Ändern Gadget öffnet das Objektfenster. Mit dem Kopieren Gadget kann man eine Kopie des selektierten Objektes erstellen. Das Entfernen Gadget löscht das selektierte Objekt.

Konfiguration

Sie haben mehrere Möglichkeiten die Konfiguration zu speichern. Mit dem Speichern Gadget wird die Konfiguration permanent in der Datei ‘ENVARC:ToolManager.prefs’ gespeichert. Für eine temporäre Änderung kann die Konfiguration mit dem Benutzen Gadget in der Datei ‘ENV:ToolManager.prefs’ abgespeichert werden. Diese Datei wird bei einem Reset gelöscht. Wenn Sie eine Konfiguration testen wollen, ohne den Voreinsteller zu verlassen, dann benutzen Sie das Testen Gadget. Mit dem Abbrechen Gadget können Sie den Voreinsteller ohne Abspeichern verlassen.

8.2 Menüs des Hauptfensters

Das Hauptfenster hat mehrere Menüs:

Project

Mit den Menüeinträgen öffnen und speichern als können Sie die Konfiguration laden und speichern. Der Information Eintrag öffnet einen Informationsrequester. Mit dem Eintrag beenden kann man den Voreinsteller ohne Abspeichern verlassen.

Vorgaben

Mit diesen Menüeinträgen können ältere Konfigurationen wiederhergestellt werden. Der Eintrag auf zuletzt gespeichertes lädt die Konfiguration aus der Datei ‘ENVARC:ToolManager.prefs’. Mit dem Eintrag auf vorherigen Stand wird diejenige Konfiguration, die vor dem Start des Voreinstellers gültig war, aus der Datei ‘ENV:ToolManager.prefs’ geladen.

Optionen

Mit dem Eintrag Piktogramme erzeugen? können Sie vorgeben, ob der Eintrag speichern als ein Piktogramm erzeugen soll oder nicht.

8.3 Objektfenster

Jeder Objekttyp hat ein eigenes Objektfenster, in dem man die Objektparameter setzen kann. Für eine detailierte Liste aller Parameter siehe Beschreibung der ToolManager-Objekte.

Jedes Objektfenster hat ein Gadget für den Objektnamen. Dieser Name ist wichtig, da er dazu benutzt wird das Objekt anzusprechen. Beachten Sie, daß es keine Querverweise gibt, d.h. wenn Sie den Namen eines Objektes ändern, das schon von einem anderen Objekt verwendet wird, so wird der Verweis in diesem Objekt nicht aktualisiert. Sie müssen diesen Verweis per Hand aktualisieren.

Die Tastengadgets in den Objektfenstern öffnen verschiedene Requester. Sie können einen Eintrag auswählen, indem sie den Namen und das Benutzen Gadget anklicken oder indem sie den Namen doppelklicken. Um einen Requester ohne Änderungen zu verlassen, benutzen Sie das Abbrechen Gadget. Wenn sie ein Feld löschen wollen, das nur mit einem Requester ausgewählt werden kann, dann öffnen Sie den Requester und klicken das Benutzen Gadget ohne vorher einen Eintrag auszuwählen.

Die Objekfenster für Programm- und Bildobjekte haben ein zusätzliches Merkmal. Sie können ein Piktogramm auf diese Fenster schieben und die Parameter werden aus diesem Piktogramm entnommen.

8.4 Tooltypes

Wenn Sie den Voreinsteller von der Workbench starten, dann können Sie in den Piktogrammen für das Programm oder den Konfigurationsdateien verschiedene Tooltypes setzen, um den Voreinsteller zu kontrollieren.

USE

Wenn Sie diesen Tooltype in einem Piktogramm für eine Konfigurationsdatei setzen, dann installiert der Voreinsteller diese Datei als aktuelle Konfiguration.

SAVE

Wenn Sie diesen Tooltype in einem Piktogramm für eine Konfigurationsdatei setzen, dann installiert der Voreinsteller diese Datei als aktuelle und permanente Konfiguration.

PUBSCREEN

Dieser Tooltype gibt den Namen des öffentlichen Schirms an, auf dem der Voreinsteller seine Fenster öffnen soll.

CREATEICONS

Wenn dieser Tooltype auf YES gesetzt wird, dann erzeugt der Voreinsteller für jede Konfigurationsdatei, die mit dem Menüeintrag speichern als erzeugt wird, ein Piktogramm.

DEFAULTFONT

Normalerweise benutzt der Voreinsteller den Zeichensatz des öffentlichen Schirms um seine Gadgets zu erzeugen. Wenn Sie diesen Tooltype auf YES setzen, dann benutzt der Voreinsteller den Standard Systemzeichensatz.

8.5 CLI Argumente

Wenn der Voreinsteller von der Shell gestartet wird, dann benutzt er folgende Schablone für die Kommandozeile:

FROM,EDIT/S,USE/S,SAVE/S,PUBSCREEN/K,DEFAULTFONT/S

FROM

Dieser Parameter gibt an, welche Konfigurationsdatei der Voreinsteller laden soll.

USE

Wenn Sie diesen Parameter benutzen, dann installiert der Voreinsteller die Datei, die mit dem FROM Parameter angegeben wurde, als aktuelle Konfiguration.

SAVE

Wenn Sie diesen Parameter benutzen, dann installiert der Voreinsteller die Datei, die mit dem FROM Parameter angegeben wurde, als aktuelle und permante Konfiguration.

PUBSCREEN

Dieser Parameter gibt den Namen des öffentlichen Schirms an, auf dem der Voreinsteller seine Fenster öffnen soll.

DEFAULTFONT

Normalerweise benutzt der Voreinsteller den Zeichensatz des öffentlichen Schirms um seine Gadgets zu erzeugen. Wenn Sie diesen Parameter angeben, dann benutzt der Voreinsteller den Standard Systemzeichensatz.

9 Die ToolManager shared library Schnittstelle

Der ToolManager-Handler ist in eine Amiga shared library eingebettet. Diese Library bietet mehrere Funktionen an, um ToolManager-Objekte zu erzeugen und zu manipulieren, so daß Sie sie von Ihren Programmen aus benutzen können.

Momentan sind 6 Funktionen vorhanden:

AllocTMHandle()

Damit Sie ToolManager-Objekte erzeugen können, müssen Sie zuerst einen TMHandle allozieren. Diese Datenstruktur speichert alle Informationen über Ihre Objekte und sie wird dazu benutzt Ihre Objekte anzusprechen. Beachten Sie, daß die Information, die in dieser Datenstruktur gespeichert ist, nur dem Programm zugänglich ist, das den TMHandle erzeugt hat.

FreeTMHandle()

Diese Funktion gibt einen TMHandle und alle mit ihm verbundenen ToolManager-Objekte frei. Jeder AllocTMHandle() Aufruf muß mit einem FreeTMHandle() Aufruf gepaart sein!

CreateTMObjectTags()

CreateTMObjectTagList()

Diese Funktion erzeugt ein ToolManager-Objekt. Sie müssen einen Namen, den Objekttyp und verschiedene Tags für die Objektparameter angeben. Der Name des Objekts ist wichtig, da er dazu benutzt wird, das Objekt anzusprechen.

ChangeTMObjectTags()

ChangeTMObjectTagList()

Sie können die Parameter eines ToolManager-Objekts mit dieser Funktion verändern. Beachten Sie, daß Bildobjekte momentan nicht geändert werden können.

DeleteTMObject()

Diese Funktion löscht ein ToolManager-Objekt. Falls andere Objekte auf dieses Objekt verweisen, dann werden diese benachrichtigt, damit sie ihren Status erneuern könen.

QuitToolManager()

Diese Funktion teilt dem ToolManager-Handler mit, daß er so bald wie möglich stoppen sollte.

Die komplette Library Schnittstellenbeschreibung ist im AutoDoc-Format vorhanden (see section Dokumentation).

10 Wie man einen Tastenbefehl definiert

Diese Kapitel beschreibt wie man einen Tastenbefehl als einen Input Description String definiert, der dann von Commodities ausgewertet werden kann. Jedes Mal, wenn ein Tastenbefehl ausgeführt wird, erzeugt Commodities eine Ereignis, das dann von ToolManager dazu benutzt wird Programmobjekte zu aktivieren oder Dock-Objekte umzuschalten. Ein Description String hat die folgende Syntax:

[<Klasse>] {[-][<Qualifier>]} [-][upstroke] [<Tastenkode>]

Alle Befehlsworte können groß oder klein geschrieben werden.

Klasse beschreibt die InputEvent-Klasse. Dieser Parameter ist optional und falls er weggelassen wird, dann wird die Vorgabe rawkey benutzt. See section InputEvent-Klassen.

Qualifier sind “Signale”, die gesetzt oder nicht gesetzt sein müssen zu dem Zeitpunkt, an dem der Tastenbefehl ausgeführt wird, sonst wird kein Ereignis erzeugt. Für jeden Qualifier, der gesetzt sein soll, müssen Sie das Befehlswort angeben. Alle anderen Qualifier müssen dann nicht gesetzt sein. Falls Sie einen Qualifier ignorieren wollen, dann setzen sie ein - vor sein Befehlswort. See section Qualifier.

Normalerweise wird ein Ereignis erzeugt, wenn eine Taste gedrückt wird. Falls das Ereignis generiert werden soll wenn die Taste losgelassen wird, dann müssen Sie das Befehlswort upstroke angeben. Wenn sowohl beim Drücken als auch beim Loslassen der Taste ein Ereignis erzeugt werden soll, dann müssen sie das Befehlswort -upstroke angeben.

Der Tastenkode ist abhängig von der InputEvent-Klasse. See section Tastenkodes.

Achtung: Wählen Sie ihre Tastenbefehle sorgfältig, denn Commodities hat eine hohe Priorität in der InputEvent-Handlerkette, d.h. vorgegebene Definitionen werden übergangen.

10.1 InputEvent-Klassen

Commodities unterstützt die meisten der InputEvent-Klassen, die von dem input.device erzeugt werden. Diese Sektion beschreibt die Klassen, die nützlich für ToolManager sind.

rawkey

Dies ist die vorgegebene Klasse. Sie beschreibt alle Ereignisse, die durch die Tastatur erzeugt werden können. Zum Beispiel erzeugt rawkey a oder a jedesmal ein Ereignis, wenn die Taste “a” gedrückt wird. Sie müssen einen Tastenkode für diese Klasse angeben. See section rawkey.

rawmouse

Diese Klasse beschreibt alle Ereignisse, die durch die Maus erzeugt werden können. Sie müssen einen Tastenkode für diese Klasse angeben. See section rawmouse.

diskinserted

Ereignisse dieser Klasse werden generiert, wenn eine Diskette in ein Laufwerk gelegt wird. Diese Klasse besitzt keine Tastenkodes.

diskremoved

Ereignisse dieser Klasse werden generiert, wenn eine Diskette aus einem Laufwerk genommen wird. Diese Klasse besitzt keine Tastenkodes.

10.2 Qualifier

Einige Befehlsworte wurden erst bei Commodities V38 eingeführt. Diese sind mit einem * markiert.

lshift, left_shift *

Linke Shift-Taste.

rshift, right_shift *

Rechte Shift-Taste.

shift

Irgendeine Shift-Taste.

capslock, caps_lock *

Caps-Lock-Taste.

caps

Irgendeine Shift-Taste oder die Caps-Lock-Taste.

control, ctrl *

Control-Taste.

lalt, left_alt *

Linke Alt-Taste.

ralt, right_alt *

Rechte Alt-Taste.

alt

Irgendeine Alt-Taste.

lcommand, lamiga *, left_amiga *, left_command *

Linke Amiga-/Kommando-Taste.

rcommand, ramiga *, right_amiga *, right_command *

Rechte Amiga-/Kommando-Taste.

numericpad, numpad *, num_pad *, numeric_pad *

Dieses Befehlswort muß angegeben werden, wenn eine Taste von der Zehnertastatur benutzt wird.

leftbutton, lbutton *, left_button *

Linke Maustaste. Siehe unten.

midbutton, mbutton *, middlebutton *, middle_button *

Mittlere Maustaste. Siehe unten.

rbutton, rightbutton *, right_button *

Rechte Maustaste. Siehe unten.

repeat

Dieser Qualifier ist gesetzt, wenn die Tastenwiederholung aktiv ist. Dies ist nur sinnvoll für die InputEvent-Klasse rawkey.

Achtung: Commodities V37 hat einen Fehler, der die Benutzung von leftbutton, midbutton und rbutton als Qualifier verhindert. Dieser Fehler wurde in V38 behoben.

10.3 Tastenkodes

Jede InputEvent-Klasse besitzt ihre eigenen Tastenkodes:

10.3.1 Tastenkodes für die InputEvent-Klasse rawkey

Einige Befehlsworte wurden erst bei Commodities V38 eingeführt. Diese sind mit einem * markiert.

a-z, 0-9, …

ASCII-Zeichen.

f1, f2, …, f10, f11 *, f12 *

Funktionstasten.

up, cursor_up *, down, cursor_down *

left, cursor_left *, right, cursor_right *

Cursor-Tasten.

esc, escape *, backspace, del, help

tab, comma, return, space, spacebar *

Spezial-Tasten.

enter, insert *, delete *

page_up *, page_down *, home *, end *

Tasten der Zehnertastatur. Jeder dieser Tastenkodes muß mit dem Qualifier numericpad benutzt werden!

10.3.2 Tastenkodes für die InputEvent-Klasse rawmouse

Diese Befehlsworte wurden erst bei Commodities V38 eingeführt. Sie sind nicht verfügbar in V37.

mouse_leftpress

Drücke die linke Maustaste.

mouse_middlepress

Drücke die mittlere Maustaste.

mouse_rightpress

Drücke die rechte Maustaste.

Achtung: Um einen dieser Tastenkodes zu benutzen, müssen sie auch das entsprechende Qualifier-Befehlswort angeben, z.B.

rawmouse leftbutton mouse_leftpress

10.4 Beispiele für Tastenbefehle

ralt t

Rechte Alt-Taste festhalten und “t” drücken.

ralt lalt t

Rechte und linke Alt-Taste festhalten und “t” drücken.

alt t

Irgendeine Alt-Taste festhalten und “t” drücken.

rcommand f2

Rechte Amiga-Taste festhalten und die zweite Funktionstaste drücken.

numericpad enter

Enter-Taste auf der Zehnertastatur drücken.

rawmouse midbutton leftbutton mouse_leftpress

Mittlere Maustaste festhalten und die linke Maustaste drücken.

diskinserted

Eine Diskette in ein Laufwerk einlegen.

11 Die Entwicklung von ToolManager

2.0, Datum 26.09.1992

• - Komplett neues Konzept (objektorientiert)
• - (Fast) komplette Neuprogrammierung
• - ToolManager ist nun in zwei Teile aufgespalten
• - Der Handler ist in eine shared Library eingebettet
• - Die Konfiguration wird nun mit einem Voreinsteller bearbeitet
• - Das Konfigurationsdateiformat wurde wieder geändert :-) Es ist nun eine IFF Datei und liegt in ENV:
• - Mehrere Docks und Docks mit mehrere Spalten sind nun möglich
• - Es gibt Docks mit neuem Aussehen
• - Docks richten sich nun automatisch nach der Größe des größten Bildes
• - Sound Unterstützung
• - ARexx werden direkt in Programmobjekten unterstützt
• - ToolManager kann nun ohne Workbench benutzt werden. Wenn die Workbench nicht läuft, dann benutzt er keine App* Merkmale mehr.
• - Locale Unterstützung
• - Der Befehlspfad der Workbench wird für CLI Programme benutzt
• - Ein eigener Prozess startet die WB Programme

1.0 bis 1.5

Die Bemerkungen zu diesen Versionen entnehmen Sie bitte der englischen Dokumentation.

12 Der Autor möchte danken…

ToolManager hat mehrere große Entwicklungsphasen seit seiner ersten Programmierung Mitte 1990 durchlebt. Diese Entwicklung wäre unmöglich gewesen, wenn ich nicht den enormen Feedback von einigen ToolManager Benutzern gehabt hätte. Viele Ideen & Merkmale stammen aus dieser Quelle…

Daher möchte ich den folgenden Personen danken:

Für die Alpha-/Beta-Tests, Ideen & Bug Reports:

Die Amigagruppe unseres Computerclubs (Computerclub an der RWTH Aachen), Olaf ’Olsen’ Barthel, Georg Hessmann (Gucky), Markus Illenseer (ill), Klaus Melchior, Rickard Olsson (Richie), Matthias Scheler (Tron), Ralph Schmidt (laire), Roger Westerlund (Budda), Juergen Weinelt, Brian Wright (SteveVai), Petra Zeidler (stargazer) und viele andere…

Matthew Dillon

Ohne dein exzellentes C Entwicklungssystem DICE und verschiedener anderer Hilfsprogramme würde es keinen ToolManager geben!

Für ihre hervorragenden Grafiken:

Andreas Harrenberg, Georg Hessmann, Michael “Mick” Hohmann, Markus Illenseer, Oliver Koenen, Klaus Melchior, Rickard Olsson, Jan Peter, Matthias Scheler, Brian Wright

Für die Übersetzungen:

Tomi Blinnikka (Finnisch), Dr. Peter Kittel (Deutsch), Klaus Melchior (Eifel Platt), Rickard Olsson (Schwedisch), Marc Schaefer (Französisch & Italienisch)

Alle Leute in West Chester:

Für die Entwicklung des Amigas und seines hervorragenden Betriebssystems.

Alle Benutzer, die mir Geld geschickt haben:

Ich habe in den 1.X Versionen nicht danach gefragt, aber es ist erfreulich, wenn jemand meine Arbeit so sehr schätzt.

Alle Benutzer, die mir einen Brief geschickt haben:

Ich habe es genossen, Eure Briefe zu lesen!

und natürlich alle, die ich vergessen habe zu erwähnen…

Index

Table of Contents

About This Document

This document was generated on November 11, 2024 using texi2html 5.0.

The buttons in the navigation panels have the following meaning:

where the Example assumes that the current position is at Subsubsection One-Two-Three of a document of the following structure:

• 1. Section One
  • 1.1 Subsection One-One
    • ...
  • 1.2 Subsection One-Two
    • 1.2.1 Subsubsection One-Two-One
    • 1.2.2 Subsubsection One-Two-Two
    • 1.2.3 Subsubsection One-Two-Three     <== Current Position
    • 1.2.4 Subsubsection One-Two-Four
  • 1.3 Subsection One-Three
    • ...
  • 1.4 Subsection One-Four

This document was generated on November 11, 2024 using texi2html 5.0.