From 41f17892d61c27d8c5e3cd49fcce334eca65c2d7 Mon Sep 17 00:00:00 2001 From: Adriaan de Groot Date: Mon, 23 Oct 2017 16:41:12 -0400 Subject: [PATCH] [packages] Document run_operations() some more --- src/modules/packages/main.py | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/src/modules/packages/main.py b/src/modules/packages/main.py index 48caae6bd..bbee9c32d 100644 --- a/src/modules/packages/main.py +++ b/src/modules/packages/main.py @@ -344,10 +344,18 @@ def subst_locale(plist): def run_operations(pkgman, entry): """ - Call package manager with given parameters. - - :param pkgman: - :param entry: + Call package manager with suitable parameters for the given + package actions. + + :param pkgman: PackageManager + This is the manager that does the actual work. + :param entry: dict + Keys are the actions -- e.g. "install" -- to take, and the values + are the (list of) packages to apply the action to. The actions are + not iterated in a specific order, so it is recommended to use only + one action per dictionary. The list of packages may be package + names (strings) or package information dictionaries with pre- + and post-scripts. """ global group_packages, completed_packages, mode_packages