Document interaction between config.setinst() and

old-style virtuals preferences. (trunk r7891)

svn path=/main/branches/2.1.2/; revision=7924

diff --git a/pym/portage.py b/pym/portage.py
index 66edec9367edabb3b88c7cdb9eed83b83d923bbf..3c8dc25b151f59f0a8c122cc0311623e7a4d5f3b 100644 (file)
--- a/pym/portage.py
+++ b/pym/portage.py
@@ -1848,6 +1848,13 @@ class config:
                        self.reset(keeping_pkg=1,use_cache=use_cache)
 
        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()