better formatting/docs
Updates for Mike's comments:
 - improved documentation
 - add SwatDBFlushable interface for SwatDBDataObject and
   SwatDBRecordsetWrapper