fix up the kqueue documentation... comment some things that were left
out that really needed to be here...

Reviewed-by: jlemon