better documentation of the client specific configuration, fixes #12