javadoc, opacity

the first part of the opacity implementation.
is currently bound to the progress-updates.
Some 'old' javadoc.