Document interaction between config.setinst() and

old-style virtuals preferences.

svn path=/main/trunk/; revision=7891

diff --git a/pym/portage/__init__.py b/pym/portage/__init__.py
index 24b246be76a86a62bb6f247d39bd6a92ebb4a515..8ffe9c27538398faf13deed308494868b8419a45 100644 (file)
--- a/pym/portage/__init__.py
+++ b/pym/portage/__init__.py
@@ -1896,6 +1896,13 @@ class config(object):
                return ret
 
        def setinst(self,mycpv,mydbapi):
+               """This updates the preferences for old-style virtuals,
+               affecting the behavior of dep_expand() and dep_check()
+               calls. It can change dbapi.match() behavior since that
+               calls dep_expand(). However, dbapi instances have
+               internal match caches that are not invalidated when
+               preferences are updated here. This can potentially
+               lead to some inconsistency (relevant to bug #1343)."""
                self.modifying()
                if len(self.virtuals) == 0:
                        self.getvirtuals()