Formatting changes to the pthread_testcancel(3).

Use list for the cancellation points enumeration. Move notes about
functions into the list inline.

The discussion of the idiomatic use of cancellation facilities does
not belong to RETURN VALUES section, move it to NOTES.

Sponsored by: The FreeBSD Foundation
MFC after: 2 weeks