From 89a9fb79da53ee0c5538d58002bbf343ace3ed9a Mon Sep 17 00:00:00 2001
From: David Moreau Simard <dmsimard@redhat.com>
Date: Tue, 19 Jun 2018 13:34:14 -0400
Subject: [PATCH] Add RETURN docs for the pip module (#39907)

The pip module returns some things. Let's document them.
---
 lib/ansible/modules/packaging/language/pip.py | 28 +++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/lib/ansible/modules/packaging/language/pip.py b/lib/ansible/modules/packaging/language/pip.py
index 40bd64ffb2c..ac73962d02d 100644
--- a/lib/ansible/modules/packaging/language/pip.py
+++ b/lib/ansible/modules/packaging/language/pip.py
@@ -190,6 +190,34 @@ EXAMPLES = '''
   become: True
 '''
 
+RETURN = '''
+cmd:
+  description: pip command used by the module
+  returned: success
+  type: string
+  sample: pip2 install ansible six
+name:
+  description: list of python modules targetted by pip
+  returned: success
+  type: list
+  sample: ['ansible', 'six']
+requirements:
+  description: Path to the requirements file
+  returned: success, if a requirements file was provided
+  type: string
+  sample: "/srv/git/project/requirements.txt"
+version:
+  description: Version of the package specified in 'name'
+  returned: success, if a name and version were provided
+  type: string
+  sample: "2.5.1"
+virtualenv:
+  description: Path to the virtualenv
+  returned: success, if a virtualenv path was provided
+  type: string
+  sample: "/tmp/virtualenv"
+'''
+
 import os
 import re
 import sys