Update documentation

give description of new parameters and details on how to use them.
Update other parts of the document to put parameters in order based on
most-critical to least-critical