Index: openacs-4/contrib/obsolete-packages/bboard/tcl/bboard-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/contrib/obsolete-packages/bboard/tcl/bboard-procs.tcl,v
diff -u -r1.7 -r1.8
--- openacs-4/contrib/obsolete-packages/bboard/tcl/bboard-procs.tcl	30 Nov 2001 00:50:22 -0000	1.7
+++ openacs-4/contrib/obsolete-packages/bboard/tcl/bboard-procs.tcl	1 Dec 2001 17:55:16 -0000	1.8
@@ -984,6 +984,22 @@
     In particular, this deletes message objects that aren't currently
     in a forum, but that are children of bboard messages or bboard forums.
 
+    DRB: The bboard package duplicates messages when you choose to mail one
+    to a friend, setting the new message's context_id to the original message.
+    This new message doesn't belong to a forum.  The context_id is used to
+    retrieve these via CONNECT BY and they're then deleted (presumably under
+    the assumption that they've been e-mailed immediately).
+
+    This is context_id abuse.  Context_id is supposed to be used for 
+    permissions inheritance only.  This is one of several instances in the
+    toolkit where context_id is used to link objects together in a hierarchy
+    in a way that has nothing to do with permissions.  It sucks and must be
+    fixed later (along with a bunch of other crap in this relatively ugly
+    package).
+
+    I don't think orphans arise in other circumstances but I could be wrong
+    as I've not scoured the code thoroughly yet.
+
 } {
     acs_messaging_process_queue