Add marble diagrams to new operators & variants.

Add javadoc "@deprecated use..." where appropriate.
Some javadoc comment reformatting (e.g. overlong lines).