DOC: Expand on usage.
Merge pull request #6489 from jseabold/docs-clarification

DOC: Expand on freq in shift usage.