From: Vinay Sajip <vinay_sajip@yahoo.co.uk>
Date: Fri, 27 Jan 2017 13:04:33 +0000 (+0000)
Subject: Fixes #28784: Clarified use of shlex.shlex with punctuation_chars.
X-Git-Tag: v3.6.1rc1~135
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=dc4ce0e0139cbe8867e7bf235ba6af796129a7d0;p=python

Fixes #28784: Clarified use of shlex.shlex with punctuation_chars.
---

diff --git a/Doc/library/shlex.rst b/Doc/library/shlex.rst
index 4926f04d42..55012f80e8 100644
--- a/Doc/library/shlex.rst
+++ b/Doc/library/shlex.rst
@@ -411,4 +411,6 @@ which characters constitute punctuation. For example::
       >>> list(s)
       ['~/a', '&&', 'b-c', '--color=auto', '||', 'd', '*.py?']
 
-
+For best effect, ``punctuation_chars`` should be set in conjunction with
+``posix=True``. (Note that ``posix=False`` is the default for
+:class:`~shlex.shlex`.)