[docs] [issue28784] shlex.shlex punctuation_chars documentation should use posix=True

[Evan]

New submission from Evan:

(This discussion started on issue28595.)

The new punctuation_chars keyword argument is intended to provide "compatibility with the parsing performed by common Unix shells like bash, dash, and sh", however the documentation and examples do not mention that the user should also set posix=True (which defaults to False for shlex.shlex but True for shlex.split).

Longer term (over several releases), perhaps the default for posix could be changed from False to True. Alternatively, the punctuation_chars argument could also be added to shlex.split, which would avoid having to interact with shlex.shlex directly.

----------
assignee: docs at python
components: Documentation
messages: 281612
nosy: docs at python, evan_, r.david.murray, vinay.sajip
priority: normal
severity: normal
status: open
title: shlex.shlex punctuation_chars documentation should use posix=True
type: behavior
versions: Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28784>
_______________________________________