
   BOMBADIL - Operating instructions
   -----------------------------------------------------------------------------
   BOMBADIL  is called by selecting the module and clicking on "Execute" 
   in the "External Modules" dialog. An overview of all available 
   functions appears. Double-clicking on the relevant icon calls up the 
   corresponding function.


   "Styles and colours of objects copied via the clipboard" dialog
   ---------------------------------------------------------------
   Bugfix is activated
      If this checkbox is selected (crossed) then checking of the 
      document structure is switched on.

   Protocol Window
      Information about required corrections of the document structure 
      are displayed in the Protocol (log) window. The three radio buttons 
      determine how this window is to behave:

      closed
         The window remains closed.

       open on bug correction
         As soon as BOMBADIL has finished its repair the window will 
         be opened and remains open afterwards.

       open
         The window will be opened.

       Maximum ___ lines
         This specifies how many protocol (log) lines in the window 
         Bombadil should "remember".

       Acoustic signal on bug correction
         Independent of the protocol window, you can choose whether a 
         "ping" should sound during repair work by activating this 
         checkbox.

   With the ""Save"" button, all settings may be saved in a setup file 
   BOMBADIL.SET in the MODULES folder. The current position and size of 
   the protocol window is stored there as well.


   "Wrong style references in text frames" dialog
   ----------------------------------------------
   Here you can execute two functions:

   Check
      All text structures in the current document will be checked.

   Repair
      In addition to checking, BOMBADIL tries to repair any defects 
      found.

   In both cases error statistics are displayed after the action is 
   complete.


   "Raster caches cannot be erased (SL93 version)" dialog
   ------------------------------------------------------
   This function is normally required only in Calamus SL93. By selecting  
   "Erase" all raster caches can be cleared.


   "Object colours with invalid format" dialog
   -------------------------------------------
   This dialog box is built up in a similar way to the text checking 
   function. There are again "Check" and "Repair" buttons with which all 
   colours in the current document can be checked. For repairing some 
   defective colours BOMBADIL has to create a replacement colour that is 
   appended to the colour list. Information about this is displayed in 
   the error statistics dialog.


   "Moving windows over the left screen border offscreen" dialog
   "Calling the MagiC Task popup can cause system crashes" dialog
   "Inverted masks can cause crashes on rotated output" dialog
   "Lack of memory on print can cause crashes" dialog
   ---------------------------------------------------------------
   All these dialogs are constructed in the same way. They contain a 
   switch for activating the bugfix as well as a button for saving the 
   settings.


   Messages
   ---------
   Here are the most important messages that BOMBADIL may display in the 
   protocol window:

   "Error in Style List References found and repaired"
    or
   "Error in Colour List References found and repaired"
    or
   "Error in Colour Layer List References found and repaired"

    Errors were found and repaired in the relevant structure.
    This message should be understood purely as a reference. In addition 
    some further information is displayed:

    "Document: <x>"
    "Object ID (old): <x>"   <- This data is only useful 
    "Object ID (new): <x>"   <- for debugging purposes and
    "Net Coefficient: <x>"   <- may be safely ignored. 


   "Missed Colour Layer List found and replaced"

    The document converter has "forgotten" to append a colour layer 
    list to a newly-loaded 1.09N document. BOMBADIL has remedied this.


   "!! Unexpected Error <x> in Function <y> !!"

    BOMBADIL has requested information about the document from Calamus 
    and received an error message during this. The document is damaged in 
    a way that BOMBADIL can not remedy.


   "!! Unexpected Error <x> on repair !!"

    Calamus has reported an error while reconnecting the document objects.
    Warning: The document is seriously damaged and for safety's sake 
    should be saved under a NEW name (the old version on your hard disk 
    may well still be intact).

   When unexpected errors appear, BOMBADIL terminates the checking of 
   the document affected.



   Calamus is a registered trademark of the company MGI.

