api returns: document/test delete-tree return

Step 3c for
#197 (comment),
document existing `delete-tree` return.

Tests for `delete-tree` adjusted to appropriately.

Author: lread