From: Zac Medico <zmedico@gentoo.org>
Date: Thu, 21 Sep 2006 02:54:25 +0000 (-0000)
Subject: Add a docstring for depgraph.validate_blockers().
X-Git-Tag: v2.1.1-r1~47
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=2322da1ba0584f7b38ada5bef7e7a56c1e3a6e5a;p=portage.git

Add a docstring for depgraph.validate_blockers().

svn path=/main/trunk/; revision=4488
---

diff --git a/bin/emerge b/bin/emerge
index 5cf60720b..9b90a55ee 100755
--- a/bin/emerge
+++ b/bin/emerge
@@ -1236,6 +1236,11 @@ class depgraph:
 		return 1
 
 	def validate_blockers(self):
+		"""Remove any blockers from the digraph that do not match any of the
+		packages within the graph.  Blockers are only matched against the
+		final state of the graph.  Thus, it's possible that mutually blocking
+		packages will be installed simultaneously a some point(s) during the
+		transition from the initial to the final state."""
 		all_blockers = [node for node in self.digraph.all_nodes()
 				if node.split()[0] == "blocks"]
 		for blocker in all_blockers: