fix some typos in the documentation, make some options more clear