DOC: Yaroslav's corrections.
DOC: Most of rev #3 comments.
DOC: Removed pp likelihood.
DOC: Final rev #3 comments.