Document the new/delete semantics

There is more to do on documentation, but since these are new,
add documentation for them first.