From 2338df45f605f74d8300baf99f806cc738578fb2 Mon Sep 17 00:00:00 2001
From: Zac Medico <zmedico@gentoo.org>
Date: Fri, 5 Oct 2007 01:46:52 +0000
Subject: Document interaction between config.setinst() and old-style virtuals
 preferences. (trunk r7891)

svn path=/main/branches/2.1.2/; revision=7924
---
 pym/portage.py | 7 +++++++
 1 file changed, 7 insertions(+)

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()
-- 
cgit v1.2.3-1-g7c22