\input amigatexinfo
\input gtexinfo
@c %**start of header
@setfilename ToolManager.info
@settitle ToolManager 3.1 Dokumentation
@setchapternewpage on
@set xrefstring siehe
@set Xrefstring Siehe
@c %**end of header


@comment
@comment  deutsch.tex V3.1
@comment
@comment  Documentation for ToolManager (Texinfo format, Language: deutsch)
@comment
@comment  Copyright (C) 1990-1998 Stefan Becker
@comment
@comment ----------------------------------------------------------------
@comment --- Title & Copyright Page (for printed manual)              ---
@comment ----------------------------------------------------------------
@titlepage

@title{ToolManager}
@subtitle{Eine Erweterung für die Amiga Workbench}
@subtitle{}
@subtitle{Version 3.1}
@subtitle{01 Jun 1998}

@page
@vskip 0pt plus 1filll

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

@ignore
Permission is granted to process this file by TeX and print the results,
provided the printed document carries a copying permission notice identical to
this one except for the removal of this paragraph (this paragraph not being
relevant to the printed manual).
@end ignore

@noindent COPYRIGHT

Copyright @copyright{} 1990--1998 Stefan Becker

Kein Programm, Dokument, Datei oder Quelltext aus diesem Software-Paket
darf, weder ganz noch auszugsweise, einem anderen Software-Paket
beigelegt werden, außer es liegt eine schriftliche Erlaubnis des Autors
vor.

@noindent KEINE GARANTIE

Es gibt keine Garantie für dieses Software-Paket. Obwohl der Autor
versucht hat Fehler zu vermeiden, kann er keine Garantie dafür geben,
daß das in dieser Dokumentation beschriebene Software-Paket 100%
fehlerfrei ist. Sie benutzen dieses Material also auf eigenes Risiko. Der
Autor kann nicht für igendwelche Schäden haftbar gemacht werden, die
durch die Benutzung dieses Software-Paketes enstanden sind.

@noindent VERTRIEB

Dieses Software-Paket kann frei verteilt werden (``freely
distributable''). Es kann auf jedes Medium übertragen werden, das für den
Vertrieb von freier Software benutzt wird, wie z.B.@: Public Domain
Diskettensammlungen, CDROMs, FTP Server oder Mailboxsysteme.

Um den einwandfreien Zustand des Software-Paketes sicherzustellen,
sollten die Vertreiber nur die Original-Archive verwenden:

@tex
\settabs 2 \columns
\+{\tt ToolManager3\_1Binaries.lha}&  (Dateiname im Aminet: {\tt ToolManagerBin.lha})\cr
\+{\tt ToolManager3\_1Developer.lha}& (Dateiname im Aminet: {\tt ToolManagerDev.lha})\cr
\+{\tt ToolManager3\_1Extras.lha}&    (Dateiname im Aminet: {\tt ToolManagerExt.lha})\cr
\+{\tt ToolManager3\_1Locale.lha}&    (Dateiname im Aminet: {\tt ToolManagerLoc.lha})\cr
\+{\tt ToolManager3\_1Sources.lha}&   (Dateiname im Aminet: {\tt ToolManagerSrc.lha})\cr
@end tex

Der Autor kann nicht dafür verantwortlich gemacht werden, wenn das
Software-Paket unbenutzbar geworden ist aufgrund von Veränderungen an dem
Inhalt der Archive oder den Archiven selbst.

Es wird keine obere Grenze für die Vertriebskosten festgesetzt, d.h.@:
für die Kosten von Disketten, Bändern oder CDROMs, oder dem Prozeß der
Vervielfältigung. Solche Grenzen haben sich als schädlich für die Idee
der frei verteilbaren Software erwiesen, z.B.@: wurden Software-Pakete
entfernt anstatt den Preis für eine Diskette unter die Grenze zu senken.

Obwohl der Autor keine Grenzen für die Vertriebskosten festlegt, möchte
er doch seine perönliche Meinung zu diesem Thema ausdrücken:

@itemize @bullet
@item Dieses Software-Paket sollte für jedermann kostenfrei zugänglich
sein wann immer dies möglich ist.

@item Wenn Sie dieses Software-Paket unter normalen Bedingungen von einem
Public Domain Händler auf einer Diskette bezogen haben und Sie haben mehr
als 5 DM oder US $5 bezahlt, dann haben Sie @emph{eindeutig} zu viel
gezahlt. Bitte unterstützen Sie nicht länger eine solche
Geschäftemacherei und suchen Sie sich so bald wie möglich ein günstigere
Bezugsquelle.
@end itemize

@noindent NUTZUNGSBESCHRÄNKUNGEN

Kein Programm, Dokument, Datei oder Quelltext aus diesem Software-Paket
darf, weder ganz noch auszugsweise, auf einer Maschine benutzt werden,
die

@itemize @bullet
@item für die Forschung, Entwicklung, Konstruktion, Tests oder Produktion
von Waffen oder anderen militärischen Anwendungen benutzt wird. Dies
schließt auch solche Maschinen ein, die für die Schulung für die
obengenannten Zwecke benutzt wird.

@item von Menschen benutzt wird, die Gewalt gegen andere Menschen, z.B.@:
Ausländer, akzeptieren, unterstützen oder selbst anwenden.
@end itemize
@page
(Diese Seite ist absichtlich leer)
@end titlepage
@headings double
@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Top Node (not printed)                                   ---
@comment ----------------------------------------------------------------
@ifinfo
@node Top, Copyright, (dir), (dir)
@top ToolManager 3.1 Dokumentation

@menu
Wichtige Informationen:

* Copyright::          Copyright und andere legale Dinge
* GiftWare::           Wenn Sie ToolManager mögen@dots{}
* Future::             Über die Zukunft von ToolManager
* Author::             Wohin sendet man Fehlerreports, Kommentare und Spenden?

Benutzung:

* Requirements::       Was wird benötigt, um ToolManager laufen zu lassen?
* Installation::       Wie man ToolManager installiert
* Concepts::           Die Konzepte hinter ToolManager
* Preferences::        Wie man ToolManager konfiguriert

Anhänge:

* Hotkeys::            Wie man Tastenbefehle definiert
* Questions::          Häufig gestellte Fragen
* History::            Entwicklungsgeschichte des ToolManagers
* Credits::            Der Autor möchte sich bedanken bei@dots{}
* MUI::                Informationen über MUI
* Index::              Index für dieses Dokument
@end menu

@end ifinfo
@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: Copyright (for Info/AmigaGuide document)        ---
@comment ----------------------------------------------------------------
@ifinfo
@node Copyright, GiftWare, Top, Top
@chapter Copyright und andere legale Dinge
@cindex Copyright
@cindex Vertrieb
@cindex Legale Dinge
@cindex Erlaubnisse
@cindex Verbote

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

@ignore
Permission is granted to process this file by TeX and print the results,
provided the printed document carries a copying permission notice identical to
this one except for the removal of this paragraph (this paragraph not being
relevant to the printed manual).
@end ignore

@noindent COPYRIGHT

Copyright @copyright{} 1990--1998 Stefan Becker

Kein Programm, Dokument, Datei oder Quelltext aus diesem Software-Paket
darf, weder ganz noch auszugsweise, einem anderen Software-Paket
beigelegt werden, außer es liegt eine schriftliche Erlaubnis des Autors
vor.

@noindent KEINE GARANTIE

Es gibt keine Garantie für dieses Software-Paket. Obwohl der Autor
versucht hat Fehler zu vermeiden, kann er keine Garantie dafür geben,
daß das in dieser Dokumentation beschriebene Software-Paket 100%
fehlerfrei ist. Sie benutzen dieses Material also auf eigenes Risiko. Der
Autor kann nicht für igendwelche Schäden haftbar gemacht werden, die
durch die Benutzung dieses Software-Paketes enstanden sind.

@noindent VERTRIEB

Dieses Software-Paket kann frei verteilt werden (``freely
distributable''). Es kann auf jedes Medium übertragen werden, das für den
Vertrieb von freier Software benutzt wird, wie z.B.@: Public Domain
Diskettensammlungen, CDROMs, FTP Server oder Mailboxsysteme.

Um den einwandfreien Zustand des Software-Paketes sicherzustellen,
sollten die Vertreiber nur die Original-Archive verwenden:

@noindent
ToolManager3_1Binaries.lha  (Dateiname im Aminet: ToolManagerBin.lha)
ToolManager3_1Developer.lha (Dateiname im Aminet: ToolManagerDev.lha)
ToolManager3_1Extras.lha    (Dateiname im Aminet: ToolManagerExt.lha)
ToolManager3_1Locale.lha    (Dateiname im Aminet: ToolManagerLoc.lha)
ToolManager3_1Sources.lha   (Dateiname im Aminet: ToolManagerSrc.lha)

Der Autor kann nicht dafür verantwortlich gemacht werden, wenn das
Software-Paket unbenutzbar geworden ist aufgrund von Veränderungen an dem
Inhalt der Archive oder den Archiven selbst.

Es wird keine obere Grenze für die Vertriebskosten festgesetzt, d.h.@:
für die Kosten von Disketten, Bändern oder CDROMs, oder dem Prozeß der
Vervielfältigung. Solche Grenzen haben sich als schädlich für die Idee
der frei verteilbaren Software erwiesen, z.B.@: wurden Software-Pakete
entfernt anstatt den Preis für eine Diskette unter die Grenze zu senken.

Obwohl der Autor keine Grenzen für die Vertriebskosten festlegt, möchte
er doch seine perönliche Meinung zu diesem Thema ausdrücken:

@itemize @bullet
@item Dieses Software-Paket sollte für jedermann kostenfrei zugänglich
sein wann immer dies möglich ist.

@item Wenn Sie dieses Software-Paket unter normalen Bedingungen von einem
Public Domain Händler auf einer Diskette bezogen haben und Sie haben mehr
als 5 DM oder US $5 bezahlt, dann haben Sie @emph{eindeutig} zu viel
gezahlt. Bitte unterstützen Sie nicht länger eine solche
Geschäftemacherei und suchen Sie sich so bald wie möglich ein günstigere
Bezugsquelle.
@end itemize

@noindent NUTZUNGSBESCHRÄNKUNGEN

Kein Programm, Dokument, Datei oder Quelltext aus diesem Software-Paket
darf, weder ganz noch auszugsweise, auf einer Maschine benutzt werden,
die

@itemize @bullet
@item für die Forschung, Entwicklung, Konstruktion, Tests oder Produktion
von Waffen oder anderen militärischen Anwendungen benutzt wird. Dies
schließt auch solche Maschinen ein, die für die Schulung für die
obengenannten Zwecke benutzt wird.

@item von Menschen benutzt wird, die Gewalt gegen andere Menschen, z.B.@:
Ausländer, akzeptieren, unterstützen oder selbst anwenden.
@end itemize
@end ifinfo
@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: GiftWare                                        ---
@comment ----------------------------------------------------------------
@node GiftWare, Future, Copyright, Top
@chapter Wenn Sie ToolManager mögen@dots{}
@cindex GiftWare
@cindex Spenden

ToolManager ist @emph{GiftWare}, @strong{keine} ShareWare!

Wenn Sie also dieses Programm mögen und es oft benutzen, dann sollten Sie
sich überlegen, ob Sie mir eine kleine Spende  zukommen  lassen,  um  die
Arbeit zu honorieren, die ich  in  dieses  Programm  gesteckt  habe.  Ich
schlage eine Spende in der Größenordnung von US $10--$20 oder  10--20  DM
vor. Bitte senden Sie keine Schecks oder  Geldanweisungen  von  außerhalb
Europas, denn deren Einlösung kostet meist mehr als der Betrag,  der  auf
dem Papier steht.

Wenn Sie es sich nicht leisten können, mir eine Spende zukommen zu
lassen, dann müssen Sie sich nicht schuldig fühlen. Sie sollten mir aber
trotzdem eine Postkarte oder einen Brief schicken, wenn Sie ToolManager
benutzen (Ich liebe es Post zu bekommen :-). @xref{Author}.


@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: Future                                          ---
@comment ----------------------------------------------------------------
@node Future, Author, GiftWare, Top
@chapter Über die Zukunft von ToolManager
@cindex Zukunft

Seit der Freigabe der letzten großen Version 2.1 von ToolManager im Mai
1993 hat der Amiga und seine Fangemeinde eine stürmische Zeit
durchgemacht. Zum Zeitpunkt, an dem diese Zeilen geschrieben werden,
sieht die Zukunft leider immer noch nicht rosig aus. Trotzdem habe ich
mich entschlossen eine neue Version 3.0 des ToolManagers zu entwickeln,
weil ich einen enormen Feedback von hunderten zufriedenen Benutzern
erhalten habe.

Mein A3000 hat nun ein ehrwürdiges Alter erreicht und in der aktuellen
Situation ist es ziemlich ungewiß, welche Richtung der Amiga nehmen wird.
Ich kann es mir nicht erlauben, jedes Upgrade oder eine der (hoffentlich)
neuen Maschinen zu kaufen, denn dieses Projekt ist ein reines Hobby. Es
liegt also an Ihrem Feedback und Ihren Spenden, ob ich an einer
zukünftigen Version von ToolManager arbeiten kann.

Dies ist auch ein Aufruf an die Firmen, die an den zukünftigen Amigas
arbeiten (Amiga Technologies, Phase5, ProDAD, VisCorp oder wer auch immer
momentan involviert ist). Ich bin nur ein FD Autor und kann es mir nicht
erlauben jedes kommende System zu kaufen oder die Kosten für die
Entwicklermaterialen für jedes System zu tragen. Also benötige ich Ihre
Unterstützung, wenn ToolManager auf Ihrem System laufen soll. Bedenken
Sie, daß ToolManager eines der meistgenutzten (wenn nicht sogar das
@strong{meistgenutzte}) Programme auf dem Amiga ist und es daher ein
Bonus für Ihr System wäre.

Die Zukunft des ToolManagers hängt von @emph{IHRER} Unterstützung ab!

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: Author                                          ---
@comment ----------------------------------------------------------------
@node Author, Requirements, Future, Top
@chapter Wohin sendet man Fehlerreports, Kommentare und Spenden?
@cindex Adressen
@cindex Autor
@cindex Kontaktadressen
@cindex EMail
@cindex Homepage
@cindex Postadresse
@cindex Word Wide Web

Der Autor kann unter den folgenden Adressen erreicht werden:

@table @asis
@item Postadresse:

@example

        Stefan Becker
        Bonner Ring 68
D-50374 Erfstadt
        GERMANY
@end example

@item Electronic Mail:

@example

stefanb@@yello.ping.de
@end example
@end table

Es existiert auch eine ToolManager Homepage im World Wide Web:

@example
http://www.ping.de/sites/yello/toolmanager.html
@end example

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: Requirements                                    ---
@comment ----------------------------------------------------------------
@node Requirements, Installation, Author, Top
@chapter Was wird benötigt, um ToolManager laufen zu lassen?
@cindex Rahmenbedingungen
@cindex OS 3.0
@cindex V39
@cindex DataTypes
@cindex PictDT V43
@cindex Pophotkey
@cindex Popport
@cindex Popposition
@cindex DOSPath
@cindex WBStart
@cindex ScreenNotify

ToolManager benötigt mindestens:

@table @asis
@item AmigaOS 3.0 (V39)
oder besser für Speicher-Pools und den picture.datatype.

@item WBStart 2.2
Dieses macht es möglich, daß ToolManager Workbench-Programme starten kann.

@item DOSPath 1.0
Dieses erledigt die Behandlung von AmigaDOS Kommandopfaden für ToolManager.
@end table

Zusätzlich unterstützt er:

@table @asis
@item ScreenNotify 1.0
Dieses Paket ermöglicht es ToolManager seine Dock-Fenster automatisch zu
öffnen oder schließen, wenn sich öffentliche Bildschirme öffnen oder
schließen.

@item picture.datatype V43
Die Erweiterungen dieses verbesserten picture.datatype werden automatisch
unterstützt, wenn er auf Ihrem System installiert ist. @xref{Credits}.
@end table

Der Voreinsteller benötigt:

@table @asis
@item AmigaOS 3.0 (V39)
oder besser für Speicher-Pools.

@item MUI 3.7
Das objekt-orientierte GUI-System. @xref{MUI}.

@item Pophotkey, Popport, Popposition
MUI Custom-Klassen für Popups. @xref{Credits}.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: Installation                                    ---
@comment ----------------------------------------------------------------
@node Installation, Concepts, Requirements, Top
@chapter Wie man ToolManager installiert
@cindex Installation
@cindex Installer V43.3

Bitte benutzen Sie das beigelegte Installer-Skript, um den ToolManager zu
installieren. Dieses Skript benötigt den AmigaOS Installer 43.3. Diese
Version finden Sie, z.B.@: auf dem Aminet.

Stoppen Sie den alten ToolManager bevor Sie die neue Version
installieren!

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: Concepts                                        ---
@comment ----------------------------------------------------------------
@node Concepts, Preferences, Installation, Top
@chapter Die Konzepte hinter ToolManager
@cindex Konzepte

ToolManager ist ein Program, das es Ihnen ermöglicht Ihre Programme in
sehr bequemer Weise zu starten. Sie können Programme per Tastenbefehl
starten (@pxref{Hotkeys}), vom Hilfsmittelmenü der Workbench oder durch
Anklicken von Piktogrammen entweder auf der Workbench oder in speziellen
Dock-Fenstern. Sie können sogar Piktogramme aus Workbench-Schubladen auf
diese Piktogramme ziehen, um die Programme mit Dateien zu versorgen.
Zusätzlich können Sie auch einen Ton mit jeder dieser Aktionen verbinden.

Alle diese Dinge werden von ToolManager Objekten kontrolliert. Jedes
Objekt hat eine spezielle Aufgabe und enthält alle Information, die zur
Ausführung dieser Aufgabe nötig sind. Programme werden zum Beispiel durch
Programmobjekte repräsentiert und enthalten Informationen über den
Programmnamen und die Stackgröße.

Es gibt zwei Arten von Objekten. Programm-, Bild- und Tonobjekte werden
als Basisobjekte bezeichnet, weil sie nur Informationen über ein
Programm, ein Bild oder einen Ton enthalten.

Menü-, Piktogramm- und Dock-Objekte werden zusammengesetzte Objekte
genannt, weil sie mehrere Basisobjekte für ihre Aufgabe benutzen. Ein
Piktogramm auf der Workbench wird zum Beispiel durch ein Piktogrammobjekt
repräsentiert, das einen Verweis auf ein Bildobjekt für die Bilddaten
und einen Verweis auf ein Programmobjekt enthält. Das Programm wird
gestartet, wenn man das Piktogramm aktiviert,

@menu
* Exec objects::    Programme
* Image objects::   Bilder
* Sound objects::   Töne
* Menu objects::    Einträge im Hilfsmittelmenü der Workbench
* Icon objects::    Piktogramme im Workbench-Fenster
* Dock objects::    Dock-Fenster
@end menu

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Concepts/Exec objects                           ---
@comment ----------------------------------------------------------------
@node Exec objects, Image objects, , Concepts
@section Programme
@cindex Programmobjekte

Ein Programmobjekt enthält Informationen über ein Programm, das gestartet
wird, wenn das Objekt aktiviert wird. Das Objekt kann direkt durch einen
@ref{Hotkeys, Tastenbefehl} oder durch ein zusammengesetztes Objekt
aktiviert werden. Bei der Aktivierung können Dateien angegeben werden,
die an das Programm als Startparameter weitergereicht werden.
Programmobjekte werden mit Hilfe des Fensters für @ref{ExecWindow,
Programmobjekte} konfiguriert.

ToolManager kann verschiedene Arten von Programmen ausführen:

@table @asis
@item Shell
Das Programm wird so ausgeführt als hätte der Benutzer den Befehl in der
Shell eingegeben. Shell-Skripte müssen mit diesem Modus gestartet werden.
Sie können die üblichen @file{[]} Platzhalter benutzen, um anzugeben wo
die Dateiennamen in die Kommandozeile eingefügt werden.

@item Workbench
Das Programm wird wie von der Workbench gestartet. Alle Dateien werden
als Workbench-Argumente übergeben. Programme, die nur in der Shell
arbeiten, oder Shell-Skripte können nicht mit diesem Modus gestartet
werden.

@item ARexx
Ein ARexx-Skript wird ausgeführt.

@item Dock
Das Kommando spezifiziert ein ToolManager Dock-Objekt, das aktiviert
werden soll. Sie können diesen Modus benutzen, um Docks aus anderen Docks
heraus zu öffnen.

@item Tastenbefehl
Ein Tastenbefehl wird erzeugt. Dieser Modus mag nützlich sein, um andere
Programme mit Hilfe von ToolManager zu kontrollieren.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Concepts/Image objects                          ---
@comment ----------------------------------------------------------------
@node Image objects, Sound objects, Exec objects, Concepts
@section Bilder
@cindex Bildobjekte

Ein Bildobjekt enthält Informationen über ein Bild, das von einem
zusammengesetzten Objekt benutzt werden kann. ToolManager kann Workbench
Piktogrammdateien laden, die von @ref{Icon objects, Piktogrammobjekten}
benutzt werden. Falls ein @ref{Dock objects, Dock-Objekt} ein Bildobjekt
benutzt, dann werden die Bilddaten mit Hilfe des DataTypes System
geladen. Daher kann ToolManager jede Bilddatei laden für die Sie einen
korrekten DataType auf Ihrem System installiert haben. Bildobjekte werden
mit Hilfe des Fensters für @ref{ImageWindow, Bildobjekte} konfiguriert.

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Concepts/Sound objects                          ---
@comment ----------------------------------------------------------------
@node Sound objects, Menu objects, Image objects, Concepts
@section Töne
@cindex Tonobjekte

Ein Tonobjekt enthält Informationen über einen Ton-Befehl. Dieser
Ton-Befehl wird per ARexx an ein externes Ton-Abspielprogramm geschickt.
Tonobjekte werden mit Hilfe des Fensters für @ref{SoundWindow,
Tonobjekte} konfiguriert.

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Concepts/Menu objects                           ---
@comment ----------------------------------------------------------------
@node Menu objects, Icon objects, Sound objects, Concepts
@section Einträge im Hilfsmittelmenü der Workbench
@cindex Menüobjekte

Ein Menüobjekt ist ein zusammengesetztes Objekt, bestehend aus einem
@ref{Exec objects, Programmobjekt} und einem @ref{Sound objects,
Tonobjekt}. Es erzeugt einen Eintrag in dem Hilfsmittelmenü der
Workbench. Wenn dieser Eintrag selektiert wird, dann werden das Programm-
und das Soundobjekt aktiviert. Alle auf der Workbench angewählten
Piktogramme werden als Startparameter an das Programm weitergereicht.
Menüobjekte werden mit Hilfe des Fenster für @ref{MenuWindow,
Menüobjekte} konfiguriert.

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Concepts/Icon objects                           ---
@comment ----------------------------------------------------------------
@node Icon objects, Dock objects, Menu objects, Concepts
@section Piktogramme im Workbench-Fenster
@cindex Piktogrammobjekte

Ein Piktogrammobjekt ist ein zusammengesetztes Objekt, bestehend aus
einem @ref{Exec objects, Programmobjekt}, einem @ref{Icon objects,
Bildobjekt} und einem @ref{Sound objects, Tonobjekt}. Es erzeugt ein
Piktogramm im Workbenchfenster mit der Hilfe der Bilddaten aus dem
Bildobjekt. Piktogrammobjekte werden mit Hilfe des Fensters für
@ref{IconWindow, Piktogrammobjekte} konfiguriert.

Piktogramme können auf zwei Arten aktiviert werden. Sie können das
Piktogramm doppelklicken oder Sie können Piktogramme auf der Workbench
anwählen und auf das Piktogramm werfen. Wird das Piktogramm aktiviert,
dann werden das Programm- und das Tonobjekt aktiviert. Die Piktogramme,
die auf das Piktogramm geworfen wurden, werden als Startparameter an das
Programm weitergereicht.

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Concepts/Dock objects                           ---
@comment ----------------------------------------------------------------
@node Dock objects, , Icon objects, Concepts
@section Dock-Fenster
@cindex Dock-Objekte

Ein Dock-Objekt ist ein zusammengesetztes Objekt, das ein Fenster mit
Reihen aus Knöpfen für den Benutzer erzeugt. Jeder Knopf besteht aus
einem @ref{Exec objects, Programmobjekt}, einem @ref{Icon objects,
Bildobjekt} und einem @ref{Sound objects, Tonobjekt}. Jeder Knopf kann
entweder einen Text, ein Bild oder beides zusammen darstellen. Dabei wird
der Name des Programmobjekts als Text benutzt. Das Bildobjekt wird für
das Bild benutzt. Dock-Objekte werden mit Hilfe des Fensters für
@ref{DockWindow, Dock-Objekte} konfiguriert.

Jeder Knopf kann auf zwei Arten aktiviert werden. Sie können den Knopf
anklicken oder Sie können Piktogramme auf der Workbench anwählen und auf
den Knopf werfen. Wird der Knopf aktiviert, dann werden das Programm- und
das Tonobjekt aktiviert. Die Piktogramme, die auf den Knopf geworfen
wurden, werden als Startparameter an das Programm weitergereicht.

Ein Dock-Objekt kann mit Hilfe eines @ref{Hotkeys, Tastenbefehls}
``aktiviert'' werden. Wenn das Dock-Fenster geschlossen ist und der
Benutzer den Tastenbefehl eingibt, dann wird das Dock-Fenster
geöffnet, und umgekehrt.

Falls die @file{screennotify.library} auf Ihrem System installiert ist,
dann kann ToolManager Dock-Fenster automatisch öffnen und schließen.
Jedesmal wenn ein öffentlicher Bildschirm geschlossen wird, dann werden
zuerst die Dock-Fenster auf diesem Bildschirm geschlossen. Wenn der
öffentliche Bildschirm wieder geöffnet wird, dann werden die Dock-Fenster
für diesen Bildschirm wieder geöffnet.

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Chapter: Preferences                                     ---
@comment ----------------------------------------------------------------
@node Preferences, Hotkeys, Concepts, Top
@chapter Wie man ToolManager konfiguriert
@cindex Voreinsteller

ToolManager kann mit Hilfe des ToolManager Voreinstellers konfiguriert
werden:

@menu
* MainWindow::         Das Hauptfenster

Fenster für die Konfiguration von Objekten:

* ExecWindow::         Wie man Programmobjekte konfiguriert
* ImageWindow::        Wie man Bildobjekte konfiguriert
* SoundWindow::        Wie man Tonobjekte konfiguriert
* MenuWindow::         Wie man Menüobjektekonfiguriert
* IconWindow::         Wie man Piktogrammobjekte konfiguriert
* DockWindow::         Wie man Dock-Objekte konfiguriert

Andere Fenster:

* GroupWindow::        Wie man eine Gruppe umbenennt
* ClipWindow::         Ablage für Objekte
* GlobalWindow::       Globale ToolManager Einstellungen

@end menu

Der Voreinsteller versteht die standardmäßigen Workbench Tool Types und
Shell Parameter:

@table @asis
@item @code{FROM} (Nur beim Aufruf aus einer Shell)
Gibt den Dateinamen an, aus der der Voreinsteller die Konfiguration laden
soll.

@item @code{EDIT} (voreingestellte Aktion)
Die Konfiguration kann verändert werden.

@item @code{USE}
Die neue Konfiguration soll temporär benutzt werden.

@item @code{SAVE}
Die neue Konfiguration soll permanent benutzt werden.

@item @code{CREATEICONS}
Wird eine Konfigurationsdatei gespeichert, dann wird ein Piktogramm
erzeugt. Wenn der Voreinsteller von der Workbench gestartet wird, dann
ist dies die voreingestellte Verhaltensweise. Beim Aufruf aus der Shell
werden ohne diese Option keine Piktogramme erzeugt.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/MainWindow                          ---
@comment ----------------------------------------------------------------
@node MainWindow, ExecWindow, , Preferences
@section Das Hauptfenster

Das Hauptfenster enthält Listen für die Objekte. Sie können den Typ der
gerade angezeigten Objekte auswählen, wenn Sie den entsprechenden Typ
anwählen. Jede Liste kann mehrere Gruppen enthalten. Jede Gruppe kann
mehrere Objekte enthalten.

Ein Doppelklick auf den Gruppennamen öffnet ein Fenster zum Ändern des
@ref{GroupWindow, Gruppennamens}. Ein Klick auf das Symbol links neben
dem Gruppennamen öffnet oder schließt die Gruppe. Wenn eine Gruppe
geöffnet ist, dann sind alle Objekte in dieser Gruppe sichtbar. Ein
Doppelklick auf den Namen eines Objektes öffnet das Konfigurationsfenster
für das Objekt.

Um Gruppen zu verschieben müssen Sie erst eine auswählen, sie zu der
neuen Position verschieben während Sie den linken Mausknopf gedrückt
halten und dort den Mausknopf loslassen. Auch Objekte können so zwischen
Gruppen verschoben werden.

Jede Liste hat vier Knöpfe:

@table @asis
@item Neue Gruppe
Erzeugt eine neue Gruppe. Ein Fenster mit dem @ref{GroupWindow,
Gruppennamen} öffnet sich, so daß Sie den Namen der neuen Gruppe ändern
können.

@item Neues Objekt
Erzeugt ein neues Objekt in der angewählten Gruppe. Ein
Konfigurationsfenster öffnet sich, so daß Sie die Einstellungen für das
Objekt verändern können.

@item Entfernen
Entfernt die angewählte Gruppe oder das angewählte Objekt. Wenn eine
Gruppe entfernt wird, dann werden auch alle in ihr enthaltenen Objekte
entfernt.

@item Sortieren
Wenn eine Objekt oder eine offene Gruppe angewählt ist, dann wird der
Inhalt der Gruppe alphabetisch sortiert. Andernfalls werden die Gruppen
alphabetisch sortiert.
@end table

Mit den Knöpfen in der untersten Reihe des Fensters können Sie dem
Voreinsteller mitteilen, wo die aktuelle Konfiguration gespeichert werden
soll. Der Name der Konfigurationsdatei lautet @file{ToolManager.prefs}.

@table @asis
@item Speichern
Lege die Konfiguration in dem Verzeichnis @file{ENVARC:} ab. Die neue
Konfiguration wird automatisch von ToolManager verwendet und sie wird
auch den Neustart des Systems überdauern. Nach dem Speichern der
Konfiguration beendet sich der Voreinsteller.

@item Benutzen
Lege die Konfiguration in dem Verzeichnis @file{ENV:} ab. Die neue
Konfiguration wird automatisch von ToolManager verwendet, aber sie wird
den Neustart des Systems @emph{nicht} überdauern. Nach dem Speichern der
Konfiguration beendet sich der Voreinsteller.

@item Test
Lege die Konfiguration in dem Verzeichnis @file{ENV:} ab. Die neue
Konfiguration wird automatisch von ToolManager verwendet, aber sie wird
den Neustart des Systems @emph{nicht} überdauern. Der
Voreinsteller beendet sich nicht.

@item Abbrechen
Der Voreinsteller wird verlassen. Alle nicht gespeicherten Änderungen
gehen dabei verloren.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/ExecWindow                          ---
@comment ----------------------------------------------------------------
@node ExecWindow, ImageWindow, MainWindow, Preferences
@section Wie man Programmobjekte konfiguriert

@ref{Exec objects, Programmobjekte} enthalten Informationen über
Programme. In dem Konfigurationsfenster können Sie folgende Dinge
einstellen:

@table
@item Name
Der Name des Objektes

@item Programmtyp
Der Aufrufmodus für das Programm. Sie können zwischen den Modi Shell,
Workbench, ARexx, Dock, Tastenbefehl und Netzwerk wählen. Der Modus
Netzwerk wird allerdings zur Zeit nicht unterstützt.

@item Befehl
Der Name des Programmes. Dies ist abhängig vom Programmtyp entweder ein
Dateiname, der Name eines Dock-Objektes oder eine
Tastenbefehlbeschreibung.

@item Tastenbefehl
Die Beschreibung für den @ref{Hotkeys, Tastenbefehl}, der dieses
Progrmmobjekt aktiviert.

@item Stack
Die Stackgröße für das Programm. ToolManager erzwingt eine Minimalgröße
von 4096 Bytes.

@item Priorität
Die Priorität für das Programm. Normalerweise sollten Sie nur den Wert 0
benutzen.

@item Argumente
Wenn diese Option aktiv ist, dann werden angewählte Dateien als
Startparameter an das Programm weitergereicht. Andernfalls werden die
Dateien ignoriert.

@item Nach vorne
Wenn diese Option aktiv ist, dann wird der angegebene öffentliche
Bildschirm nach vorne geholt bevor das Programm gestartet wird.

@item Aktuelles Verzeichnis
Das Programm wird aus diesem Verzeichnis heraus gestartet.

@item Befehlspfad
Sie können hier eine Liste von Verzeichnissen angeben, getrennt durch
Strichpunkte, die von Shell-Programmen benutzt werden, um andere
Programme zu finden.

@item Ausgabedatei
Die Ausgabe von Shell-Programmen wird in diese Datei umgelenkt. Wenn Sie
hier ein Konsolenfenster angeben, dann erfolgt sowohl die Ausgabe als
auch die Eingabe in diesem Fenster.

@item Öffentlicher Bildschirm
Gibt den öffentlichen Bildschirm an, der vor der Ausführung des
Programmes nach vorne geholt wird.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/ImageWindow                         ---
@comment ----------------------------------------------------------------
@node ImageWindow, SoundWindow, ExecWindow, Preferences
@section Wie man Bildobjekte konfiguriert

@ref{Image objects, Bildobjekte} enthalten Informationen über Bilder. In
dem Konfigurationsfenster können Sie folgende Dinge einstellen:

@table
@item Name
Der Name des Objektes.

@item Datei
Der Name der Datei aus der die Bilddaten gelesen werden sollen.
Normalerweise müssen Sie die Endung @file{.info} entfernen, wenn Sie eine
Piktogrammdatei laden wollen.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/SoundWindow                         ---
@comment ----------------------------------------------------------------
@node SoundWindow, MenuWindow, ImageWindow, Preferences
@section Wie man Tonobjekte konfiguriert

@ref{Sound objects, Tonobjekte} enthalten Informationen über Töne. In dem
Konfigurationsfenster können Sie folgende Dinge einstellen:

@table
@item Name
Der Name des Objektes.

@item Befehl
Der ARexx-Befehl, der zu dem externen Ton-Abspielprogramm geschickt
werden soll.

@item ARexx-Port
Der Name des Ports für das externe Ton-Abspielprogramm. Voreingestellt
ist @code{PLAY}, der von dem Programm @file{upd} benutzt wird.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/MenuWindow                          ---
@comment ----------------------------------------------------------------
@node MenuWindow, IconWindow, SoundWindow, Preferences
@section Wie man Menüobjekte konfiguriert

@ref{Menu objects, Menüobjekte} enthalten Informationen über Einträge im
Hilfsmittelmenü der Workbench. In dem Konfigurationsfenster können Sie
folgende Dinge einstellen:

@table
@item Name
Der Name des Objektes. Dieser wird auch für den Menüeintrag benutzt.

@item Programmobjekt
Ein Verweis auf das zu benutzende @ref{Exec objects, Programmobjekt}.
Wählen Sie ein Objekt aus dem @ref{MainWindow, Hauptfenster} oder einer
@ref{ClipWindow, Ablage} aus und werfen Sie es auf dieses Feld. Sie
können das Objekt konfigurieren, wenn Sie auf dieses Feld klicken.

@item Tonobjekt
Ein Verweis auf das zu benutzende @ref{Sound objects, Tonobjekt}. Wählen
Sie ein Objekt aus dem @ref{MainWindow, Hauptfenster} oder einer
@ref{ClipWindow, Ablage} aus und werfen Sie es auf dieses Feld. Sie
können das Objekt konfigurieren, wenn Sie auf dieses Feld klicken.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/IconWindow                          ---
@comment ----------------------------------------------------------------
@node IconWindow, DockWindow, MenuWindow, Preferences
@section Wie man Piktogrammobjekte konfiguriert

@ref{Icon objects, Piktogrammobjekte} enthalten Informationen über
Piktogramme im Workbench-Fenster. In dem Konfigurationsfenster können Sie
folgende Dinge einstellen:

@table
@item Name
Der Name des Objektes.

@item Programmobjekt
Ein Verweis auf das zu benutzende @ref{Exec objects, Programmobjekt}.
Wählen Sie ein Objekt aus dem @ref{MainWindow, Hauptfenster} oder einer
@ref{ClipWindow, Ablage} aus und werfen Sie es auf dieses Feld. Sie
können das Objekt konfigurieren, wenn Sie auf dieses Feld klicken.

@item Bildobjekt
Ein Verweis auf das zu benutzende @ref{Image objects, Bildobjekt}. Wählen
Sie ein Objekt aus dem @ref{MainWindow, Hauptfenster} oder einer
@ref{ClipWindow, Ablage} aus und werfen Sie es auf dieses Feld. Sie
können das Objekt konfigurieren, wenn Sie auf dieses Feld klicken.

@item Tonobjekt
Ein Verweis auf das zu benutzende @ref{Sound objects, Tonobjekt}. Wählen
Sie ein Objekt aus dem @ref{MainWindow, Hauptfenster} oder einer
@ref{ClipWindow, Ablage} aus und werfen Sie es auf dieses Feld. Sie
können das Objekt konfigurieren, wenn Sie auf dieses Feld klicken.

@item Position
Gibt die Position des Piktogramms in X- und Y-Koordinaten an, z.B.@:
würden Sie für @code{X = 100} und @code{Y = 55} hier @code{100/55}
eingeben. Die Koordinaten sind immer relativ zur linken oberen Ecke des
Workbench-Fensters.

@item Zeige Namen
Wenn diese Option aktiv ist, dann wird der Name des Objektes unterhalb
des Piktogrammes eingeblendet.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/DockWindow                          ---
@comment ----------------------------------------------------------------
@node DockWindow, GroupWindow, IconWindow, Preferences
@section Wie man Dock-Objekte konfiguriert

@ref{Dock objects, Dock-Objekte} enthalten Informationen über
Dock-Fenster. In dem Konfigurationsfenster können Sie folgende Dinge
einstellen:

@table
@item Name
Der Name des Objektes. Dieser wird auch für den Fenstertitel benutzt.

@item Öffentlicher Bildschirm
Gibt den öffentlichen Bildschirm an, auf dem das Dock-Fenster erscheint.
Sie @strong{müssen} hier den korrekten Namen eines öffentlichen
Bildschirms eintragen, wenn Sie das automatische Öffnen und Schließen des
Dock-Fensters wünschen.

@item Zeichensatz
Dieser Zeichensatz wird für die Texte der Knöpfe benutzt.

@item Spalten
Die Anzahl der Spalten für die Knopfreihen in dem Dock-Fenster. Die
Spalten werden von links nach rechts mit Knöpfen gefüllt. Wenn die letzte
Spalte einer Zeile gefüllt ist, dann wird eine weitere Knopfreihe
angefügt. Alle Knöpfe haben die gleiche Breite und Höhe.

@item Position
Gibt die Position des Dock-Fensters in X- und Y-Koordinaten an, z.B.@:
würden Sie für @code{X = 150} und @code{Y = 200} hier @code{150/200}
eingeben. Die Koordinaten sind immer relativ zur linken oberen Ecke des
öffentlichen Bildschirms.

@item Einträge
Jeder Eintrag in dieser Liste erzeugt einen Knopf. Die linke Spalte
enthält einen Verweis auf das zu benutzende @ref{Exec objects,
Programmobjekt}, die mittlere Spalte enthält einen Verweis auf das zu
benutzende @ref{Image objects, Bildobjekt} und die rechte Spalte enthält
einen Verweis auf das zu benutzende @ref{Sound objects, Tonobjekt}.
Wählen Sie ein Objekt aus dem @ref{MainWindow, Hauptfenster} oder einer
@ref{ClipWindow, Ablage} aus und werfen Sie es auf die Liste. Sie können
Objekte konfigurieren, indem Sie den Namen doppelklicken. Die Liste kann
per Auswahl und Verschieben von Einträgen sortiert werden. Wenn Sie den
Knopf ``Entfernen'' drücken, dann wird der ausgewählte Eintrag gelöscht.
Die in ihm enthaltenen Objekte werden jedoch @emph{nicht} entfernt.

@item Aktiviert
Das Dock-Fenster wird geöffnet, wenn die Konfiguration geladen wird.

@item Backdrop
Das Dock-Fenster wird nach hinten verlegt, nachdem es geöffnet wurde.

@item Rahmen
Ist diese Option aktiv, dann sieht das Dock-Fenster wie ein normales
Fenster aus, mit Rahmen und Fensterknöpfen. Andernfalls hat das Fenster
überhaupt keinen Rahmen. Beachten Sie dabei, daß Sie das
Dock-Fenster nur dann verschieben können, wenn es einen Rahmen hat.

@item Menü
Das Fenster erhält ein Menü. Das Menü erlaubt es Ihnen das Dock-Fenster
zu schließen, den ToolManager @ref{Preferences, Voreinsteller} zu starten
oder ToolManager zu verlassen.

@item Vorderster
Wenn diese Option aktiv ist, dann wird das Dock-Fenster immer auf dem
vordersten öffentlichen Bildschirm geöffnet.

@item Pop Up
Das Dock-Fenster wird automatisch geschlossen, nachdem ein Knopf
aktiviert wurde.

@item Zentriert
Das Dock-Fenster öffnet sich immer zentriert um die aktuelle
Mausposition.

@item Stationär
Normalerweise erinnert sich ein Dock-Fenster an die Position, wenn es
geschlossen wird. Es wird sich auf der gleichen Position wieder öffnen.
Wenn diese Option aktiv ist, dann benutzt das Dock-Fenster immer die
eingestellte Position.

@item Bilder
In den Knöpfen des Dock-Fensters werden Bilder dargestellt. Beachten Sie,
daß Sie dafür @ref{Image objects, Bildobjekte} für die Einträge auswählen
müssen.

@item Text
In den Knöpfen des Dock-Fensters wird der Name des zugehörigen @ref{Exec
objects, Programmobjektes} dargestellt. Beachten Sie, daß Sie dafür
Programmobjekte für die Einträge auswählen müssen.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/GroupWindow                         ---
@comment ----------------------------------------------------------------
@node GroupWindow, ClipWindow, DockWindow, Preferences
@section Wie man eine Gruppe umbenennt

Sie können den Namen der Gruppe in dem Eingabfeld ändern.

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/ClipWindow                          ---
@comment ----------------------------------------------------------------
@node ClipWindow, GlobalWindow, GroupWindow, Preferences
@section Ablage für Objekte

Dieses Fenster enthält eine Liste mit Verweisen auf @ref{Exec objects,
Programmobjekte}, @ref{Image objects, Bildobjekte} und @ref{Sound
objects, Tonobjekte}. Sie können Objekte aus dieser Liste ziehen und sie
auf Konfigurationsfenster werfen. Sie können ein Objekt konfigurieren,
indem Sie seinen Namen doppelklicken. Wenn Sie den Knopf ``Entfernen''
drücken, dann wird das ausgewählte Objekt von der Liste entfernen. Das
Objekt selber wird @emph{nicht} gelöscht.

Die Ablage kann vom Menü des Hauptfensters aus geöffnet werden. Es können
mehrere Ablagefenster gleichzeitig geöffnet sein.

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Section: Preferences/GlobalWindow                        ---
@comment ----------------------------------------------------------------
@node GlobalWindow, , ClipWindow, Preferences
@section Globale ToolManager Einstellungen

Mit diesem Fenster können sie die globalen Einstellungen für ToolManager
verändern. Es wird vom Menü des Hauptfensters aus geöffnet. Sie können
die folgenden Einstellungen vornehmen:

@table @asis
@item Aktuelles Verzeichnis
Setzt das aktuelle Verzeichnis für den ToolManager Prozess. Alle Dateien
ohne einen absoluten Pfadnamen werden relativ zu diesem Verzeichnis aus
geöffnet. Voreingestellt ist die Partition, von der aus das System
gestartet wurde.

@item Voreinstellungsprogramm
Pfadname für die Programmdatei des ToolManager @ref{Preferences,
Voreinstellers}. Voreingestellt ist @file{SYS:Prefs/ToolManager}.

@item Aktiviere Netzwerk
Diese Option wird momentan nicht unterstützt.

@item Aktiviere Remap
Diese Option aktiviert den Farbanpassung im picture.datatype.
Deaktivieren Sie diese Option nur, wenn die Bilder in Dock-Fenstern mit
den falschen Farben dargestellt werden.

@item Remap-Präzision
Gibt die Genauigkeit der Farbanpassung an. Falls die Auswahl der Farben
durch die Anpassung auf ihrem System nicht zufriedenstellend ist, dann
können Sie versuchen diesen Wert zu ändern.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix: Hotkeys                                        ---
@comment ----------------------------------------------------------------
@node Hotkeys, Questions, Preferences, Top
@appendix Wie man Tastenbefehle definiert
@cindex Einführung über Tastenbefehle
@cindex Tastenbefehle

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:

@example
[<Klasse>] @{[-][<Qualifier>]@} [-][upstroke] [<Tastenkode>]
@end example

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

@code{Klasse} beschreibt die InputEvent-Klasse. Dieser Parameter ist optional
und falls er weggelassen wird, dann wird die Vorgabe @code{rawkey} benutzt.
@xref{InputEvent classes}.

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 @code{-} vor
sein Befehlswort. @xref{Qualifiers}.

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 @code{upstroke} angeben. Wenn sowohl beim Drücken
als auch beim Loslassen der Taste ein Ereignis erzeugt werden soll, dann
müssen sie das Befehlswort @code{-upstroke} angeben.

Der Tastenkode ist abhängig von der InputEvent-Klasse. @xref{Key codes}.

@menu
* InputEvent classes::
* Qualifiers::
* Tastenkodes:Key codes.
* Beispiele für Tastenbefehle:Hotkey examples.
@end menu

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

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix Section: Hotkeys/InputEvent classes             ---
@comment ----------------------------------------------------------------
@node InputEvent classes, Qualifiers, , Hotkeys
@appendixsection InputEvent classes
@cindex Diskinserted
@cindex Diskremoved
@cindex InputEvent-Klassen
@cindex Rawkey
@cindex Rawmouse

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.

@table @code
@item rawkey
Dies ist die vorgegebene Klasse. Sie beschreibt alle Ereignisse, die
durch die Tastatur erzeugt werden können. Zum Beispiel erzeugt
@code{rawkey a} oder @code{a} jedesmal ein Ereignis, wenn die Taste ``a''
gedrückt wird. Sie müssen einen Tastenkode für diese Klasse angeben.
@xref{rawkey key codes,rawkey}.

@item rawmouse
Diese Klasse beschreibt alle Ereignisse, die durch die Maus erzeugt werden
können. Sie müssen einen Tastenkode für diese Klasse angeben.
@xref{rawmouse key codes,rawmouse}.

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

@item diskremoved
Ereignisse dieser Klasse werden generiert, wenn eine Diskette aus einem
Laufwerk genommen wird. Diese Klasse besitzt keine Tastenkodes.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix Section: Hotkeys/Qualifiers                     ---
@comment ----------------------------------------------------------------
@node Qualifiers, Key codes, InputEvent classes, Hotkeys
@appendixsection Qualifiers
@cindex Qualifiers

Commodities ünterstützt die folgenden Qualifiers:

@table @asis
@item @code{lshift}, @code{left_shift}
Linke Shift-Taste

@item @code{rshift}, @code{right_shift}
Rechte Shift-Taste

@item @code{shift}
Irgendeine Shift-Taste

@item @code{capslock}, @code{caps_lock}
Caps-Lock-Taste

@item @code{caps}
Irgendeine Shift-Taste oder die Caps-Lock-Taste

@item @code{control}, @code{ctrl}
Control-Taste

@item @code{lalt}, @code{left_alt}
Linke Alt-Taste

@item @code{ralt}, @code{right_alt}
Rechte Alt-Taste

@item @code{alt}
Irgendeine Alt-Taste

@item @code{lcommand}, @code{lamiga}, @code{left_amiga}, @code{left_command}
Linke Amiga-/Kommando-Taste

@item @code{rcommand}, @code{ramiga}, @code{right_amiga}, @code{right_command}
Rechte Amiga-/Kommando-Taste

@item @code{numericpad}, @code{numpad}, @code{num_pad}, @code{numeric_pad}
Dieses Befehlswort @emph{muß} angegeben werden, wenn eine Taste von der
Zehnertastatur benutzt wird.

@item @code{leftbutton}, @code{lbutton}, @code{left_button}
Linke Maustaste

@item @code{midbutton}, @code{mbutton}, @code{middlebutton}, @code{middle_button}
Mittlere Maustaste

@item @code{rbutton}, @code{rightbutton}, @code{right_button}
Rechte Maustaste

@item @code{repeat}
Dieser Qualifier ist gesetzt, wenn die Tastenwiederholung aktiv ist. Dies ist
nur sinnvoll für die InputEvent-Klasse @code{rawkey}.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix Section: Hotkeys/Key codes                      ---
@comment ----------------------------------------------------------------
@node Key codes, Hotkey examples, Qualifiers, Hotkeys
@appendixsection Tastenkodes

Jede InputEvent-Klasse besitzt ihre eigenen Tastenkodes:

@menu
* rawkey:rawkey key codes.
* rawmouse:rawmouse key codes.
@end menu

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix Subsection: Hotkeys/Key codes/rawkey key codes  ---
@comment ----------------------------------------------------------------
@node rawkey key codes, rawmouse key codes, , Key codes
@appendixsubsec Tastenkodes für die InputEvent-Klasse @code{rawkey}
@cindex Tastenkodes für @code{rawkey}

@table @asis
@item @code{a}-@code{z}, @code{0}-@code{9}, @dots{}
ASCII-Zeichen

@item @code{f1}, @code{f2}, @dots{}, @code{f10}, @code{f11}, @code{f12}
Funktionstasten

@item  @code{up}, @code{cursor_up}, @code{down}, @code{cursor_down}
@itemx @code{left}, @code{cursor_left}, @code{right}, @code{cursor_right}
Cursor-Tasten

@item  @code{esc}, @code{escape}, @code{backspace}, @code{del}, @code{help}
@itemx @code{tab}, @code{comma}, @code{return}, @code{space}, @code{spacebar}
Spezialtasten

@item  @code{enter}, @code{insert}, @code{delete}
@itemx @code{page_up}, @code{page_down}, @code{home}, @code{end}
Tasten der Zehnertastatur. Diese Tastenkodes @emph{müssen} mit dem
Qualifier @code{numericpad} benutzt werden!
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix Subsection: Hotkeys/Key codes/rawmouse key codes --
@comment ----------------------------------------------------------------
@node rawmouse key codes, , rawkey key codes, Key codes
@appendixsubsec Tastenkodes für die InputEvent-Klasse @code{rawmouse}
@cindex Tastenkodes für @code{rawmouse}

@table @code
@item mouse_leftpress
Drücke die linke Maustaste.

@item mouse_middlepress
Drücke die mittlere Maustaste.

@item mouse_rightpress
Drücke die rechte Maustaste.
@end table

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

@example
rawmouse leftbutton mouse_leftpress
@end example

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix Section: Hotkeys/Hotkey examples                ---
@comment ----------------------------------------------------------------
@node Hotkey examples, , Key codes, Hotkeys
@section Beispiele für Tastenbefehle
@cindex Beispiele für Tastenbefehle

@table @code
@item ralt t
Rechte Alt-Taste festhalten und ``t'' drücken.

@item ralt lalt t
Rechte @emph{und} linke Alt-Taste festhalten und ``t'' drücken.

@item alt t
Irgendeine Alt-Taste festhalten und ``t'' drücken.

@item rcommand f2
Rechte Amiga-Taste festhalten und die zweite Funktionstaste drücken.

@item numericpad enter
Enter-Taste auf der Zehnertastatur drücken.

@item rawmouse midbutton leftbutton mouse_leftpress
Mittlere Maustaste festhalten und die linke Maustaste drücken.

@item diskinserted
Eine Diskette in ein Laufwerk einlegen.
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix: Questions                                      ---
@comment ----------------------------------------------------------------
@node Questions, History, Hotkeys, Top
@appendix Häufig gestellte Fragen

Hier finden Sie die Antworten zu den meistgestellten Fragen über ToolManager:

@itemize @minus
@item Wenn ich den ToolManager Voreinsteller starte, dann erscheint nur
ein Hinweisfenster mit dem Text ``Program initialization failed''. Was
ist passiert?

Der Voreinsteller überprüft einige grundlegende Voraussetzungen, bevor er
das erste Fenster öffnet. Bitte überprüfen Sie, daß diese
@ref{Requirements, Voraussetzungen} erfüllt sind! Es könnte auch zu wenig
Speicher auf Ihrem System vorhanden sein. Sie müssen dann zuerst einige
andere Programme beenden, bevor sie den ToolManager Voreinsteller starten
können. Weiterhin kann auch nur ein Voreinsteller zur gleichen Zeit aktiv
sein.

@item Wie kann ich den ToolManager Voreinsteller auf einem anderen
öffentlichen Bildschirm als der Workbench laufen lassen?

Wählen Sie den Eintrag @code{MUI...} im Optionen-Menü des
@ref{MainWindow, Hauptfensters} aus  Nun selektieren Sie die Seite
@code{System} und geben den Namen des öffentlichen Bildschirms in das
Eingabefeld ein. Für weitere Details lesen Sie bitte die Dokumentation zu
@ref{MUI}.

@item Nachdem ich meine alte ToolManager 2.x Konfiguration konvertiert
habe, fehlen einige Bilder in den Dock-Fenstern und einige Dock-Fenster
erscheinen garnicht mehr!

ToolManager 3.1 unterstützt in Dock-Fenster nur Bilddateien, die mit
Hilfe des picture.datatypes geladen werden können. In Ihrer alten
Konfiguration haben Sie den Dock-Objekten einige Bildobjekte zugeordnet,
die auf Piktogrammdateien verweisen. Wenn Sie diese Dateien
weiterverwenden wollen, dann müssen Sie einen Datatype für Piktogramme
auf Ihrem System installieren. Sie können einen solchen Datatype z.B.@:
auf dem Aminet finden. Sie können natürlich auch die Piktogramme in IFF
Bilddateien umwandeln.

@item Nachdem ich meine alte ToolManager 2.x Konfiguration konvertiert
habe, fehlen einige Piktogramme im Workbench-Fenster!

ToolManager 3.1 unterstützt nur Piktogrammdateien für Piktogrammobjekte.
In Ihrer alten Konfiguration haben Sie den Piktogrammobjekten einige
Bildobjekte zugeordnet, die auf IFF Bilddateien verweisen. Wenn Sie diese
Dateien weiterverwenden wollen, dann müssen Sie diese in
Piktogrammdateien umwandeln.

@item Wenn ich Piktogrammdateien in Dock-Fenstern benutze, dann erscheint
zusätzlicher Text in den Bildern oder die Bilder haben einen dicken
Rahmen. Was ist passiert?

Sie haben einen icon.datatype auf Ihrem System installiert, der
zusätzliche Informationen aus dem Piktogramm in dem Bild anzeigt. Bitte
lesen Sie in der Dokumentation des icon.datatype nach, wie man diese
Zusatzinformationen abschalten kann. Wenn Sie den dicken Rahmen nicht
mögen, dann müssen Sie den icon.datatype so konfigurieren, daß er den
normalen Piktogrammrahmen nicht erzeugt.

@item Warum kann ToolManager nicht mehrere ``Hilfsmittel'' Menüs oder
Untermenüs erzeugen?

Mehrfache Menüs oder Untermenüs werden zur Zeit noch nicht vom Betriebssystem
unterstützt. Um sie zu erzeugen, muß man sie in das System @emph{patchen}, was
zu einem instabilen System führen kann. Daher werde ich so etwas nicht in
ToolManager einbauen.


@item Wie kann ich ein horizontales Dock-Fenster erzeugen?

Setzen Sie dazu einfach die Spaltenzahl gleich der Anzahl der Einträge in
dem Dock-Objekt.


@item Wie kann ich ein Ausgabefenster für Shell-Programme erzeugen?

Ausgabefenster können mit Hilfe des @code{CON:} Geräts erzeugt werden.
Benutzen Sie den folgenden Dateinamen, um ein sich automatisch öffnendes
Fenster mit einem Close-Gadget zu erzeugen, das sich nach dem Ende des
Programmes nicht automatisch schliesst:

@example
CON:10/10/640/100/Ausgabefenster/AUTO/CLOSE/WAIT
@end example

Das Gerät @code{CON:} hat viele Optionen, die Sie dem AmigaDOS Handbuch
entnehmen können.


@item Wie kann ich die Argumente in die Mitte einer Shell/ARexx
Kommandozeile einfügen?

Normalerweise werden alle Argumente an die Kommandozeile angehängt. Um sie
jedoch irgendwo in der Kommandozeile einzufügen, benutzt ToolManager die
gleiche @code{[]} Syntax, wie der AmigaShell-Befehl @code{alias}. Dies sieht
dann z.B.@: so aus:

@example
Dir [] all
@end example

Alle Argumente werden vor dem Schlüsselwort @code{all} eingefügt.


@item Wie kann ich Unter-Docks erzeugen?

Sie müssen dafür Programmobjekte des Typs Dock verwenden. Setzen Sie
diese Objekte in Ihr Haupt-Dock und schon können Sie andere Dock-Fenster
öffnen bzw.@: schliessen.


@item Dock-Fenster verschwinden, wenn der Workbench-Bildschirm
geschlossen und wieder geöffnet wird.

Sie haben vergessen, den Namen des öffentlichen Bildschirms für das
Dock-Fenster auf @code{Workbench} zu setzen. ToolManager schließt seine
Dock-Fenster automatisch, wenn ein öffentlicher Bildschirm geschlossen
wird. Aber er muß wissen auf welchem öffentlichen Bildschirm ein
Dock-Fenster erscheinen soll, damit er es automatisch öffnen kann, wenn
der öffentliche Bildschirm sich wieder öffnet.
@end itemize

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix: History                                        ---
@comment ----------------------------------------------------------------
@node History, Credits, Questions, Top
@appendix Entwicklungsgeschichte des ToolManagers

Dieses Kapitel wurde original aus der englischen Dokumentation übernommen.

@table @asis
@item 3.1, Release date 01.06.1998
@itemize @minus
@item Clipboard list also shows the object type now
@item Only requires locale.libary V38 now
@item Icon drop corrected for dock windows with borders
@item The __geta4 qualifier was missing for some BOOPSI dispatchers. This might
correct some strange bugs which were reported?
@item Installer script now checks for required libraries
@end itemize

@item 3.0, Release date 23.02.1997
@itemize @minus
@item Again rewritten (almost) from scratch :-)
@item Old object system removed, TM objects are now BOOPSI objects
@item Now uses memory pools
@item Delay parameter removed from Exec Objects
@item Animation support removed from Image Objects
@item Picture.datatype V43 support added to Image Objects
@item Only icon images supported for Icon Objects
@item Only images loadable via picture.datatype are supported in Dock Objects
@item Pattern & Vertical flags and Title parameter removed from Dock Objects
@item Dock Objects can now display text and images
@item Dock Objects can now be completely borderless
@item New preferences file format, hopefully more flexible
@item Converter for the ToolManager 2.x format
@item Events are now checked while the configuration is read
@item Preferences is now a MUI application: resizable window, multiple open
edit windows and Drag&Drop support
@item Changing an object name automatically updates all references to the
object.
@item Support for grouping objects.
@item All dock objects get the screen notifications
@item Added support for DOSPath 1.0
@item CLI command lines are not limited to 4KB anymore
@item Installer script
@end itemize


@item 2.1b, Release date 13.03.1996
@itemize @minus
@item Minor update to 2.1
@item Added support for WBStart 2.0
@end itemize


@item 2.1a, Release date 26.03.1995
@itemize @minus
@item Minor update to 2.1
@item Added support for ScreenNotify 1.0
@item Included newer version of WBStart-Handler
@item Included missing AutoDocs for toolmanager.library
@end itemize


@item 2.1, Release date 16.05.1993, Fish Disks #872 & #873
@itemize @minus
@item New Exec object types: Dock, Hot Key, Network
@item New Dock object flags: Backdrop, Sticky
@item New object type: Access
@item Network support
@item Editor main window is now an AppWindow
@item Gadget keyboard shortcuts in the preferences editor
@item New tooltypes for the preferences editor
@item Several bug fixes
@item Enhanced documentation
@end itemize


@item 2.0, Release date 26.09.1992, Fish Disk #752
@itemize @minus
@item Complete new concept (object oriented)
@item (Almost) Complete rewrite
@item ToolManager is now split up into two parts
@item Main handler is now embedded into a shared library
@item Configuration is now handled by a Preferences program
@item Configuration file format has changed again :-) It is an IFF File now
and resides in ENV:
@item Multiple Docks and multi-column Docks
@item Docks with new window design
@item Dock automatically detects largest image size
@item Sound support
@item Direct ARexx support for Exec objects
@item ToolManager can be used without the Workbench. If the Workbench isn't
running, it won't use any App* features.
@item Locale support
@item Path from Workbench will be used for CLI tools
@item Seperate Handler Task for starting WB processes
@end itemize


@item 1.5, Release date 10.10.1991, Fish Disk #551
@itemize @minus
@item Status Window: New/Open/Append/Save As menu items for config file
@item Edit Window: File requesters for file string gadgets
@item Added a Dock Window (a la NeXT)
@item Added a DeleteTool
@item A list of all active HotKeys can be shown
@item Tools can be moved around in the list
@item Icon positioning in the edit window added
@item Name of the program icon can be set
@item CLI tools can have an output file and a path list
@item Uses UserShell for CLI tools
@item Maximum command line length for CLI tools is now 4096 Bytes
@item AppIcons without a name are supported now
@item Workbench screen will be moved to front if you pop up the Status window
@item Workbench screen can be moved to front before starting a tool via HotKey
@item TM will wait up to 20 seconds for the workbench.library
@item Added a DELAY switch which causes TM to wait <num> seconds before adding
any App* stuff
@item renamed some tooltypes/parameters
@item some visual cues added
@item some internal changes
@end itemize


@item 1.4, Release date 09.07.1991, Fish Disk #527
@itemize @minus
@item Keyboard short cuts for tools
@item AppIcons for tools
@item Menu item can be switched off
@item Configuration file format completely changed (hopefully the last time)
@item CLI commandline parsing is now done by ReadArgs()
@item Status & edit window updated to new features
@item Safety check before program shutdown added
@item Menu item ``Open TM Window'' only appears if the program icon is
disabled
@item WB startup method changed. Now supports project icons
@item several internal changes
@end itemize


@item 1.3, Release date 13.03.1991, Fish Disk #476
@itemize @minus
@item Now supports different configuration files
@item Format of the configuration file slightly changed
@item Tool definitions can be changed at runtime
@item Now supports CLI & Workbench startup method
@item Selected icons are passed as parameters to the tools
@item Now uses the startup icon as program icon if started from Workbench
@item The position of the icon can now be supplied in the configuration file
@item The program icon can now be disabled
@item New menu entry ``Show TM Window''
@item Every new started ToolManager passes its startup parameters to the
already running ToolManager process
@end itemize


@item 1.2, Release date 12.01.1991, Fish Disk #442
@itemize @minus
@item Status window changed to a no-GZZ & simple refresh type
(this should save some bytes)
@item Status window remembers its last position
@item New status window gadget ``Save Configuration'': saves the actual tool
list in the configuration file
@item Small bugs removed in the ListView gadget handling
@item Name of the icon hard-wired to ``ToolManager''
@end itemize


@item 1.1, Release date 01.01.1991
@itemize @minus
@item Icons can be dropped on the status window
@item Status window contains a list of all tool names
@item Tools can be removed from the list
@end itemize


@item 1.0, Release date 04.11.1990
@itemize @minus
@item Initial release
@end itemize

@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix: Credits                                        ---
@comment ----------------------------------------------------------------
@node Credits, MUI, History, Top
@appendix Der Autor möchte sich bedanken bei@dots{}
@cindex Credits
@cindex Thanks

ToolManager hat mehrere große Entwicklungsphasen seit seiner ersten
Version 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 und Merkmale stammen aus dieser Quelle@dots{}

Daher möchte ich den folgenden Personen danken:

@table @asis
@item Für die Alpha-/Beta-Tests, Ideen & Bug Reports:
Osma Ahvenlampi, Stephane Barbaray, Olaf Barthel, Fionn Behrens,
Mario Cattaneo, Michael van Elst, Michael Hohmann, Markus Illenseer,
Frank Mariak, Klaus Melchior, Bernhard Moellemann, Matthias Scheler,
Ralph Schmidt, Tobias Walter.

@item Für die Übersetzungen:
The Amiga Translators Organization (ATO). Die Liste der Übersetzer finden Sie
in der Datei @file{Readme.Locale}.

@item Matthew Dillon
Ohne dein @strong{exzellentes} C Entwicklungssystem DICE und verschiedener
anderer Hilfsprogramme würde es keinen ToolManager geben!

@item Alle Benutzer, die mir eine Spende geschickt haben:
Euere Unterstützung hat diese Version erst möglich gemacht!

@item Alle Benutzer, die mir eine Notiz zugschickt haben:
Ich habe es genossen eure Briefe und E-Mails zu lesen!
@end table

ToolManager benutzt die folgenden Pakete:

@table @asis
@item picture.datatype V43
Copyright @copyright{} 1995--1996 Ralph Schmidt, Frank Mariak &@*
Matthias Scheler

@item WBStart 2.2
Copyright @copyright{} 1991--1996 Stefan Becker

@item ScreenNotify 1.0
Copyright @copyright{} 1995 Stefan Becker

@item DOSPath 1.0
Copyright @copyright{} 1996 Stefan Becker

@item MUI
Copyright @copyright{} 1993--1997 Stefan Stuntz@*
World Wide Web Homepage: @code{http://www.sasg.com/}.

@itemx Pophotkey.mcc, Popport.mcc, Popposition.mcc
Copyright @copyright{} 1996--1997 Klaus Melchior

@item Piktogramme
Copyright @copyright{} 1995 Michael W. Hohmann
@end table

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Appendix: MUI                                            ---
@comment ----------------------------------------------------------------
@node MUI, Index, Credits, Top
@appendix Informationen über MUI
@cindex MUI

@example
                          This application uses


                        MUI - MagicUserInterface

                (c) Copyright 1993-97 by Stefan Stuntz


MUI is a system to generate and maintain graphical user interfaces. With
the  aid  of  a  preferences program, the user of an application has the
ability to customize the outfit according to his personal taste.

MUI is distributed as shareware. To obtain a complete package containing
lots of examples and more information about registration please look for
a  file  called  "muiXXusr.lha"  (XX means the latest version number) on
your local bulletin boards or on public domain disks.

          If you want to register directly, feel free to send


                         DM 30.-  or  US$ 20.-

                                  to

                             Stefan Stuntz
                        Eduard-Spranger-Straße 7
                             80935 München
                                GERMANY



             Support and online registration is available at

                          http://www.sasg.com/
@end example

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Unnumbered chapter: Index                                ---
@comment ----------------------------------------------------------------
@node Index, , MUI, Top
@unnumbered Index

@printindex cp

@comment ----------------------------------------------------------------




@comment ----------------------------------------------------------------
@comment --- Table of Contents (appears only in printed manual)       ---
@comment ----------------------------------------------------------------
@contents
@comment ----------------------------------------------------------------

@comment This is REALLY the end :-)

@bye
