There have been some conversations in the last weeks which explained several parts of the code, so add it to the source code documentation. Also some other small source code documentation improvements.
Also some Doxygen docu for this class.
This reverts commit a9711895cf.
a9711895cf