TODO: Make elog 'key' parameter more unique.

diff --git a/pym/portage/elog/messages.py b/pym/portage/elog/messages.py
index 6b4561fe75a4adbea12f9165652769c4b8cc1570..9a0e510fb7d313bcbb43a0487ca8bdde89bd208c 100644 (file)
--- a/pym/portage/elog/messages.py
+++ b/pym/portage/elog/messages.py
@@ -82,6 +82,15 @@ def _elog_base(level, msg, phase="other", key=None, color=None, out=None):
            directly.
        """
 
+       # TODO: Have callers pass in a more unique 'key' parameter than a plain
+       # cpv, in order to ensure that messages are properly grouped together
+       # for a given package instance, and also to ensure that each elog module's
+       # process() function is only called once for each unique package. This is
+       # needed not only when building packages in parallel, but also to preserve
+       # continuity in messages when a package is simply updated, since we don't
+       # want the elog_process() call from the uninstall of the old version to
+       # cause discontinuity in the elog messages of the new one being installed.
+
        global _msgbuffer
 
        if out is None: