Some more minor documentation improvements

git-svn-id: file:///srv/devel/repo-conversion/nusu@81 d2e56fa2-650e-0410-a79f-9358c0239efd

Source/Collections/ObservableCollection.cs

@@ -31,7 +31,12 @@ namespace Nuclex.Support.Collections {
     public event EventHandler<ItemEventArgs<ItemType>> ItemAdded;
     /// <summary>Raised when an item is removed from the collection</summary>
     public event EventHandler<ItemEventArgs<ItemType>> ItemRemoved;
-    /// <summary>Raised the collection is about to be cleared</summary>
+    /// <summary>Raised when the collection is about to be cleared</summary>
+    /// <remarks>
+    ///   This could be covered by calling ItemRemoved for each item currently
+    ///   contained in the collection, but it is often simpler and more efficient
+    ///   to process the clearing of the entire collection as a special operation.
+    /// </remarks>
     public event EventHandler Clearing;
 
     /// <summary>

Source/WeakReference.cs

@@ -25,7 +25,7 @@ using System.Runtime.Serialization;
 namespace Nuclex.Support {
 
   /// <summary>
-  ///   Represents a weak reference, which references an object while still allowing
+  ///   Type-safe weak reference, referencing an object while still allowing
   ///   that object to be garbage collected.
   /// </summary>
   public class WeakReference<ReferencedType> : WeakReference