Many updates to respond to review

- improve argument descriptions
- improve clarity about the meaning of parameter value 0s
- clarify behavior of compress/flush
- many more clarifications/wording improvements

Author: emmatyping