some improvements to comments and log-file output