Error plugins are preloaded and get called by Bricklayer when it encounters a fatal error or wishes to log something. Error plugins will get passed a message and message type. The two predefined types are fatal and log. Fatal errors mean Bricklayer can no longer continue and must die. The error handler plugins don't have to handle this if they don't want to since Bricklayer will do it automatically. log messages mean Bricklayer just want's to preserve this for posterity. Error handlers may want to write it to a file or or store it elsewhere. Bricklayer also provides a convenient repository for log messages in the $BK_Obj->Log location. You may wish your handler to store them there. Heck you might even want a handler to provide an XML feed of fatal or log messages for you to keep track of. Why Not?
Jeremy Wall
2006-08-21
