source code comments improved