Just some more docs, to be clear about functionality and, most importantly, pointer ownership. No functional changes.