improved readability and documentation in db files