fixed typos in code comments.
fixed erroneous/incomplete method docblocks. punctuation changes.