Document 'lock' semantics.

fixes #20