
   BOMBADIL - Modul zur Behebung einiger Calamus-Fehler
   -----------------------------------------------------------------------------
   Entwickelt von Harald Siegmund @ KL (Mausnet)

   (bitte lesen Sie auch die Datei BOMBADIL.TXT!)


   Wozu?
   -----
   In allen bekannten Versionen von Calamus S und SL steckt ein Fehler, der
   beim Transport von Objekten ber das Clipboard die Datenstrukturen
   derselben beschdigen kann. Da erst eine ganze Reihe vom Umstnden
   zusammenkommen mu, damit dieser "Bug" zuschlgt, tritt er ziemlich
   selten auf, was ihn recht heimtckisch macht: scheinbar ohne Zusammenhang
   lassen sich pltzlich Objekte nicht mehr ins Dokument bertragen.
   Aufgrund dieses nicht reproduzierbaren Verhaltens dauerte es nach der
   Verffentlichung von Calamus S/SL mehrere Jahre, bis dieser Fehler
   aufgedeckt und lokalisiert werden konnte.

   Schuld an diesem Fehlverhalten ist brigens nicht das Clipboard, sondern
   ein Teil der allgemeinen Dokumentstruktur-Verwaltung. Die zum Auslsen
   des Fehlers notwendigen Voraussetzungen konnten lange Zeit nur vom Clipboard
   eingebracht werden. Unerklrliche Effekte bei der Entwicklung des
   Texteditors "Eddie" brachten dann die Hintergrnde dieses Fehlers ans
   Licht. Es ist durchaus mglich, da noch andere Funktionen des Calamus-
   Systems davon betroffen sind.

   Der Fehler ist konzeptioneller Natur und leider nicht durch einen einfachen
   Patch zu beseitigen. Die Auswirkungen sind sehr komplex und ohne
   Erluterungen der technischen Zusammenhnge fast unmglich zu beschreiben.
   Nur soviel: Es gehen bestimmte Referenzen von Objekten in ihr Ursprungs-
   dokument verloren. Werden nderungen an Farb- oder Stilliste im Dokument
   vorgenommen, so erfolgt keine Aktualisierung der geclippten Objekte mehr.

   BOMBADIL ist jedenfalls als eine Art "Wchter" konzipiert: Das Modul
   "beobachtet" die Dokumentenstruktur und greift bei Fehlern ein, um diese
   zu korrigieren.



   Wozu noch?
   ----------
   Im Laufe der Zeit hat sich BOMBADIL regelrecht zu einer Sammlung von
   Bugfixes gemausert. Mittlerweile knnen neun bekannte Fehler von
   Calamus und seinen Modulen umgangen bzw. deren Symptome beseitigt
   werden:

    Der Strukturfehler, der u.a. bei Clipboard-Operationen auftreten kann
     (Beschreibung siehe oben).

    Alle Versionen ab 1994 des Calamus Dokumentkonverters haben Probleme
     beim Laden mancher alter Dokumente, die mit Calamus 1.09 erzeugt
     wurden. Normalerweise wird fr diese Dokumente beim Laden eine Farb-
     sowie Farbebenenliste (fr die Schmuckfarben) erzeugt. Aus irgendeinem
     Grund lt der Konverter in einigen Fllen die Farbebenenliste weg.
     Ab Version 5 ist BOMBADIL in der Lage, diesen Zustand zu erkennen und
     zu beheben. Die Funktionalitt steckt im Clipboard-Bugfix und kann mit
     diesem zusammen ein- und ausgeschaltet werden.

    Mit Betriebssystemerweiterungen wie z.B. WinCom ist es mglich, Fenster
     auch ber den linken Bildschirmrand hinaus zu schieben. Leider reagiert
     Calamus auf solche Aktionen mit sprachloser Systemverwirrung: das
     Fenster wird auf volle Gre aufgeblht und springt ber den Bildschirm.

     Dieser Bugfix sorgt dafr, da Fenster korrekt ber den linken Bildschirm-
     rand geschoben werden knnen.

    Manchmal gert die Stilliste eines Dokuments etwas durcheinander.
     Textrahmen lassen sich nicht mehr formatieren oder nderungen an Stilen
     haben keinerlei Auswirkungen mehr auf das Dokument. In solchen Fllen
     sollte die in BOMBADIL eingebaute Prffunktion auf den Text angewendet
     werden, die "verlorengegangene" Stile wieder richtig in die Stilliste
     einsortieren kann.

    Die vom Rastergenerator erzeugten Caches werden an das jeweilige
     Dokument gehngt und auch mit diesem abgespeichert. Unglcklicherweise
     enthlt der in der 1993er Calamus-Version eingebaute Mechanismus zum
     Lschen von Caches einen Fehler: Rastercaches werden NIE gelscht.
     Dadurch wchst ein Dokument im Laufe der Zeit durch immer mehr Raster-
     caches zu ungeahnten Gren an. Mit Hilfe von BOMBADIL kann man diese
     Caches wieder loswerden.

    Durch bestimmte Aktionen knnen im Dokument Farben mit einem ungltigen
     Format entstehen. Als Folge hiervon ist zum Beispiel der Zugang zum
     Farbformular nicht mehr mglich. Eine bekannte Ursache dieses Problems
     ist das Bridge-Modul: beim Konvertieren von Textrahmen mit unter-
     strichenem Text in Vektorrahmen entstehen regelmig defekte Objekt-
     farben. Dieser Bugfix ist in der Lage, solche Farben zu finden und zu
     reparieren.

    Unter MagiC bzw. MagiCMac kann es zum Absturz oder Systemhnger kommen,
     wenn das Task-Popup (das man beim Klick in die Menleiste erhlt)
     geffnet wird. Schuld daran ist die Tastencodeanzeige in der Kopfzeile
     von Calamus. Der Fehler lt sich auf folgende Art und Weise
     reproduzieren:

     - Klick in die Menleiste um das Popup zu ffnen
     - Mit der Maus in der Kopfzeile hin- und herfahren
     - Die Maus zurck in das Popup bewegen -> das System hngt sich auf
       oder strzt ab

     Mit dem entsprechenden Bugfix lt sich die Tastencodeanzeige abschalten,
     damit es nicht mehr zu diesem Effekt kommen kann.

    Wenn eine Reihe von Bedingungen erfllt ist, strzt Calamus bei der
     Ausgabe von Maskengruppen ab. Der Fehler tritt auf, wenn

     - es sich um invertierte Masken handelt
     - die Ausgabe gedreht erfolgt
     - in einer relativ hohen Auflsung ausgegeben wird

     Schlielich kommt noch ein weitgehend unberechenbares Zufallselement
     hinzu, da dieser Bug mit einer nicht initialisierten Programmvariable
     zusammenhngt. Je nachdem, was gerade an der entsprechenden Speicherstelle
     steht, kommt es zu einem Absturz (2 Bomben) oder nicht.

    Sehr sporadisch kommt es beim Belichten von Seiten mit groen RGB-
     oder CYMK-Bildern zu einem Absturz mit zwei Bomben und dem Zusatzcode
     "PICt, PICt, PICs, MOD SCOS". Je grer der vorhandene Arbeitsspeicher,
     die Bilddaten und die Ausgabeauflsung, desto wahrscheinlicher wird
     dieser Fehler. Bombadil ist in der Lage, den Defekt in der Bildausgabe
     zu finden und zu beheben.
     Dieser Bugfix arbeitet nur auf Calamus-Versionen ab 1994.



   Installation
   ------------
   Installiert wird BOMBADIL wie jedes andere Modul auch:

    Kopieren Sie bitte eine der beiden BOMBADIL-Versionen (BOMBADIL.CXM)
     in den Modul-Ordner Ihres Calamus (entweder aus CAL93\ oder CAL94\ -
     abhngig davon, mit welcher Calamus-Version Sie arbeiten).

    Starten Sie Calamus und laden Sie BOMBADIL.CXM im Formular
     "Externe Module".

    Wenn BOMBADIL beim Starten von Calamus automatisch geladen werden soll,
     dann whlen Sie bitte in der Menleiste unter "SONSTIGES" den Punkt
     "Einstellungen sichern..." an. Speichern Sie die Einstellungen der
     Gruppe "Module" wie gewohnt.



   Bedienung
   ---------
   BOMBADIL wird durch Anwhlen des Moduls und Klick auf "AUSFHREN" im
   Formular "Externe Module" aufgerufen. Es erscheint eine bersicht aller
   eingebauten Funktionen. Klicken Sie auf das jeweilige Icon, um die
   Funktionen zu konfigurieren bzw. aufzurufen.


   Formular "Stile und Farben von ber das Clipboard kopierten Objekten"

      Bugfix ist aktiv
         Wenn angewhlt, so ist die Strukturberprfung eingeschaltet.

      Protollfenster
         Im Protokollfenster werden Informationen ber notwendige Korrekturen
         der Dokumentstruktur angezeigt.

         geschlossen
            Das Fenster bleibt geschlossen.

         im Korrekturfall ffnen
            Sobald BOMBADIL eine Reparaturarbeit erledigt, wird das Fenster
            geffnet und bleibt danach auch offen.

         offen
            Das Fenster wird geffnet.

      Maximal ___ Zeilen
         Hiermit wird festgelegt, wieviel Protokollzeilen sich BOMBADIL im
         Fenster "merken" soll.

      akustisches Signal im Korrekturfall
         Unabhngig vom Protollfenster kann eingestellt werden, ob whrend
         der Reparaturarbeiten ein Klingelton ausgegeben werden soll.

      Alle Einstellungen lassen sich in einer Setup-Datei ablegen (Funktion
      "SPEICHERN"). Dort wird auch die aktuelle Position und Gre des
      Protokollfensters abgelegt.


   Formular "Falsche Stil-Referenzen in Textrahmen"

      Hier knnen Sie zwei Funktionen ausfhren lassen:

      PRFEN
         Smtliche Textstrukturen im aktuellen Dokument werden berprft.

      REPARIEREN
         Zustzlich zur berprfung versucht BOMBADIL, gefundene Defekte
         zu reparieren.

      In beiden Fllen wird nach der Aktion eine Fehler-Statistik angezeigt.


   Formular "Rastercaches knnen nicht gelscht werden (93er Version)"

      Diese Funktion wird normalerweise nur in einem 1993er Calamus
      bentigt. Hier knnen Sie durch Anwhlen von "LSCHEN" smtliche
      Rastercaches wegwerfen lassen.


   Formular "Objektfarben mit ungltigem Format"

      Dieses Formular ist analog zu dem der Text-Prffunktion aufgebaut.
      Es gibt wiederum einen PRFEN und einen REPARIEREN-Knopf, mit denen
      smtliche Farben im aktuellen Dokument kontrolliert werden knnen.
      Zur Reparatur einiger defekter Farben mu BOMBADIL eine Ersatzfarbe
      anlegen, die hinten an die Farbliste angehngt wird. Im Fehler-
      statistik-Formular wird darber Auskunft gegeben.


   Formular "Bewegen von Fenstern ber den linken Bildschirmrand hinaus"
   Formular "ffnen des MagiC Task-Popups kann zum Absturz fhren"
   Formular "Invertierte Masken knnen bei gedrehter Ausgabe abstrzen"

      Alle diese Formulare sind gleich aufgebaut. Sie enthalten einen
      Schalter zum Aktivieren des Bugfixes sowie einen Knopf zum Speichern
      der Einstellungen.


   Registrierungsformular

      BOMBADIL liegt in einer unregistrierten Version vor, die ab und zu
      mit einer Hinweismeldung an diesen Zustand erinnert. Bei Zahlung
      des Shareware-Beitrags erhalten Sie einen Registrierungsschlssel,
      den Sie zusammen mit Ihrem Namen in diesem Formular eingeben.
      Die Registrierungsdaten werden daraufhin automatisch in BOMBADILs
      Setup-Datei abgelegt und beim nchsten mal von dort eingelesen.

      Ist BOMBADIL bereits erfolgreich registriert worden, knnen Name
      und Schlssel in diesem Formular nicht editiert werden. Auerdem
      ist der ABBRUCH-Knopf dann ausgeblendet.

      Nhere Informationen zum Programmstatus sowie zur Registrierung finden
      Sie weiter unten im Text.



   Meldungen
   ---------
   Hier die wichtigsten Meldungen, die BOMBADIL im Protokollfenster
   anzeigen kann:

   "Fehler in Stillisten-Referenzen erkannt und repariert"
    oder
   "Fehler in Farblisten-Referenzen erkannt und repariert"
    oder
   "Fehler in Farbebenenlisten-Referenzen erkannt und repariert"

    In der jeweiligen Struktur wurde ein Fehler entdeckt und beseitigt.
    Diese Meldung ist lediglich als Hinweis zu verstehen. Zustzlich werden
    noch einige weitere Informationen angezeigt:

    "Dokument: <x>"
    "Objekt-ID (alt): <x>"    <- Diese Angaben sind lediglich zu Debugging-
    "Objekt-ID (neu): <x>"    <- Zwecken ntzlich und knnen getrost ignoriert
    "Netz-Koeffizient: <x>"   <- werden.


   "Fehlende Farbebenenliste erkannt und durch neue ersetzt"

    Der Dokumentkonverter hat "vergessen", an ein eben geladenes 1.09N-
    Dokument eine Farbebenenliste zu hngen. Bombadil hat das stattdessen
    erledigt.


   "!! Unerwarteter Fehler <x> in Funktion <y> !!"

    BOMBADIL hat von Calamus Informationen ber das Dokument angefordert und
    dabei eine Fehlermeldung erhalten. Das Dokument hat einen Schaden, den
    BOMBADIL nicht beheben kann.


   "!! Unerwarteter Fehler <x> bei der Reparatur !!"

    Beim Neuverknpfen der Dokumentobjekte wurde von Calamus ein Fehler
    gemeldet. Achtung: Das Dokument ist schwer beschdigt und sollte zur
    Sicherheit unter einem NEUEN Namen abgespeichert werden (die alte
    Version auf der Festplatte kann durchaus noch intakt sein).

   Beim Auftreten unerwarteter Fehler stellt BOMBADIL die berwachung des
   betroffenen Dokuments ein.



   Versionen
   ---------
   Version 1   17.02.95
      Erste verffentlichte Version

   Version 2   02.06.95
      Im Korrekturfall schickt BOMBADIL nun ein Update-Ereignis an alle
      betroffenen Module

      BOMBADIL behebt nun einen weiteren Calamus-Bug: Beim Einsatz von
      Betriebssystemerweiterungen wie z.B. WinCom lassen sich nun die
      Calamus-Fenster links aus dem Bildschirm herausschieben,
      ohne da Calamus dabei ausflippt.

   Version 3   16.08.95
      Die Funktionen zur Textstruktur-berprfung und zum Lschen von
      Rastercaches wurden eingebaut. Die Bedienoberflche wurde
      gendert.

   Version 4   28.11.95
      Die Texte einiger Fehlermeldungen wurden gendert.

   Version 4A  14.02.96
      Sonderversion, die dem Texteditor EDDIE (ab Version 2) beiliegt.
      Entspricht Version 4 mit der in Version 9 vorgenommenen Erweiterung
      des Fenster-Bugfixes.

   Version 5   16.01.96
      Wenn die Farbebenenliste eines Dokuments fehlt, kann BOMBADIL diese
      nun reproduzieren und in das Dokument einhngen. Dieses Problem tritt
      manchmal beim Laden alter 1.09 Dokumente auf.

      Tritt ein unerwarteter Fehler auf, beendet BOMBADIL die berwachung
      des betroffenen Dokuments. Die nervttenden Endlosmeldungen sollten
      damit der Vergangenheit angehren.

   Version 6   18.01.96
      Der Mechanismus zum Reparieren von Objektfarben wurde hinzugefgt.

      BOMBADIL mu nun registriert werden, sonst nervt er ab und zu mit
      einer entsprechenden Hinweismeldung. Ansonsten ist die Funktionalitt
      jedoch nicht eingeschrnkt.

   Version 7   19.01.96
      Der Bugfix fr Task-Popup/Tastencodeanzeige wurde hinzugefgt.

   Version 8   05.02.96
      Beim ffnen des Protokollfensters strzte Bombadil ab, wenn zuerst
      ein defektes Dokument und danach erst Bombadil geladen wurde.

      Die CYMK-Werte der von Bombadil erzeugten Ersatzfarbe werden nun
      richtig gesetzt (C, Y und M auf 0, K aber auf 255).

      Die Bedienung der Prfformulare wurde noch ein wenig effizienter
      gestaltet.

   Version 9   03.06.96
      Der Fenster-Bugfix wurde noch etwas verbessert (ndern der Gre
      eines links aus dem Bildschirm hinausgeschobenen Fensters miachtete
      ein eventuell eingestelltes Snap-Raster).

      Der Maskengruppen-Bugfix wurde hinzugefgt.

   Version 10  14.06.96
      Neuer Bugfix, der den Absturzfehler beim Belichten groer Bilder behebt.

   Version 11  01.07.96
      Der in BOMBADIL 10 eingebaute Bugfix hatte einen Fehler!! Bei der Ausgabe
      von Duochrom-Bildern oder separiertem Drucken von monochromen Bildern
      strzte Calamus immer ab.



   Support
   -------
   Die aktuelle Version von BOMBADIL liegt im ffentlichen Programmteil der
   Maus-Mailbox Kaiserslautern (Maus KL).

   Tel.   : +49-631-17901
   Archiv : BOMBADIL.LZH
   Hinweis: Download fr Nicht-Zahler gesperrt von 7-9 und 17-19 Uhr

   Fragen zu BOMBADIL knnen in der Maus-Gruppe ATARI.DTP gestellt oder direkt
   an den Autor (Harald Siegmund @ KL) gerichtet werden. Verffentlichungen
   von neuen Versionen werden in ATARI.NEWS dokumentiert.



   Nutzungs- und Verbreitungshinweise
   ----------------------------------
   BOMBADIL ist Shareware. Das Modul darf kopiert und an andere weiter-
   gegeben werden, allerdings ausschlielich in der Originalzusammenstellung
   mit allen Dateien. Wenn BOMBADIL Ihnen bei der Arbeit mit Calamus hilft,
   dann bitte ich Sie, den Shareware-Beitrag von DM 20,- auf folgendes Konto
   zu berweisen:

      Sparda Bank Mainz eG
      BLZ 550 905 00
      Konto 300 405

   Bitte geben Sie auch Ihren Namen bei der berweisung mit an! Den
   Registrierungsschlssel knnen Sie sich per PM anfordern bei:
   Harald Siegmund @ KL (im Mausnetz). Sollten Sie keinen Zugang zum
   Mausnetz haben, so tragen Sie bitte auch Ihre vollstndige(!) Anschrift
   in die Betreffzeilen der berweisung ein, damit ich Ihnen den Schlssel
   zukommen lassen kann.

   Solange BOMBADIL nicht registriert ist, erscheint nach dem Verlassen
   des Hauptformulars sowie nach einer bestimmten Anzahl von ausgegebenen
   Zeilen im Protokollfenster eine Hinweismeldung. Ansonsten liegen keine
   Einschrnkungen vor.

   Der Sharewarebeitrag versteht sich ausschlielich als Spende sowie
   Motivation fr den Autor, BOMBADIL und andere Zusatzprogramme rund
   um Calamus zu entwickeln und zu pflegen. Durch die Zahlung des
   Beitrags knnen keine besonderen Ansprche auf Support geltend
   gemacht werden. Es kann auch nicht garantiert werden, da durch
   den Einsatz von BOMBADIL bestimmte Probleme mit Calamus gelst
   werden knnen.

   Die Benutzung von BOMBADIL erfolgt auf eigene Gefahr. Die Software
   wurde vor Freigabe jedoch nach bestem Wissen und Gewissen getestet
   und befindet sich auf meinem Rechner tglich im Einsatz.


   Viel Erfolg mit BOMBADIL wnschen

      Harald Siegmund (Programmautor)
      Raimund Thiel (Textidee)

   -----------------------------------------------------------------------------

   Ein letztes Wort:

      "We apologise for the inconvenience"

   (Douglas Noel Adams)



   Calamus ist ein eingetragenes Warenzeichen der Firma MGI.
