(fixes #313) update documentation for locks