Good catch. Documentation needs to be updated.
As for rdr-to and divert-to, a simple description of the differences can be found here:
http://www.openbsd.org/faq/upgrade50.html#pf
If you like, you can give back to the project by submitting diffs for spamd(8) and the PF User's Guide.