I like that you wrote javadocs for this, but the explanation I find a bit garbled - it's explaining it's behaviour with reference to internal methods that the API user can't see. I bet you can find a clearer explanation of what this does.