document signal severity
Merge pull request #4799 from rolandwalker/doc_signals

document signal severity