DOC: minor changes: fix reference formatting, change wording
Merge pull request #437 from endolith/docstring_cleanup

DOC: signal: minor changes, fix reference formatting, change wording