Updated documentation.
Tried to answer some of the questions that have been asked recently on
the mailing list.