s3:docs: document ldap deref

diff --git a/docs-xml/smbdotconf/ldap/ldapderef.xml b/docs-xml/smbdotconf/ldap/ldapderef.xml
new file mode 100644 (file)
index 0000000..e4868a6
--- /dev/null
+++ b/docs-xml/smbdotconf/ldap/ldapderef.xml
@@ -0,0 +1,21 @@
+<samba:parameter name="ldap deref" context="G" type="enum"
+       advanced="1" developer="1"
+       xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+
+<description>
+
+       <para>This option controls whether Samba should tell the LDAP library
+       to use a certain alias dereferencing method. The default is
+       <emphasis>auto</emphasis>, which means that the default setting of the
+       ldap client library will be kept. Other possible values are
+       <emphasis>never</emphasis>, </emphasis>finding</emphasis>,
+       </emphasis>searching</emphasis> and <emphasis>always</emphasis>. Grab
+       your LDAP manual for more information.
+       </para>
+
+</description>
+
+<value type="default">auto</value>
+<value type="example">searching</value>
+
+</samba:parameter>