- added and fixed docblocks
- along the way, fixed two minor typos