update README

1 files changed, 15 insertions, 0 deletions

diff --git a/README.rst b/README.rst
index c65ec1af..4f23b2a2 100644
--- a/README.rst
+++ b/README.rst
@@ -395,6 +395,21 @@ Further process APIs
     >>> gone, alive = psutil.wait_procs(procs_list, timeout=3, callback=on_terminate)
     >>>
 
+Popen wrapper:
+
+    >>> import psutil
+    >>> from subprocess import PIPE
+    >>> p = psutil.Popen(["/usr/bin/python", "-c", "print('hello')"], stdout=PIPE)
+    >>> p.name()
+    'python'
+    >>> p.username()
+    'giampaolo'
+    >>> p.communicate()
+    ('hello\n', None)
+    >>> p.wait(timeout=2)
+    0
+    >>>
+
 Windows services
 ================