From: Zac Medico <zmedico@gentoo.org>
Date: Fri, 5 Oct 2007 01:46:52 +0000 (-0000)
Subject: Document interaction between config.setinst() and
X-Git-Tag: v2.1.3.16~85
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=2338df45f605f74d8300baf99f806cc738578fb2;p=portage.git

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 66edec936..3c8dc25b1 100644
--- 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()