Re: [Python-Dev] Missing command line documentation for new tools

2012-05-28 Thread Terry Reedy
On 5/28/2012 10:31 PM, Nick Coghlan wrote: Given an exchange on the tracker, I feel I should expand on this point. Historically, our Setup& Usage documentation has *only* covered the main Python executable, even though we actually install additional tools, including pydoc, idle, 2to3 and now p

Re: [Python-Dev] Missing command line documentation for new tools

2012-05-28 Thread Éric Araujo
Le 28/05/2012 22:31, Nick Coghlan a écrit : > Historically, our Setup & Usage documentation has *only* covered the > main Python executable, even though we actually install additional > tools, including pydoc, idle, 2to3 and now pysetup and pyvenv, and > provide additional documented and supported

Re: [Python-Dev] Missing command line documentation for new tools

2012-05-28 Thread Nick Coghlan
On Tue, May 29, 2012 at 9:20 AM, Nick Coghlan wrote: > As the standard library comes to include more directly executed tools, > we really need to focus on keeping the Setup & Usage docs up to date. > The fact we've been historically lax on that front is no excuse for > perpetuating the problem for

[Python-Dev] Missing command line documentation for new tools

2012-05-28 Thread Nick Coghlan
The documentation does not currently provide end user guides for pysetup or pyvenv under http://docs.python.org/dev/using/index.html This needs to be fixed before 3.3 is released. I've created the following issues as deferred blockers (since they don't need to be addressed before the alpha this we