add docs and javadsl

* also found a type bug in javadsl Source.subscriber