New BlockingObservable-specific diagram legend

A new diagram legend spells out the BlockingObservable-specific marble
diagram iconography.
Add javadoc comments to individual OperationFoo files