Start the process of documenting bug #15637 and see also ldap_bind()

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@165352 c90b9560-bf6c-de11-be94-00142212c4b1

reference/ldap/functions/ldap-connect.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/ldap.xml, last change in rev 1.2 -->
   <refentry id="function.ldap-connect">
    <refnamediv>
@@ -15,7 +15,12 @@
      </methodsynopsis>
     <para>
      Returns a positive LDAP link identifier on success, or &false; on
-     error.</para>  
+     error.  When OpenLDAP 2.x.x is used, <function>ldap_connect</function> 
+     will always return a <type>resource</type> as it does not actually 
+     connect but just initializes the connecting parameters.  The actual 
+     connect happens with the next calls to ldap_* funcs, usually with 
+     <function>ldap_bind</function>.
+    </para>  
     <para> 
      <function>ldap_connect</function> establishes a connection to a
      LDAP server on a specified <parameter>hostname</parameter> and
@@ -71,6 +76,10 @@ $ldapconn = ldap_connect($ldaphost)
 ]]>
      </programlisting>
     </example>
+    <para>
+     See also
+     <function>ldap_bind</function>.
+    </para>
    </refsect1>
   </refentry>