doc changed
doc string mod
Merge pull request #2929 from fariza/clip-on-doc-warning

clip_on documentation note/warning