diff -r 6a0def54c63d Doc/library/subprocess.rst
--- a/Doc/library/subprocess.rst	Tue Mar 25 12:51:08 2014 +0100
+++ b/Doc/library/subprocess.rst	Tue Mar 25 21:02:26 2014 +0200
@@ -330,6 +330,11 @@
    :mod:`fnmatch`, :func:`os.walk`, :func:`os.path.expandvars`,
    :func:`os.path.expanduser`, and :mod:`shutil`).
 
+   Using *shell* = ``True`` and list or other iterable as arguments does
+   not raise error, but will not do what you except; only the first element of
+   the list will be executed on unix, and on windows the quoting is likely
+   incorrect. 
+
    .. versionchanged:: 3.3
       When *universal_newlines* is ``True``, the class uses the encoding
       :func:`locale.getpreferredencoding(False) <locale.getpreferredencoding>`