COMMITTOR: better documentation and error checking