Add some additional clarification and fix a few gammer nits.

Reviewed by: kib
MFC after:   3 weeks
Bump Dd for r275846

MFC after:	3 weeks