From: Alec Warner <antarus@gentoo.org>
Date: Sun, 22 Jul 2007 22:18:34 +0000 (-0000)
Subject: add docstring, fix up imports (style), add keyword expansion
X-Git-Tag: v2.2_pre1~963
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=958cda212a421258e002aa4fcbe9832177c1be7e;p=portage.git

add docstring, fix up imports (style), add keyword expansion

svn path=/main/trunk/; revision=7361
---

diff --git a/pym/portage/sets/shell.py b/pym/portage/sets/shell.py
index 2383dba81..6a84918a7 100644
--- a/pym/portage/sets/shell.py
+++ b/pym/portage/sets/shell.py
@@ -2,11 +2,25 @@
 # Distributed under the terms of the GNU General Public License v2
 # $Id$
 
-import subprocess, os
+import subprocess
+import os
 
 from portage.sets import PackageSet
 
 class CommandOutputSet(PackageSet):
+	"""This class creates a PackageSet from the output of a shell command.
+	   The shell command should produce one atom per line, that is:
+
+	   >>> atom1
+	       atom2
+	       ...
+	       atomN
+
+	   Args:
+	     name: A string that identifies the set.
+	     command: A string or sequence identifying the command to run
+	     (see the subprocess.Popen documentaion for the format)
+	"""
 	_operations = ["merge", "unmerge"]
 
 	def __init__(self, name, command):