[Mono-dev] Patches. One exception raising and alot of xmldoc cleanups.

Justin Dearing zippy1981 at gmail.com
Sun Apr 23 08:26:37 EDT 2006


Ok I have a few patches here. The biggest one is for LdapCOnnection. First
of all I updated all the exception xml comments like so:

-<exception> LdapException Thrown if TLS cannot be started.  If a
<exception cref="LdapException">Thrown if TLS cannot be

This makes the docuemntation look correct in NDOC. The mono compiler
complains  that the cref's are not absolute and is assuming
Novell.Directory.Ldap.LdapException. I would lie to fix this but at the
very least the docs look right. I als fixed some case issues where the
comments lists the exception as LDAPException as opposed to LdapException.

I also add a ArgumentNullException for the Search Mothos and update the
comments as appropiate.

The second is for LdapIntermediateResponse.cs Here I change <br> to <br />
in non XMLdoc comments because the microsoft compiler is complaining about
unmatched tags.

The third patch  is LdapUrl.cs. I cleaned up comments. 2 Functions claim to
throw MallFormedURLException which while it exists in Java does not
exist in .NET.
However, they do throw the


The fourth patch is for IntermediateResponseFactory.cs. Replace 2 <br>
tage with <br /> tags.


Below are the patches:

========================================================
========================================================

*** /cygdrive/c/src/CsharpLDAP/Novell.Directory.LDAP/Novell.Directory.Ldap/LdapConnection.cs	Tue
Jul 21 05:57:07 2005
--- LdapConnection.cs	Sun Apr 23 07:55:28 2006
***************
*** 688,694 ****
  		/// by the object.
  		///
  		/// </summary>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
--- 688,694 ----
  		/// by the object.
  		///
  		/// </summary>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
***************
*** 793,799 ****
  		/// connection.
  		///
  		/// </summary>
! 		/// <exception> LdapException Thrown if TLS cannot be started.  If a
  		/// SocketFactory has been specified that does not implement
  		/// LdapTLSSocketFactory an LdapException is thrown.
  		///
--- 793,799 ----
  		/// connection.
  		///
  		/// </summary>
! 		/// <exception cref="LdapException">Thrown if TLS cannot be started.  If a
  		/// SocketFactory has been specified that does not implement
  		/// LdapTLSSocketFactory an LdapException is thrown.
  		///
***************
*** 836,842 ****
          /// <summary> Stops Transport Layer Security(TLS) on the
LDAPConnection and reverts
          /// back to an anonymous state.
          ///
!         /// @throws LDAPException This can occur for the following reasons:
          /// <UL>
          /// <LI>StartTLS has not been called before stopTLS</LI>
          /// <LI>There exists outstanding messages that have not received all
--- 836,842 ----
          /// <summary> Stops Transport Layer Security(TLS) on the
LDAPConnection and reverts
          /// back to an anonymous state.
          ///
!         /// @throws LdapException This can occur for the following reasons:
          /// <UL>
          /// <LI>StartTLS has not been called before stopTLS</LI>
          /// <LI>There exists outstanding messages that have not received all
***************
*** 897,903 ****
  		/// <param name="results">  An object returned from a search.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Abandon(LdapSearchResults results)
--- 897,903 ----
  		/// <param name="results">  An object returned from a search.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Abandon(LdapSearchResults results)
***************
*** 919,925 ****
  		/// <param name="cons">    The contraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Abandon(LdapSearchResults results,
LdapConstraints cons)
--- 919,925 ----
  		/// <param name="cons">    The contraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Abandon(LdapSearchResults results,
LdapConstraints cons)
***************
*** 937,943 ****
  		/// operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Abandon(int id)
--- 937,943 ----
  		/// operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Abandon(int id)
***************
*** 958,964 ****
  		/// <param name="cons">The contraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Abandon(int id, LdapConstraints cons)
--- 958,964 ----
  		/// <param name="cons">The contraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Abandon(int id, LdapConstraints cons)
***************
*** 988,994 ****
  		/// are abandoned, and the queue is emptied.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Abandon(LdapMessageQueue queue)
--- 988,994 ----
  		/// are abandoned, and the queue is emptied.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Abandon(LdapMessageQueue queue)
***************
*** 1011,1017 ****
  		/// <param name="cons">    The contraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Abandon(LdapMessageQueue queue, LdapConstraints cons)
--- 1011,1017 ----
  		/// <param name="cons">    The contraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Abandon(LdapMessageQueue queue, LdapConstraints cons)
***************
*** 1047,1053 ****
  		/// name and attributes of the new entry.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Add(LdapEntry entry)
--- 1047,1053 ----
  		/// name and attributes of the new entry.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Add(LdapEntry entry)
***************
*** 1068,1074 ****
  		/// <param name="cons">   Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		
--- 1068,1074 ----
  		/// <param name="cons">   Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		
***************
*** 1100,1106 ****
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Add(LdapEntry entry,
LdapResponseQueue queue)
--- 1100,1106 ----
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Add(LdapEntry entry,
LdapResponseQueue queue)
***************
*** 1124,1130 ****
  		/// <param name="cons">  Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Add(LdapEntry entry,
LdapResponseQueue queue, LdapConstraints cons)
--- 1124,1130 ----
  		/// <param name="cons">  Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Add(LdapEntry entry,
LdapResponseQueue queue, LdapConstraints cons)
***************
*** 1178,1184 ****
  		/// keeps no long lived instances of these objects.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
--- 1178,1184 ----
  		/// keeps no long lived instances of these objects.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
***************
*** 1219,1225 ****
  		/// keeps no long lived instances of these objects.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
--- 1219,1225 ----
  		/// keeps no long lived instances of these objects.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
***************
*** 1258,1264 ****
  		/// <param name="cons">    Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
--- 1258,1264 ----
  		/// <param name="cons">    Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
***************
*** 1302,1308 ****
  		/// <param name="cons">   The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
--- 1302,1308 ----
  		/// <param name="cons">   The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
***************
*** 1355,1361 ****
  		/// name and passwd as password.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		[CLSCompliantAttribute(false)]
--- 1355,1361 ----
  		/// name and passwd as password.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		[CLSCompliantAttribute(false)]
***************
*** 1394,1400 ****
  		/// <param name="cons">   The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		[CLSCompliantAttribute(false)]
--- 1394,1400 ----
  		/// <param name="cons">   The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		[CLSCompliantAttribute(false)]
***************
*** 1446,1452 ****
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		[CLSCompliantAttribute(false)]
--- 1446,1452 ----
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		[CLSCompliantAttribute(false)]
***************
*** 1488,1494 ****
  		/// <param name="cons">     Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		[CLSCompliantAttribute(false)]
--- 1488,1494 ----
  		/// <param name="cons">     Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		[CLSCompliantAttribute(false)]
***************
*** 1566,1572 ****
  		/// have the value or the attribute.
  		///
  		/// </returns>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual bool Compare(System.String dn, LdapAttribute attr)
--- 1566,1572 ----
  		/// have the value or the attribute.
  		///
  		/// </returns>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual bool Compare(System.String dn, LdapAttribute attr)
***************
*** 1597,1603 ****
  		/// have the value or the attribute.
  		///
  		/// </returns>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual bool Compare(System.String dn, LdapAttribute attr,
LdapConstraints cons)
--- 1597,1603 ----
  		/// have the value or the attribute.
  		///
  		/// </returns>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual bool Compare(System.String dn, LdapAttribute attr,
LdapConstraints cons)
***************
*** 1650,1656 ****
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
--- 1650,1656 ----
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
***************
*** 1687,1693 ****
  		/// <param name="cons">     Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
--- 1687,1693 ----
  		/// <param name="cons">     Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
***************
*** 1744,1750 ****
  		/// port number.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
--- 1744,1750 ----
  		/// port number.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
***************
*** 1808,1814 ****
  		/// <param name="dn">     The distinguished name of the entry to delete.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Delete(System.String dn)
--- 1808,1814 ----
  		/// <param name="dn">     The distinguished name of the entry to delete.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Delete(System.String dn)
***************
*** 1831,1837 ****
  		/// <param name="cons">   Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Delete(System.String dn, LdapConstraints cons)
--- 1831,1837 ----
  		/// <param name="cons">   Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Delete(System.String dn, LdapConstraints cons)
***************
*** 1865,1871 ****
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
--- 1865,1871 ----
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
***************
*** 1892,1898 ****
  		/// <param name="cons">   The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
--- 1892,1898 ----
  		/// <param name="cons">   The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
***************
*** 1926,1932 ****
  		/// unbind request to the server, and then closes the socket.
  		///
  		/// </summary>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
--- 1926,1932 ----
  		/// unbind request to the server, and then closes the socket.
  		///
  		/// </summary>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
***************
*** 1949,1955 ****
  		/// <param name="cons">LDPConstraints to be set with the unbind request
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Disconnect(LdapConstraints cons)
--- 1949,1955 ----
  		/// <param name="cons">LDPConstraints to be set with the unbind request
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Disconnect(LdapConstraints cons)
***************
*** 1991,1997 ****
  		/// string or BER-encoded values.
  		///
  		/// </returns>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapExtendedResponse
ExtendedOperation(LdapExtendedOperation op)
--- 1991,1997 ----
  		/// string or BER-encoded values.
  		///
  		/// </returns>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapExtendedResponse
ExtendedOperation(LdapExtendedOperation op)
***************
*** 2022,2028 ****
  		/// octet string or BER-encoded values.
  		///
  		/// </returns>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		
--- 2022,2028 ----
  		/// octet string or BER-encoded values.
  		///
  		/// </returns>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		
***************
*** 2068,2074 ****
  		/// string or BER-encoded values.
  		///
  		/// </returns>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		
--- 2068,2074 ----
  		/// string or BER-encoded values.
  		///
  		/// </returns>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		
***************
*** 2105,2111 ****
  		/// octet string or BER-encoded values.
  		///
  		/// </returns>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		
--- 2105,2111 ----
  		/// octet string or BER-encoded values.
  		///
  		/// </returns>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		
***************
*** 2166,2172 ****
  		/// <param name="mod">   A single change to be made to the entry.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Modify(System.String dn, LdapModification mod)
--- 2166,2172 ----
  		/// <param name="mod">   A single change to be made to the entry.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Modify(System.String dn, LdapModification mod)
***************
*** 2198,2204 ****
  		/// <param name="cons">    The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Modify(System.String dn, LdapModification
mod, LdapConstraints cons)
--- 2198,2204 ----
  		/// <param name="cons">    The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Modify(System.String dn, LdapModification
mod, LdapConstraints cons)
***************
*** 2229,2235 ****
  		/// <param name="mods">  The changes to be made to the entry.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Modify(System.String dn, LdapModification[] mods)
--- 2229,2235 ----
  		/// <param name="mods">  The changes to be made to the entry.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Modify(System.String dn, LdapModification[] mods)
***************
*** 2260,2266 ****
  		/// <param name="cons">   The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an
  		/// error message and an Ldap error code.
  		/// </exception>
  		public virtual void  Modify(System.String dn, LdapModification[]
mods, LdapConstraints cons)
--- 2260,2266 ----
  		/// <param name="cons">   The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which includes an
  		/// error message and an Ldap error code.
  		/// </exception>
  		public virtual void  Modify(System.String dn, LdapModification[]
mods, LdapConstraints cons)
***************
*** 2305,2311 ****
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Modify(System.String dn,
LdapModification mod, LdapResponseQueue queue)
--- 2305,2311 ----
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Modify(System.String dn,
LdapModification mod, LdapResponseQueue queue)
***************
*** 2340,2346 ****
  		/// <param name="cons">       Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Modify(System.String dn,
LdapModification mod, LdapResponseQueue queue, LdapConstraints cons)
--- 2340,2346 ----
  		/// <param name="cons">       Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Modify(System.String dn,
LdapModification mod, LdapResponseQueue queue, LdapConstraints cons)
***************
*** 2374,2380 ****
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Modify(System.String dn,
LdapModification[] mods, LdapResponseQueue queue)
--- 2374,2380 ----
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Modify(System.String dn,
LdapModification[] mods, LdapResponseQueue queue)
***************
*** 2409,2415 ****
  		/// <param name="cons">      Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Modify(System.String dn,
LdapModification[] mods, LdapResponseQueue queue, LdapConstraints
cons)
--- 2409,2415 ----
  		/// <param name="cons">      Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Modify(System.String dn,
LdapModification[] mods, LdapResponseQueue queue, LdapConstraints
cons)
***************
*** 2442,2448 ****
  		/// <returns> the LdapEntry read from the server.
  		///
  		/// </returns>
! 		/// <exception> LdapException if the object was not found
  		/// </exception>
  		public virtual LdapEntry Read(System.String dn)
  		{
--- 2442,2448 ----
  		/// <returns> the LdapEntry read from the server.
  		///
  		/// </returns>
! 		/// <exception cref="LdapException">if the object was not found
  		/// </exception>
  		public virtual LdapEntry Read(System.String dn)
  		{
***************
*** 2465,2471 ****
  		/// <returns> the LdapEntry read from the server
  		///
  		/// </returns>
! 		/// <exception> LdapException if the object was not found
  		/// </exception>
  		public virtual LdapEntry Read(System.String dn, LdapSearchConstraints cons)
  		{
--- 2465,2471 ----
  		/// <returns> the LdapEntry read from the server
  		///
  		/// </returns>
! 		/// <exception cref="LdapException">if the object was not found
  		/// </exception>
  		public virtual LdapEntry Read(System.String dn, LdapSearchConstraints cons)
  		{
***************
*** 2486,2492 ****
  		/// <returns> the LdapEntry read from the server
  		///
  		/// </returns>
! 		/// <exception> LdapException if the object was not found
  		/// </exception>
  		public virtual LdapEntry Read(System.String dn, System.String[] attrs)
  		{
--- 2486,2492 ----
  		/// <returns> the LdapEntry read from the server
  		///
  		/// </returns>
! 		/// <exception cref="LdapException">if the object was not found
  		/// </exception>
  		public virtual LdapEntry Read(System.String dn, System.String[] attrs)
  		{
***************
*** 2510,2516 ****
  		/// <returns> the LdapEntry read from the server
  		///
  		/// </returns>
! 		/// <exception> LdapException if the object was not found
  		/// </exception>
  		public virtual LdapEntry Read(System.String dn, System.String[]
attrs, LdapSearchConstraints cons)
  		{
--- 2510,2518 ----
  		/// <returns> the LdapEntry read from the server
  		///
  		/// </returns>
! 		/// <exception cref="System.ArgumentNullException"> base_Renamed is null.
! 		/// </exception>
! 		/// <exception cref="LdapException">if the object was not found
  		/// </exception>
  		public virtual LdapEntry Read(System.String dn, System.String[]
attrs, LdapSearchConstraints cons)
  		{
***************
*** 2548,2554 ****
  		/// <returns> The entry specified by the base DN.
  		///
  		/// </returns>
! 		/// <exception> LdapException if the object was not found
  		/// </exception>
  		public static LdapEntry Read(LdapUrl toGet)
  		{
--- 2550,2556 ----
  		/// <returns> The entry specified by the base DN.
  		///
  		/// </returns>
! 		/// <exception cref="LdapException">if the object was not found
  		/// </exception>
  		public static LdapEntry Read(LdapUrl toGet)
  		{
***************
*** 2582,2588 ****
  		/// <param name="cons">      Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException if the object was not found
  		/// </exception>
  		public static LdapEntry Read(LdapUrl toGet, LdapSearchConstraints cons)
  		{
--- 2584,2590 ----
  		/// <param name="cons">      Constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">if the object was not found
  		/// </exception>
  		public static LdapEntry Read(LdapUrl toGet, LdapSearchConstraints cons)
  		{
***************
*** 2612,2618 ****
  		/// retained as an attribute value.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Rename(System.String dn, System.String
newRdn, bool deleteOldRdn)
--- 2614,2620 ----
  		/// retained as an attribute value.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Rename(System.String dn, System.String
newRdn, bool deleteOldRdn)
***************
*** 2640,2646 ****
  		/// <param name="cons">          The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Rename(System.String dn, System.String
newRdn, bool deleteOldRdn, LdapConstraints cons)
--- 2642,2648 ----
  		/// <param name="cons">          The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Rename(System.String dn, System.String
newRdn, bool deleteOldRdn, LdapConstraints cons)
***************
*** 2669,2675 ****
  		/// retained as an attribute value.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Rename(System.String dn, System.String
newRdn, System.String newParentdn, bool deleteOldRdn)
--- 2671,2677 ----
  		/// retained as an attribute value.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Rename(System.String dn, System.String
newRdn, System.String newParentdn, bool deleteOldRdn)
***************
*** 2702,2708 ****
  		/// <param name="cons">          The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Rename(System.String dn, System.String
newRdn, System.String newParentdn, bool deleteOldRdn, LdapConstraints
cons)
--- 2704,2710 ----
  		/// <param name="cons">          The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual void  Rename(System.String dn, System.String
newRdn, System.String newParentdn, bool deleteOldRdn, LdapConstraints
cons)
***************
*** 2745,2751 ****
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Rename(System.String dn,
System.String newRdn, bool deleteOldRdn, LdapResponseQueue queue)
--- 2747,2753 ----
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Rename(System.String dn,
System.String newRdn, bool deleteOldRdn, LdapResponseQueue queue)
***************
*** 2776,2782 ****
  		/// <param name="cons">          The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Rename(System.String dn,
System.String newRdn, bool deleteOldRdn, LdapResponseQueue queue,
LdapConstraints cons)
--- 2778,2784 ----
  		/// <param name="cons">          The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Rename(System.String dn,
System.String newRdn, bool deleteOldRdn, LdapResponseQueue queue,
LdapConstraints cons)
***************
*** 2808,2814 ****
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Rename(System.String dn,
System.String newRdn, System.String newParentdn, bool deleteOldRdn,
LdapResponseQueue queue)
--- 2810,2816 ----
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Rename(System.String dn,
System.String newRdn, System.String newParentdn, bool deleteOldRdn,
LdapResponseQueue queue)
***************
*** 2844,2850 ****
  		/// <param name="cons">          The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Rename(System.String dn,
System.String newRdn, System.String newParentdn, bool deleteOldRdn,
LdapResponseQueue queue, LdapConstraints cons)
--- 2846,2852 ----
  		/// <param name="cons">          The constraints specific to the operation.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapResponseQueue Rename(System.String dn,
System.String newRdn, System.String newParentdn, bool deleteOldRdn,
LdapResponseQueue queue, LdapConstraints cons)
***************
*** 2896,2902 ****
  		/// names and values for attributes found.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapSearchResults Search(System.String
base_Renamed, int scope, System.String filter, System.String[] attrs,
bool typesOnly)
--- 2898,2906 ----
  		/// names and values for attributes found.
  		///
  		/// </param>
! 		/// <exception cref="System.ArgumentNullException"> base_Renamed is null.
! 		/// </exception>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapSearchResults Search(System.String
base_Renamed, int scope, System.String filter, System.String[] attrs,
bool typesOnly)
***************
*** 2945,2951 ****
  		/// <param name="cons">          The constraints specific to the search.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapSearchResults Search(System.String
base_Renamed, int scope, System.String filter, System.String[] attrs,
bool typesOnly, LdapSearchConstraints cons)
--- 2949,2957 ----
  		/// <param name="cons">          The constraints specific to the search.
  		///
  		/// </param>
! 		/// <exception cref="ArgumentNullException"> base_Renamed is null.
! 		/// </exception>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapSearchResults Search(System.String
base_Renamed, int scope, System.String filter, System.String[] attrs,
bool typesOnly, LdapSearchConstraints cons)
***************
*** 2990,2996 ****
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapSearchQueue Search(System.String base_Renamed,
int scope, System.String filter, System.String[] attrs, bool
typesOnly, LdapSearchQueue queue)
--- 2996,3004 ----
  		/// queue object is created internally.
  		///
  		/// </param>
! 		/// <exception cref="ArgumentNullException"> base_Renamed is null.
! 		/// </exception>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapSearchQueue Search(System.String base_Renamed,
int scope, System.String filter, System.String[] attrs, bool
typesOnly, LdapSearchQueue queue)
***************
*** 3037,3047 ****
  		/// <param name="cons">          The constraints specific to the search.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapSearchQueue Search(System.String base_Renamed,
int scope, System.String filter, System.String[] attrs, bool
typesOnly, LdapSearchQueue queue, LdapSearchConstraints cons)
  		{
  			if ((System.Object) filter == null)
  			{
  				filter = "objectclass=*";
--- 3045,3061 ----
  		/// <param name="cons">          The constraints specific to the search.
  		///
  		/// </param>
! 		/// <exception cref="ArgumentNullException"> base_Renamed is null.
! 		/// </exception>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public virtual LdapSearchQueue Search(System.String base_Renamed,
int scope, System.String filter, System.String[] attrs, bool
typesOnly, LdapSearchQueue queue, LdapSearchConstraints cons)
  		{
+ 			if (base_Renamed == null)
+ 			{
+ 				throw new ArgumentNullException("base_Renamed");
+ 			}			
  			if ((System.Object) filter == null)
  			{
  				filter = "objectclass=*";
***************
*** 3084,3090 ****
  		/// <param name="toGet">The Ldap URL specifying the entry to read.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public static LdapSearchResults Search(LdapUrl toGet)
--- 3098,3104 ----
  		/// <param name="toGet">The Ldap URL specifying the entry to read.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public static LdapSearchResults Search(LdapUrl toGet)
***************
*** 3120,3126 ****
  		/// <param name="cons">          The constraints specific to the search.
  		///
  		/// </param>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public static LdapSearchResults Search(LdapUrl toGet,
LdapSearchConstraints cons)
--- 3134,3140 ----
  		/// <param name="cons">          The constraints specific to the search.
  		///
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		public static LdapSearchResults Search(LdapUrl toGet,
LdapSearchConstraints cons)
***************
*** 3162,3168 ****
  		/// response to this request. If it is null, a
  		/// queue object is created internally.
  		/// </param>
! 		/// <exception>     LdapException A general exception which
includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
--- 3176,3182 ----
  		/// response to this request. If it is null, a
  		/// queue object is created internally.
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
***************
*** 3196,3202 ****
  		/// </param>
  		/// <param name="cons">   The constraints that apply to this request
  		/// </param>
! 		/// <exception>     LdapException A general exception which
includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
--- 3210,3216 ----
  		/// </param>
  		/// <param name="cons">   The constraints that apply to this request
  		/// </param>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		///
  		/// </exception>
***************
*** 3276,3282 ****
  		/// <returns> the LdapResponseQueue for this request
  		///
  		/// </returns>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		private LdapResponseQueue SendRequestToServer(LdapMessage msg, int
timeout, LdapResponseQueue queue, BindProperties bindProps)
--- 3290,3296 ----
  		/// <returns> the LdapResponseQueue for this request
  		///
  		/// </returns>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		private LdapResponseQueue SendRequestToServer(LdapMessage msg, int
timeout, LdapResponseQueue queue, BindProperties bindProps)
***************
*** 3515,3521 ****
  		/// if there were none.
  		///
  		/// </returns>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		/* package */
--- 3529,3535 ----
  		/// if there were none.
  		///
  		/// </returns>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		/* package */
***************
*** 3649,3655 ****
  		/// <returns> a new LdapMessage with appropriate information replaced
  		///
  		/// </returns>
! 		/// <exception> LdapException A general exception which includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		private LdapMessage rebuildRequest(LdapMessage msg, LdapUrl url,
bool reference)
--- 3663,3669 ----
  		/// <returns> a new LdapMessage with appropriate information replaced
  		///
  		/// </returns>
! 		/// <exception cref="LdapException">A general exception which
includes an error
  		/// message and an Ldap error code.
  		/// </exception>
  		private LdapMessage rebuildRequest(LdapMessage msg, LdapUrl url,
bool reference)
***************
*** 3741,3747 ****
  		/// will be empty.
  		///
  		/// </returns>
! 		/// <exception> LDAPException     This exception occurs if the schema entry
  		/// cannot be retrieved with this connection.
  		/// </exception>
  		/// <seealso cref="GetSchemaDN()">
--- 3755,3761 ----
  		/// will be empty.
  		///
  		/// </returns>
! 		/// <exception cref="LdapException">This exception occurs if the
schema entry
  		/// cannot be retrieved with this connection.
  		/// </exception>
  		/// <seealso cref="GetSchemaDN()">
***************
*** 3768,3774 ****
  		/// <returns>     Distinguished Name of a schema entry in effect for the
  		/// Directory.
  		/// </returns>
! 		/// <exception> LDAPException     This exception occurs if the schema DN
  		/// cannot be retrieved, or if the subschemaSubentry attribute associated
  		/// with the root DSE contains multiple values.
  		///
--- 3782,3788 ----
  		/// <returns>     Distinguished Name of a schema entry in effect for the
  		/// Directory.
  		/// </returns>
! 		/// <exception cref="LdapException">This exception occurs if the schema DN
  		/// cannot be retrieved, or if the subschemaSubentry attribute associated
  		/// with the root DSE contains multiple values.
  		///
***************
*** 3798,3804 ****
  		/// identified by <code>dn</code>.
  		///
  		/// </returns>
! 		/// <exception> LDAPException     This exception occurs if a null or empty
  		/// value is passed as dn, if the subschemasubentry attribute cannot
  		/// be retrieved, or the subschemasubentry contains multiple values.
  		///
--- 3812,3818 ----
  		/// identified by <code>dn</code>.
  		///
  		/// </returns>
! 		/// <exception cref="LdapException">This exception occurs if a null or empty
  		/// value is passed as dn, if the subschemasubentry attribute cannot
  		/// be retrieved, or the subschemasubentry contains multiple values.
  		///

========================================================
========================================================

*** /cygdrive/c/src/CsharpLDAP/Novell.Directory.LDAP/Novell.Directory.Ldap/LdapIntermediateResponse.cs	Thu
Sep 16 07:46:36 2004
--- LdapIntermediateResponse.cs	Thu Apr 20 00:33:33 2006
***************
*** 57,63 ****
  	 *  LdapIntermediateResponse. </p>
  	 *
  	 * @param oid            The object identifier of the control.
! 	 * <br><br>
  	 * @param extendedResponseClass  A class which can instantiate an
  	 *                                LdapIntermediateResponse.
  	 */
--- 57,63 ----
  	 *  LdapIntermediateResponse. </p>
  	 *
  	 * @param oid            The object identifier of the control.
! 	 * <br /><br />
  	 * @param extendedResponseClass  A class which can instantiate an
  	 *                                LdapIntermediateResponse.
  	 */


========================================================
========================================================

*** /cygdrive/c/src/CsharpLDAP/Novell.Directory.LDAP/Novell.Directory.Ldap/LdapUrl.cs	Sun
Apr 23 06:06:12 2006
--- LdapUrl.cs	Sun Apr 23 06:02:47 2006
***************
*** 42,49 ****
  	/// search results.
  	///
  	/// </summary>
! 	/// <seealso cref="LdapConnection.Search">
! 	/// </seealso>
  	public class LdapUrl : System.ICloneable
  	{
  		private void  InitBlock()
--- 42,48 ----
  	/// search results.
  	///
  	/// </summary>
! 	/// <seealso cref="LdapConnection.Search" />
  	public class LdapUrl : System.ICloneable
  	{
  		private void  InitBlock()
***************
*** 180,190 ****
  		///
  		/// </summary>
  		/// <param name="url">     An Ldap URL string, e.g.
! 		/// "ldap://ldap.example.com:80/dc=example,dc=com?cn,
! 		/// sn?sub?(objectclass=inetOrgPerson)".
  		///
  		/// </param>
! 		/// <exception> MalformedURLException The specified URL cannot be parsed.
  		/// </exception>
  		public LdapUrl(System.String url)
  		{
--- 179,189 ----
  		///
  		/// </summary>
  		/// <param name="url">     An Ldap URL string, e.g.
! 		/// <code>"ldap://ldap.example.com:80/dc=example,dc=com?cn,
! 		/// sn?sub?(objectclass=inetOrgPerson)".</code>
  		///
  		/// </param>
! 		/// <exception cref="System.UriFormatException"> The specified URL
cannot be parsed.
  		/// </exception>
  		public LdapUrl(System.String url)
  		{
***************
*** 368,374 ****
  		/// <returns> The decoded string.
  		///
  		/// </returns>
! 		/// <exception> MalformedURLException The URL could not be parsed.
  		/// </exception>
  		public static System.String decode(System.String URLEncoded)
  		{
--- 367,373 ----
  		/// <returns> The decoded string.
  		///
  		/// </returns>
! 		/// <exception cref="System.UriFormatException"> The URL could not
be parsed.
  		/// </exception>
  		public static System.String decode(System.String URLEncoded)
  		{


========================================================
========================================================


--- C:\src\CsharpLDAP\Novell.Directory.LDAP\Novell.Directory.Ldap.Utilclass\IntermediateResponseFactory.cs	Thu
Sep 16 07:46:36 2004
+++ C:\src\CsharpLDAP_zippy\Novell.Directory.LDAP\Novell.Directory.Ldap.Utilclass\IntermediateResponseFactory.cs	Thu
Apr 20 00:51:17 2006
@@ -58,7 +58,7 @@
      *
      * @param inResponse   The LDAPIntermediateResponse object as
returned by the
      *                     extendedOperation method in the
LDAPConnection object.
-     * <br><br>
+     * <br /><br />
      * @return An object of base class LDAPIntermediateResponse.  The
actual child
      *         class of this returned object depends on the operation being
      *         performed.



More information about the Mono-devel-list mailing list