Clarification of comments.

Added better comments and added notice for issue #1