adding more comments, updating the manual