libthr.3: describe SIGTHR

Explain how SIGTHR is used and that it should be not touched by user
code. Note about SIGLIBRT.

Reviewed by: emaste
Sponsored by: The FreeBSD Foundation
MFC after: 3 days
Differential revision: https://reviews.freebsd.org/D56384