From bd54ab1ff87a4aeb217ac2ddd4a24e78cc5644fd Mon Sep 17 00:00:00 2001
From: Philip Olson <philip@php.net>
Date: Thu, 5 Aug 2004 05:54:19 +0000
Subject: [PATCH] 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 | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/reference/ldap/functions/ldap-connect.xml b/reference/ldap/functions/ldap-connect.xml
index 8425a21309..58ac928dc4 100644
--- a/reference/ldap/functions/ldap-connect.xml
+++ b/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>