some comments and a small fix