Description
Currently, the semantics of the table locks require a bit of digging to get the failure handling, and to determine when to use them. Simple additions to the javadoc would make it more convenient for devs whoe are considering using it and for reviewers when they are used.