signal: move some of the API documentation in signal.h