[issue13826] Having a shlex example in the subprocess.Popen docs is confusing

[Guido van Rossum]

Change by Guido van Rossum :


--
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13826] Having a shlex example in the subprocess.Popen docs is confusing

[miss-islington]

miss-islington  added the comment:


New changeset e6690f6cd1b0c2bd5804bad30239a4070f79102c by Miss Islington (bot) 
in branch '3.8':
bpo-13826: Clarify Popen constructor example (GH-18438)
https://github.com/python/cpython/commit/e6690f6cd1b0c2bd5804bad30239a4070f79102c


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13826] Having a shlex example in the subprocess.Popen docs is confusing

[miss-islington]

miss-islington  added the comment:


New changeset 78982f94faaa05e363d15b49ec230d11a4d8bebd by Miss Islington (bot) 
in branch '3.7':
bpo-13826: Clarify Popen constructor example (GH-18438)
https://github.com/python/cpython/commit/78982f94faaa05e363d15b49ec230d11a4d8bebd


--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13826] Having a shlex example in the subprocess.Popen docs is confusing

[miss-islington]

Change by miss-islington :


--
pull_requests: +17820
pull_request: https://github.com/python/cpython/pull/18446

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13826] Having a shlex example in the subprocess.Popen docs is confusing

[miss-islington]

Change by miss-islington :


--
pull_requests: +17819
pull_request: https://github.com/python/cpython/pull/18445

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13826] Having a shlex example in the subprocess.Popen docs is confusing

[miss-islington]

miss-islington  added the comment:


New changeset 95d024d585bd3ed627437a2f0cbc783c8a014c8a by Tim D. Smith in 
branch 'master':
bpo-13826: Clarify Popen constructor example (GH-18438)
https://github.com/python/cpython/commit/95d024d585bd3ed627437a2f0cbc783c8a014c8a


--
nosy: +miss-islington

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13826] Having a shlex example in the subprocess.Popen docs is confusing

[Tim Smith]

Change by Tim Smith :


--
keywords: +patch
pull_requests: +17812
stage: needs patch -> patch review
pull_request: https://github.com/python/cpython/pull/18438

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13826] Having a shlex example in the subprocess.Popen docs is confusing

[Berker Peksag]

Changes by Berker Peksag :


--
keywords: +easy
stage:  -> needs patch
versions: +Python 3.5, Python 3.6 -Python 2.7, Python 3.2, Python 3.3

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13826] Having a shlex example in the subprocess.Popen docs is confusing

[Chris Rebert]

Changes by Chris Rebert pyb...@rebertia.com:


--
nosy: +cvrebert

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue13826
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13826] Having a shlex example in the subprocess.Popen docs is confusing

[Éric Araujo]

Changes by Éric Araujo mer...@netwok.org:


--
nosy: +eric.araujo

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue13826
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13826] Having a shlex example in the subprocess.Popen docs is confusing

[Julian Berman]

New submission from Julian Berman julian+python@grayvines.com:

The example at 
http://docs.python.org/dev/library/subprocess.html#popen-constructor seems a 
bit misplaced, as it seems to suggest that one should use the shlex module. 
Most of the other examples in the module seem to use a list to provide the 
args, so if there was a need to just point out that shlex could be used for a 
corner case perhaps it'd be better suited as a footnote or another subsection 
somewhere.

--
assignee: docs@python
components: Documentation
messages: 151624
nosy: Julian, docs@python
priority: normal
severity: normal
status: open
title: Having a shlex example in the subprocess.Popen docs is confusing
type: enhancement
versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue13826
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13826] Having a shlex example in the subprocess.Popen docs is confusing

[R. David Murray]

Changes by R. David Murray rdmur...@bitdance.com:


--
priority: normal - low

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue13826
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13826] Having a shlex example in the subprocess.Popen docs is confusing

[R. David Murray]

R. David Murray rdmur...@bitdance.com added the comment:

It is not particularly intuitive what goes in to a Popen non-shell argument 
list, unless you are an experienced programmer.  The real purpose of the note 
is to convey a lot of information about how tokenization works in a short 
example, and it also demonstrates how to investigate other complex cases the 
user may have to deal with.  Because of the first part of that (showing 
tokenization quirks) I don't think it should be relegated to a footnote.

That said, the example could perhaps be reworded slightly to make its 
expositional purpose clearer.  Suggestions welcome.

--
nosy: +r.david.murray

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue13826
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13826] Having a shlex example in the subprocess.Popen docs is confusing

[Sandro Tosi]

Sandro Tosi sandro.t...@gmail.com added the comment:

Maybe we can add a very small example before the whole note to show just how to 
use Popen in simple situation, and so the shlex part below will add more 
details for more advanced cases.

--
nosy: +sandro.tosi
versions:  -Python 2.6, Python 3.1

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue13826
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13826] Having a shlex example in the subprocess.Popen docs is confusing

[Julian Berman]

Julian Berman julian+python@grayvines.com added the comment:

Sounds reasonable to me.

I'll take a look at adding one unless someone manages to beat me to it.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue13826
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com