added an explanation for the logging call - fixes #636