More detailed error message.
Add doc about the clients field.
Typos, clarification of documentation.
typo
Merge pull request #1987 from nouiz/doc

Doc