inconsistent data. Added a detailed comment with explanation.

Added explanation of the semantics for calling the function passed to
the storage tpc_finish method.