[PATCH 1/3] dpkg: Document the purpose of packages()

[Jonathan Nieder <jrnieder@gmail.com>]

Since this function is only called through a function pointer,
novices unfamiliar with myopt may have trouble tracking down
its purpose.

Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
---
 src/packages.c |    4 ++++
 1 files changed, 4 insertions(+), 0 deletions(-)

diff --git a/src/packages.c b/src/packages.c
index 0c1a69b..2e3c23a 100644
--- a/src/packages.c
+++ b/src/packages.c
@@ -54,6 +54,10 @@ add_to_queue(struct pkginfo *pkg)
   pkg_queue_push(&queue, pkg);
 }
 
+/*
+ * Act on the packages listed in argv.
+ * cipaction->arg contains the requested action (e.g., --configure)
+ */
 void packages(const char *const *argv) {
   struct pkgiterator *it;
   struct pkginfo *pkg;
-- 
1.7.0.4