summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorZac Medico <zmedico@gentoo.org>2011-04-10 13:03:11 -0700
committerZac Medico <zmedico@gentoo.org>2011-04-10 13:03:11 -0700
commitd0ead65b8019f03bad69d88963ac2aa79a8f7693 (patch)
tree2ca525f50cde19b1bcf4d884433b3a4278e3e1be
parentb773f82f3ab84270d6541b84298013b6221ebcac (diff)
downloadportage-d0ead65b8019f03bad69d88963ac2aa79a8f7693.tar.gz
portage-d0ead65b8019f03bad69d88963ac2aa79a8f7693.tar.bz2
portage-d0ead65b8019f03bad69d88963ac2aa79a8f7693.zip
Scheduler: add more info in docstring comments
This clarifies the purposes of _system_merge_started and _choose_pkg.
-rw-r--r--pym/_emerge/Scheduler.py8
1 files changed, 7 insertions, 1 deletions
diff --git a/pym/_emerge/Scheduler.py b/pym/_emerge/Scheduler.py
index 06eeed5b1..d557a1410 100644
--- a/pym/_emerge/Scheduler.py
+++ b/pym/_emerge/Scheduler.py
@@ -1375,6 +1375,10 @@ class Scheduler(PollScheduler):
def _system_merge_started(self, merge):
"""
Add any unsatisfied runtime deps to self._unsatisfied_system_deps.
+ In general, this keeps track of installed system packages with
+ unsatisfied RDEPEND or PDEPEND (circular dependencies). It can be
+ a fragile situation, so we don't execute any unrelated builds until
+ the circular dependencies are built and intstalled.
"""
graph = self._digraph
if graph is None:
@@ -1554,7 +1558,9 @@ class Scheduler(PollScheduler):
def _choose_pkg(self):
"""
- Choose a task that has all it's dependencies satisfied.
+ Choose a task that has all its dependencies satisfied. This is used
+ for parallel build scheduling, and ensures that we don't build
+ anything with deep dependencies that have yet to be merged.
"""
if self._choose_pkg_return_early: