DOC: Expand on freq in shift usage.
I was filing an ENH issue before I noticed that the docstring was telling me how to do what I wanted to do. Added a few lines to clarify this for people who are dense like me.

beautiful....better doc strings always :+1: 
