From 5fe5e2d3f45fe1901c3c28e48282fab4eed20572 Mon Sep 17 00:00:00 2001
From: Toshio Kuratomi <toshio@fedoraproject.org>
Date: Mon, 20 Oct 2014 11:43:06 -0400
Subject: [PATCH] Docstring for v2 inventory.subset

---
 v2/ansible/inventory/__init__.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/v2/ansible/inventory/__init__.py b/v2/ansible/inventory/__init__.py
index 11f7e35c8b0..5ad688eaf00 100644
--- a/v2/ansible/inventory/__init__.py
+++ b/v2/ansible/inventory/__init__.py
@@ -58,6 +58,12 @@ class Inventory:
     def also_restrict_to(self, restriction):
         pass
     def subset(self, subset_pattern):
+        """
+        Limits inventory results to a subset of inventory that matches a given
+        pattern, such as to select a given geographic of numeric slice amongst
+        a previous 'hosts' selection that only select roles, or vice versa...
+        Corresponds to --limit parameter to ansible-playbook
+        """
         pass
     def lift_restriction(self):
         # HACK --