utils._tempdir: don't leak on exceptions

Angelos Evripiotisrequested to merge
bloomberg/bst/buildstream:rmtempdir into master

Fix a leak and update some relevant docs to make it clearer what's going on.

Merge request reports