From a666885598d97f8e98bd40c934197bb110cdba7e Mon Sep 17 00:00:00 2001
From: Markus Ewald <cygon@nuclex.org>
Date: Thu, 17 Jul 2008 20:51:35 +0000
Subject: [PATCH] Some more minor documentation improvements

git-svn-id: file:///srv/devel/repo-conversion/nusu@81 d2e56fa2-650e-0410-a79f-9358c0239efd
---
 Source/Collections/ObservableCollection.cs | 7 ++++++-
 Source/WeakReference.cs                    | 2 +-
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/Source/Collections/ObservableCollection.cs b/Source/Collections/ObservableCollection.cs
index c33a956..cd87636 100644
--- a/Source/Collections/ObservableCollection.cs
+++ b/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>
diff --git a/Source/WeakReference.cs b/Source/WeakReference.cs
index 3ddba72..0550afd 100644
--- a/Source/WeakReference.cs
+++ b/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