# HG changeset patch
# User Chris Cannam
# Date 1586848763 -3600
# Node ID 7faa08747f5e79b7e606ece8abc5791d934d8a08
# Parent  915d316a56096206443ac2a4dc3dad7cc1fd70e3
Comments

diff -r 915d316a5609 -r 7faa08747f5e base/ById.h
--- a/base/ById.h	Thu Apr 09 14:59:05 2020 +0100
+++ b/base/ById.h	Tue Apr 14 08:19:23 2020 +0100
@@ -67,6 +67,11 @@
  * shared_ptr, then the object being pointed to can't be deleted while
  * that shared_ptr is in scope.
  *
+ * The result is like using weak_ptr references to a shared_ptr whose
+ * ownership is within a "layer" (at "application level") rather than
+ * managed by a specific object. A human-readable id representation is
+ * also quite useful for debugging.
+ *
  * Example:
  *
  * class Thing : public WithTypedId<Thing> { Thing(int x) { } };
@@ -182,7 +187,7 @@
     
     /**
      * Return an id for this object. The id is a unique value for this
-     * object among all objects that implement WithTypedId within this
+     * object among all objects that implement WithId within this
      * single run of the application.
      */
     Id getId() const {