docs: Explain why this option should not be used

Signed-off-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: Andreas Schneider <asn@samba.org>
Autobuild-User(master): Andrew Bartlett <abartlet@samba.org>
Autobuild-Date(master): Tue Oct 15 01:51:39 CEST 2013 on sn-devel-104

diff --git a/docs-xml/smbdotconf/winbind/winbinddsocketdirectory.xml b/docs-xml/smbdotconf/winbind/winbinddsocketdirectory.xml
index 1f8c5797bdc5e5dca169257f242e0b0521399f31..5fd32ffb3ea9e87d7af93fd44e013245b8cf42ba 100644 (file)
--- a/docs-xml/smbdotconf/winbind/winbinddsocketdirectory.xml
+++ b/docs-xml/smbdotconf/winbind/winbinddsocketdirectory.xml
@@ -5,6 +5,11 @@
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
        <para>This setting controls the location of the winbind daemon's socket.</para>
+       <para>Except within automated test scripts, this should not be
+       altered, as the client tools (nss_winbind etc) do not honour
+       this parameter.  Client tools must then be advised of the
+       altered path with the WINBINDD_SOCKET_DIR environment
+       varaible.</para>
 </description>
 
 <related>winbindd privileged socket directory</related>