documentation for allocate_pages

I was unable to tell what boot::allocate_pages returned without looking into the actual code since it's returning a u8, maybe a good spot to add more documentation? https://docs.rs/uefi/latest/uefi/boot/fn.allocate_pages.html