updated documentation to describe options in more detail