fix compilation warning
some improvements to the object-oriented explanations