hwpmc(4): document debugging options

The debug options for hwpmc are not documented in detail anywhere, and
setting it up was error-prone the first time I had to figure it out (and
each time I've had to remember it). Add some explanation of the required
options and describe the kern.hwpmc.debugflags sysctl format.

Reviewed by: emaste
MFC after: 1 week
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D40545

(cherry picked from commit 5fc97cc32553c4073c7dafd67a2d489b8af8563e)
(cherry picked from commit 89240e0ab60a29a47c9af9f952a09a7f2e1bb72c)