[pypy-svn] r19927 - pypy/branch/somepbc-refactoring/pypy/annotation

[arigo at codespeak.net]

Author: arigo
Date: Wed Nov 16 14:05:08 2005
New Revision: 19927

Modified:
   pypy/branch/somepbc-refactoring/pypy/annotation/description.py
Log:
(mwh, arigo)
some comments


Modified: pypy/branch/somepbc-refactoring/pypy/annotation/description.py
==============================================================================
--- pypy/branch/somepbc-refactoring/pypy/annotation/description.py	(original)
+++ pypy/branch/somepbc-refactoring/pypy/annotation/description.py	Wed Nov 16 14:05:08 2005
@@ -6,6 +6,9 @@
 
 class CallFamily:
     """A family of Desc objects that could be called from common call sites.
+    The call families are conceptually a partition of all (callable) Desc
+    objects, where the equivalence relation is the transitive closure of
+    'd1~d2 if d1 and d2 might be called at the same call site'.
     """
     def __init__(self, desc):
         self.descs = { desc: True }
@@ -18,6 +21,10 @@
 
 class AttrFamily:
     """A family of Desc objects that have common 'getattr' sites.
+    The attr families are conceptually a partition of FrozenDesc and ClassDesc
+    objects, where the equivalence relation is the transitive closure of
+    'd1~d2 if d1 and d2 might have an attribute read on them by the same
+    getattr operation.'
     """
     def __init__(self, desc):
         self.descs = { desc: True }