[Checkins] SVN: zope.interface/trunk/src/zope/interface/adapter.py Confusion.

[Chris McDonough]

Log message for revision 99411:
  Confusion.
  

Changed:
  U   zope.interface/trunk/src/zope/interface/adapter.py

-=-
Modified: zope.interface/trunk/src/zope/interface/adapter.py
===================================================================
--- zope.interface/trunk/src/zope/interface/adapter.py	2009-04-22 23:01:33 UTC (rev 99410)
+++ zope.interface/trunk/src/zope/interface/adapter.py	2009-04-23 01:24:17 UTC (rev 99411)
@@ -39,6 +39,13 @@
         #   {provided -> {name -> valie}}
         # but for order == 2, we have:
         #   {r1 -> {r2 -> {provided -> {name -> valie}}}}
+        #
+        # XXX ^^^ what does the above comment have to do with any code
+        # in this method?  and.. "interfaces is really a nested key"?
+        # i don't see "interfaces" mentioned.  does it mean
+        # "provided"?  what are r1 and r2?  why is the structure just
+        # below this a list?  is this comment 100% bitrotten or just a
+        # little? /XXX
         self._adapters = []
 
         # {order -> {required -> {provided -> {name -> [value]}}}}
@@ -64,6 +71,8 @@
         #     so have to check the generations of base registries to determine
         #     if their cache data are current
 
+        # ^^^ XXX what are the above comments describing? /XXX
+
         # Base registries:
         self.__bases__ = bases