Magic 4.0 Konfiguration                                           29.5.94
=======================

ein CPX-Modul von:
Thomas Knneth
Friedrich-Neuper-Strae 2b
90552 Rthenbach


Haftung
-------
Tja, die folgenden Stzchen findet man in fast jeder Dokumentation von
Programmen...:
Obwohl ich bei der Erstellung dieser Software mit groer Sorgfalt zu Werke
gegangen bin, kann ich nicht fr ein einwandfreies Funktionieren unter allen
mglichen Gerte- und/oder Programmkonfigurationen garantieren.
Ich hafte nicht fr Schden, die aus dem (Nicht-)Gebrauch des Programms
resultieren. Die Benutzung erfolgt ausschlielich auf eigene Gefahr.

Copyright / Weitergabe
----------------------
Alle Rechte liegen beim Autor. Manipulationen an Programm und / oder
Dokumentation sind unter Androhung juristischer Manahmen untersagt.
Zur Weitergabe: Grundstzlich darf MGC4CNF nur vollstndig
weitergegeben werden.
Programmierern, die Peter Hellinger's Magic verwenden, wird hiermit
gestattet, MGC4CNF an ihre Kunden mitzuliefern. Voraussetzung hierfr ist
jedoch, da sie als Benutzer von Magic bei Peter Hellinger registriert
sind.
Die Anwender dieser Programme knnen MGC4CNF kopieren. Im brigen liegt die
jeweils aktuelle Version von MGC4CNF im ffentlichen Programmteil der
MAUS Nrnberg.

Dank
----
-allen voran Peter Hellinger (Sysop der Maus Nrnberg und Autor von
 Magic 4.0), Mika Arpe (Sieger im Icon-Malwettbewerb), Fridolin Koch,
 Roman Hodek, Alexander Lorenz und Dirk Stadler
-den Betatestern von 'Magic for C' und allen, die das CPX ausprobierten
-der grnen Insel im Allgemeinen und Arthur Guinness im Besonderen
-im Voraus danke ich London fr die wundervolle Woche, die ich dort ab dem
 12.9.93 dort verbringen werde... ;-)
-im Nachhinein bedanke ich mich bei London fr die wundervolle Woche, die
 ich dort verbracht habe

Wozu das ganze ?
----------------
Magic 4.0 lt sich in ausgesprochen weiten Grenzen konfigurieren.
Und im Laufe der (fr den Nutzer nicht sichtbaren) Evolution wurde diese
Vielfalt noch grer. :-)
Ich sage das nur mal so am Rande, falls sich jemand ber die hohe
Versionsnummer des CPX wundert. Das waren nicht nur :-) Bugfixes sondern
auch nderungen, die im Zuge der Weiterentwicklung von Magic ntig wurden.
"Der kann viel erzhlen", werden Sie jetzt sagen. :-) Wie dem auch sei, die
ntigen Flags werden in einem Speicherbereich zur Verfgung gestellt,
der mglichst frhzeitig (also am besten whrend des Bootens) reserviert
werden sollte.
Diesen Part bernimmt das Progrmmchen MPROCOOK.PRG (vom Meister persn-
lich). Fehlt dieses Programm im AUTO-Ordner, werden Magic-Anwendungen
sinnvolle Standardwerte nehmen. Das CPX-Modul macht Sie gegebenenfalls
durch den Text 'kein Cookie' im 'Info'-Dialog darauf aufmerksam.
Durch das Modul gemachte Einstellungen knnen zwar gespeichert,
jedoch nicht an laufende Magic-Anwendungen weitergereicht werden.
Nun ist es aber nicht jedermanns' Sache, bitweise in fremden Speichern
rumzupfriemeln. Aus diesem Grunde wurde MGC4CNF.CPX geschrieben.

Tja, und seit neuesten gibt es noch einen Grund fr MGC4CNF: CAT 2.x
von Dirk Steins und Johannes Gttker-Schneetmann. Dieses Maustausch-Frontend
benutzt die MagicDials in einer frheren Version; deshalb war bisher ein
eigenes CPX (von Dirk Steins) ntig; dies kann jetzt entfallen.
Soll das CPX nur zum Konfigurieren von CAT 2.0x verwendet werden, ist
MPROCOOK nicht ntig (...und liegt diesem Archiv ja auch gar nicht bei ;-))

Installation
------------
MGC4CNF.CPX wird einfach in den Ordner mit den brigen CPX-Modulen
kopiert.
Das Programm MPROCOOK.PRG mu in den Autoordner kopiert werden. Ein Start
vom Desktop aus ist ebenfalls mglich.
Nach dem erneuten Laden der Module oder einem Neustart ist MGC4CNF
bereit.
Beim ersten Aufruf des CPX wird der INFO-Dialog angezeigt; bei spteren
Aufrufen wird immer die zuletzt dargestellte Tafel angezeigt.

Bedienung des CPX-Moduls
------------------------
MGC4CNF.CPX stellt auf mehreren Tafeln Einstellmglichkeiten bereit.
Zwischen den einzelnen Tafeln kann mittels eines Popup-Mens umgeschaltet
werden, welches auf jeder Tafel in der linken oberen Ecke zu finden ist.

Allgemeine Bedienung: An hufigsten finden sich Funktionen, die man
ein- und ausschalten kann; diese werden ber die beliebten Ankreuzfelder
gesteuert. Ist das entsprechende Kstchen mit einem Kreuz versehen, steht
die durch den rechts davon stehenden Begleittext beschriebene Funktion zur
Verfgung. Der jeweils aktuelle Zustand wird gendert indem man entweder
innerhalb des Rechtsecks oder ber dem Begleittext einen Einfach-Klick
ausfhrt. Wird ein Kstchen mit Text grau dargestellt,wre das Anwhlen der
Funktion nicht sinnvoll und ist deshalb nicht mglich.
Eine andere Mglichkeit sind Popups, die im allgemeinen verwendet werden,
wenn sich eine Aktion nicht mit einer JA/NEIN bzw. AN/AUS Abfrage
realisieren lt.
Innerhalb der Tafel DEADKEYS schlielich gibt es noch Druckknpfe, die
beim ersten Anklicken einrasten und nach einem erneuten Klick wieder ihren
ursprnglichen Zustand annehmen.

Zu den Knpfen, die im unteren Bereich jeder Tafel zu sehen sind (bis auf
den Info-Dialog, der nur einen OK-Knopf beinhaltet):
'Speichern' legt die momentanen Einstellungen als Standard-
vorgaben im CPX-Modul ab. Diese werden automatisch in den von MPROCOOK.PRG
reservierten Speicherbereich bertragen, wenn XControl zum erstenmal die
Module ldt, um z.B. deren Icons anzeigen zu knnen.
War zu diesem Zeitpunkt MPROCOOK.PRG nicht geladen oder konnte - aus
welchen Grnden auch immer - kein Cookie angelegt werden, werden diese
Standardwerte geschrieben, sobald ein Cookie existiert und das CPX-Modul
aufgerufen wird.
'Abbruch' beendet das CPX-Modul, ohne die gemachten Einstellungen an
Magic weiterzugeben. Sie werden auch beim nchsten Aufruf durch die
Standardvorgaben ersetzt.
'OK' beendet MGC4CNF.CPX und bertrgt die neuen Einstellungen, damit
Magic-Anwendungen sie verwenden knnen. War 'Buttons im 3D-Look and
Feel' angekreuzt, wird ein komplettes Neuzeichnen des Bildschirms einge-
leitet. Beim nchsten Aufruf des CPX-Moduls werden diese Einstellungen
angezeigt. Sie gehen aber durch einen Reset verloren. Um dauerhaft mit
diesen Einstellungen zu arbeiten, mu der Knopf 'Sichern' angeklickt
werden.

Besonderheiten
--------------
Innerhalb des Dialoges 'Diverses' wird der Zugriffspfad fr den Magic-Kern
bestimmt. Hierzu kann der Button zwischen den 2 Scrollpfeilen benutzt
werden, worauf die Dateiauswahl erscheint. Wurde beim Anklicken des Buttons
eine Sondertaste (Shift/Alternate/...) gedrckt, wird der momentan aktuelle
Pfad auf dem zur Zeit aktuellem Laufwerk eingelesen;
normalerweise wird die zuletzt gemachte Einstellung angezeigt.

Interna
-------
Der Name des von Magic erwarteten Cookies ist 'MPRO'.
Fr das Maustausch-Frontend CAT wird ein 'MagC'-Cookie angelegt.
Die ID des CPX-Moduls ist 'THK1', die Versionsnummer ist im Moment $136.

V1.0 vom 12.3.93
V1.08 vom 3.7.93
V1.09 vom 4.7.93
V1.10 vom 3.8.93
V1.3  vom 16.11.93
V1.31 vom 26.11.93
V1.32 einen Tag spter (ein 'speichern'-Button und interne Verbesserungen)
V1.33 (interne Tommi-Version)
V1.34 am 20.12.93
V1.36 vom 29.5.94 (vor dem Rausschmeien von Magic wird in einer hbschen
Box vor den hlichen Folgen gewarnt und unter MultiTOS - und nur dort -
wird der Magic-Kern aus der prozessliste gestrichen, was bedeutet, da er
aus dem Speicher fliegt...


Besonderheiten
--------------
Wie bereits mehrfach angedeutet kann MGC4CNF auch das von Dirk Steins
stammende CPX ersetzen, welches der CAT-Distribution beiliegt.
Einstellungen, die erst in Magic >= 4.0 realisiert sind, werden einfach
ignoriert. Die Mglichkeit, einzustellen ob sich Dialoge mit Alternate oder
Control bedienen lassen, wurde aus Konsistenzgrnden entfernt.

Epilog
------
Viel gibt es ja zu den kurzen Programmen nicht zu sagen. Fr Rckfragen
stehe ich aber sehr gerne zur Verfgung. Auch an Fehlermeldungen bzw.
Unvertrglichkeiten mit anderer Software (was aber sehr unwahrscheinlich
ist) bin ich immer interessiert.

Am schnellsten geht das natrlich per DF:
Thomas Kuenneth @ N (vom MausNet ins MausNet)
Thomas_Kuenneth@N.maus.de
tskuenne@linguistik.uni-erlangen.de

Die jeweils neueste Version von MGC4CNF liegt im ffentlichen Programmteil
der Maus Nrnberg (ich glaube, das sagten Sie bereits, Sir....
Wer keine DF betreibt, bekommt von mir eine aktuelle Version, wenn Er/Sie
mir eine formatierte Diskette mit einem ausreichend frankierten und an sich
selbst adressierten Rckumschlag schickt. Meine Adresse findet sich am
Beginn dieses Textes und auf Tafel 'Info' des CPX-Moduls.

Ach ja, aus rechtlichen Grnden sollte ich vielleicht noch sagen, da
MGC4CNF.CPX mit PureC 1.1 von Application Systems, Heidelbeer compiliert
wurde.
MPROCOOK.PRG entstammt Peter Hellinger's Feder. Es wurde mit Pure Pascal 1.1
(ein Produkt der gleichen Firma) bersetzt.

Ich hoffe, mein Modul leistet mglichst Vielen gute (und absturzfreie)
Dienste.

Thomas Knneth


tick...tick...tick...tick... in letzter Minute ... ... ... ...
-Im Dialog DIALOGE kann man jetzt die erweiterten Editierfunktionen von
 Magic _IN DER SPEZIELLEN CAT-VERSION, UND NUR DORT_ ausschalten.
 Ich bin zwar ber diesen Schalter nicht glcklich, weil er mit Sicherheit
 Verwirrung stiften wird, aber solange Dirk CAT nicht auf das neue Magic
 umgestellt hat, wird es sicher ein paar User geben, die Let'em'Fly
 (ein Programm von Oliver Scheel) nutzen, und dessen Dialogbox-Editier-
 eigenschaften statt denen von Magic3 verwenden.
 Und das von Dirk verbreitete CPX kann's. Da ich das aber gerne durch meins
 ersetzt she ;-) mu ich wohl dieses Feature anbieten. ;-(

