Clarified blocking behavior in javadoc. Submitted by: Janek Bogucki Reviewed/Edited by: Phil Steitz Pr #23234