/**
* Custom status handler for handling scenarios which are
- * not handled by the editor (e.g. runtime exceptions)
+ * not handled by the editor (e.g. runtime exceptions).
+ *
+ * The default {@link org.eclipse.ui.statushandlers.WorkbenchErrorHandler}
+ * is not used or extended because we need a handler for specific scenarios
+ * which displays a custom built error dialog.
*
* @author cmathew
*