From c2415eb7e6ccb22888f35138527d6dc106e50a4e Mon Sep 17 00:00:00 2001
From: Andrew Svetlov <andrew.svetlov@gmail.com>
Date: Sun, 28 Oct 2012 11:42:26 +0200
Subject: [PATCH] Issue #14616: Mention shlex.quote in subprocess docs.

Patch by Chris Rebert.
---
 Doc/library/subprocess.rst | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Doc/library/subprocess.rst b/Doc/library/subprocess.rst
index 66d6cbbd646..34fdf106a32 100644
--- a/Doc/library/subprocess.rst
+++ b/Doc/library/subprocess.rst
@@ -341,6 +341,10 @@ default values. The arguments that are most commonly needed are:
       from this vulnerability; see the Note in the :class:`Popen` constructor
       documentation for helpful hints in getting ``shell=False`` to work.
 
+      When using ``shell=True``, :func:`shlex.quote` can be used to properly
+      escape whitespace and shell metacharacters in strings that are going to
+      be used to construct shell commands.
+
 These options, along with all of the other options, are described in more
 detail in the :class:`Popen` constructor documentation.