[Python-checkins] cpython (3.6): Fixes #28784: Clarified use of shlex.shlex with punctuation_chars.

[vinay.sajip]

https://hg.python.org/cpython/rev/ff3312ce1d14
changeset:   106323:ff3312ce1d14
branch:      3.6
parent:      106321:d3890b44159c
user:        Vinay Sajip <vinay_sajip at yahoo.co.uk>
date:        Fri Jan 27 13:04:33 2017 +0000
summary:
  Fixes #28784: Clarified use of shlex.shlex with punctuation_chars.

files:
  Doc/library/shlex.rst |  4 +++-
  1 files changed, 3 insertions(+), 1 deletions(-)


diff --git a/Doc/library/shlex.rst b/Doc/library/shlex.rst
--- a/Doc/library/shlex.rst
+++ b/Doc/library/shlex.rst
@@ -411,4 +411,6 @@
       >>> 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`.)

-- 
Repository URL: https://hg.python.org/cpython