pf.conf.5: rephrase log() documentation

after some discussion with henning, document the various log options as
one section; some text was altered to make it read better;

ok henning

Obtained from: OpenBSD, jmc <jmc@openbsd.org>, cea6f9db1f
Sponsored by: Rubicon Communications, LLC ("Netgate")