first pass at javadocs for new backpressure stuff