This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author eli.bendersky
Recipients docs@python, eli.bendersky
Date 2011-04-11.08:38:15
SpamBayes Score 1.0053203e-07
Marked as misclassified No
Message-id <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
In-reply-to
Content
The documentation of subprocess.Popen mentions a function named list2cmdline():

----
  On Windows: the Popen class uses CreateProcess() to execute the child program, which operates on strings. If args is a sequence, it will be converted to a string using the list2cmdline() method. Please note that not all MS Windows applications interpret the command line the same way: list2cmdline() is designed for applications using the same rules as the MS C runtime.
----

I find this rather opaque and useless. list2cmdline() in subprocess is publicly accessible (doesn't begin with underscores) but it isn't documented.

The solution can be one of the following:

1. Document list2cmdline in the docs of subprocess, making the reference to is useful
2. Don't mention list2cmdline and instead mention what it does with the command-line list
History
Date User Action Args
2011-04-11 08:38:17eli.benderskysetrecipients: + eli.bendersky, docs@python
2011-04-11 08:38:17eli.benderskysetmessageid: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
2011-04-11 08:38:15eli.benderskylinkissue11827 messages
2011-04-11 08:38:15eli.benderskycreate