From 958cda212a421258e002aa4fcbe9832177c1be7e Mon Sep 17 00:00:00 2001
From: Alec Warner <antarus@gentoo.org>
Date: Sun, 22 Jul 2007 22:18:34 +0000
Subject: add docstring, fix up imports (style), add keyword expansion

svn path=/main/trunk/; revision=7361
---
 pym/portage/sets/shell.py | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

(limited to 'pym')

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):
-- 
cgit v1.2.3-1-g7c22