Document presence and usage of ``realm`` parameter

in `ldap_setup`,  `get_ldap_connector`, `ldap_set_login_query`
and `ldap_set_groups_query` API calls.
Merge remote-tracking branch 'lmctv/multiple_named_configurations' into upstream_merges