corrects documentation and adds new info