Allocator: add some ocamldoc

Signed-off-by: David Scott <dave.scott@eu.citrix.com>