fixed some typo, improved docblocks