Update API doc (when to deallocate, #31).

While at it, fix an error in the alpinocorpus_write and
alpinocorpus_write_corpus: it's not guaranteed that the pointer returned
by exception::what() is still valid outside the catch block.