improve the comments (resolves #29)