Complete the javadocs for the DSL interfaces

A lot of the DSL methods have no or incomplete javadocs. We should complete the javadocs and enhance it with examples.

Personally I think that due to the deeply nested interfaces the javadocs will be hard to follow in the html version, but many IDEs support to display javadocs while typing and there the docs could be very useful to explore the API.