Added some clarifying comments.
Adding missing doc section.