[perl-ldap-checkins] CVS: ldap/lib/Net LDAP.pod,1.27,1.28

[Graham B. <gb...@us...>]

Update of /cvsroot/perl-ldap/ldap/lib/Net
In directory sc8-pr-cvs1:/tmp/cvs-serv26043/lib/Net

Modified Files:
	LDAP.pod 
Log Message:
Add docs about new URLs passing to ->new
Patch from Ziya Suzen


Index: LDAP.pod
===================================================================
RCS file: /cvsroot/perl-ldap/ldap/lib/Net/LDAP.pod,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -d -r1.27 -r1.28
--- LDAP.pod	9 May 2003 13:32:49 -0000	1.27
+++ LDAP.pod	9 May 2003 16:56:49 -0000	1.28
@@ -59,17 +59,31 @@
 =item new ( HOST [, OPTIONS ] )
 
 Creates a new B<Net::LDAP> object and opens a connection to the named host.
-OPTIONS is a list of key-value pairs, valid options are :-
 
-C<HOST> may also be a reference to an array of hosts to try. Each will
-be tried in order until a connection is made. Only when all have
-failed will the result of C<undef> be returned.
+C<HOST> may be a host name or an IP number. TCP port may be specified
+after the host name followed by a column ':' (such as
+localhost:10389). The default TCP port is 389.
+
+You can also specify a URI, such as 'ldaps://127.0.0.1:666' or
+'ldapi://%2fvar%2flib%2fldap_sock'. Note that '%2f's in the LDAPI
+socket path will be translated into '/'. This is to support LDAP query
+options like base, search etc. although query part of the URI will be
+ignored in this context. If port was not specified in the URI, the
+default is either 389 or 636 for 'LDAP' and 'LDAPS' schemes
+respectively.
+
+C<HOST> may also be a reference to an array of hosts, host-port pairs
+or URI's to try. Each will be tried in order until a connection is
+made. Only when all have failed will the result of C<undef> be
+returned.
+
+OPTIONS is a list of key-value pairs, valid options are :-
 
 =over 4
 
 =item port
 
-Port to connect to on the remote server.
+Port to connect to on the remote server. May be overridden by C<HOST>.
 
 =item timeout