Merge pull request #386 from sean-gilliam/xmldoc-fixes

Fixed xmldoc errors

Author: hazzik

src/NHibernate.Test/Linq/LinqQuerySamples.cs

@@ -281,7 +281,7 @@ public void DLinq17()
 				//q2.ToList();
 
 				///////////
-				/// Batching Select
+				///// Batching Select
 				///////////
 				var dbOrders3 = s.CreateQuery("select o.OrderId from Order o").List<int>();
 

src/NHibernate.Test/NHSpecificTest/NH335/Model.cs

@@ -7,10 +7,9 @@ public class Utils
 		private static Random random = new Random();
 
 		/// <summary>
-		/// Generate a random string of the given length
+		/// Generates a random lowercase alphabetic string
 		/// </summary>
-		/// <param name="length"></param>
-		/// <returns></returns>
+		/// <returns>A string containing random lowercase alphabetic characters</returns>
 		public static string GetRandomID()
 		{
 			int length = 32;

src/NHibernate.Test/NHSpecificTest/NH480/Fixture.cs

@@ -19,7 +19,6 @@ namespace NHibernate.Test.NHSpecificTest.NH480
 	/// </list>
 	/// This test checks that field naming strategies handle this correctly.
 	/// </remarks>
-	/// </summary>
 	[TestFixture]
 	public class Fixture
 	{

src/NHibernate.Test/UtilityTest/StringHelperFixture.cs

@@ -56,28 +56,28 @@ public void CountUnquotedParams()
 			Assert.AreEqual(1, StringHelper.CountUnquoted("abcd ? ef '?' tf", '?'));
 		}
 
-		[Test]
 		/// <summary>
 		/// Try to locate single quotes which isn't allowed
 		/// </summary>
+		[Test]
 		public void CantCountQuotes()
 		{
 			Assert.Throws<ArgumentOutOfRangeException>(() => StringHelper.CountUnquoted("abcd eftf", StringHelper.SingleQuote));
 		}
 
-		[Test]
 		/// <summary>
 		/// Qualify a name with a prefix
 		/// </summary>
+		[Test]
 		public void Qualify()
 		{
 			Assert.AreEqual("a.b", StringHelper.Qualify("a", "b"), "Qualified names differ");
 		}
 
-		[Test]
 		/// <summary>
 		/// Qualify an array of names with a prefix
 		/// </summary>
+		[Test]
 		public void QualifyArray()
 		{
 			string[] simple = { "b", "c" };

src/NHibernate/Collection/Generic/PersistentGenericBag.cs

@@ -37,12 +37,13 @@ public class PersistentGenericBag<T> : AbstractPersistentCollection, IList<T>, I
 		 * expensive than .NET original implementation.
 		 */
 
-		/// For a one-to-many, a <bag> is not really a bag;
-		/// it is *really* a set, since it can't contain the
-		/// same element twice. It could be considered a bug
-		/// in the mapping dtd that <bag> allows <one-to-many>.
-		/// Anyway, here we implement <set> semantics for a
-		/// <one-to-many> <bag>!
+		/* For a one-to-many, a <bag> is not really a bag;
+		 * it is *really* a set, since it can't contain the
+		 * same element twice. It could be considered a bug
+		 * in the mapping dtd that <bag> allows <one-to-many>.
+		 * Anyway, here we implement <set> semantics for a
+		 * <one-to-many> <bag>!
+		 */
 		private IList<T> _gbag;
 
 		public PersistentGenericBag()

src/NHibernate/Engine/BatchFetchQueue.cs

@@ -134,7 +134,6 @@ public void RemoveBatchLoadableEntityKey(EntityKey key)
 		/// <param name="collectionPersister">The persister for the collection role.</param>
 		/// <param name="id">A key that must be included in the batch fetch</param>
 		/// <param name="batchSize">the maximum number of keys to return</param>
-		/// <param name="entityMode">The entity mode.</param>
 		/// <returns>an array of collection keys, of length batchSize (padded with nulls)</returns>
 		public object[] GetCollectionBatch(ICollectionPersister collectionPersister, object id, int batchSize)
 		{

src/NHibernate/Loader/Loader.cs

@@ -661,7 +661,6 @@ protected virtual IResultTransformer ResolveResultTransformer(IResultTransformer
 		/// <summary>
 		/// Are rows transformed immediately after being read from the ResultSet?
 		/// </summary>
-		/// <param name="transformer">The specified result transformer.</param>
 		/// <returns>True, if getResultColumnOrRow() transforms the results; false, otherwise</returns>
 		protected virtual bool AreResultSetRowsTransformedImmediately()
 		{

src/NHibernate/Util/EnumeratorAdapter.cs

@@ -5,7 +5,7 @@
 namespace NHibernate.Util
 {
 	/// <summary>
-	/// Wrap a non-generic IEnumerator to provide the generic IEnumerator&lt>T&gt;
+	/// Wrap a non-generic IEnumerator to provide the generic <see cref="IEnumerator{T}" />
 	/// interface.
 	/// </summary>
 	/// <typeparam name="T">The type of the enumerated elements.</typeparam>