more javadocs and non-blocking commands