clarify input documentation
Merge pull request #2533 from jasonkriss/patch-1

clarify input documentation