diff -r 7ddf4ad61707 -r 51fe9001a679 src/core/trace-source-accessor.h
--- a/src/core/trace-source-accessor.h	Sat May 31 16:14:49 2008 +0100
+++ b/src/core/trace-source-accessor.h	Mon Jun 02 10:30:24 2008 -0700
@@ -74,7 +74,10 @@
  * \param a the trace source
  *
  * Create a TraceSourceAccessor which will control access to the underlying
- * trace source.
+ * trace source. This helper template method assumes that the underlying
+ * type implements a statically-polymorphic set of Connect and Disconnect
+ * methods and creates a dynamic-polymorphic class to wrap the underlying
+ * static-polymorphic class.
  */
 template <typename T>
 Ptr<const TraceSourceAccessor> MakeTraceSourceAccessor (T a);