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 --