diff options
author | Zac Medico <zmedico@gentoo.org> | 2011-04-10 13:03:11 -0700 |
---|---|---|
committer | Zac Medico <zmedico@gentoo.org> | 2011-04-13 00:49:59 -0700 |
commit | e0219e53e37cd1c984d58d0f6ac8925190ffc939 (patch) | |
tree | d84db1cd0a588e0a21e40f4e68ad8bcfc91600c6 | |
parent | 90b7a235a290e16b0ec151d77e8166c62c1745aa (diff) | |
download | portage-e0219e53e37cd1c984d58d0f6ac8925190ffc939.tar.gz portage-e0219e53e37cd1c984d58d0f6ac8925190ffc939.tar.bz2 portage-e0219e53e37cd1c984d58d0f6ac8925190ffc939.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.py | 8 |
1 files changed, 7 insertions, 1 deletions
diff --git a/pym/_emerge/Scheduler.py b/pym/_emerge/Scheduler.py index 8ee96eb7a..f28d7ef00 100644 --- a/pym/_emerge/Scheduler.py +++ b/pym/_emerge/Scheduler.py @@ -1373,6 +1373,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: @@ -1552,7 +1556,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: |