fixed some typos in comments
added examples of function parameters
added description, usage, and codebook