Rewrite the vm_page_alloc manual page

Document the new allocator variants and flesh out the description of
some details of the page allocator interface.

Reviewed by: kib, alc
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D32035