From: Zac Medico <zmedico@gentoo.org>
Date: Sun, 30 Sep 2007 18:57:25 +0000 (-0000)
Subject: Document interaction between config.setinst() and
X-Git-Tag: v2.2_pre1~751
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=6eeb6fd8c40df09d0c5d462c5fa91e8e7b273b40;p=portage.git

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 24b246be7..8ffe9c275 100644
--- 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()