[bcm283x_pwm] Add documentation for the second PWM channel

Document sysctls for the second PWM channel added in r335855
Also fix some minor style issues and a typo.

Approved by: re (gjb)
Submitted by: bobf@mrp3.com
Reviewed by: 0mp
Differential Revision: https://reviews.freebsd.org/D17084