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> ItemAdded; /// Raised when an item is removed from the collection public event EventHandler> ItemRemoved; - /// Raised the collection is about to be cleared + /// Raised when the collection is about to be cleared + /// + /// 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. + /// public event EventHandler Clearing; /// 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 { /// - /// 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. /// public class WeakReference : WeakReference