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 terry.reedy
Recipients Kyle.Simpson, docs@python, eric.araujo, ezio.melotti, mikehoy, ncoghlan, terry.reedy
Date 2011-10-07.22:16:12
SpamBayes Score 2.9546383e-08
Marked as misclassified No
Message-id <1318025773.71.0.242689641188.issue12602@psf.upfronthosting.co.za>
In-reply-to
Content
As of 2.7/3.2, the doc is named "Python Setup and Usage" at
http://docs.python.org/index.html
http://docs.python.org/using/cmdline.html (and other chapters)
and in the contents list of the Windows help version.
For new doc editors, it would be nicer if the filename (directory name, actually) had been changed to 'py_setup' or even 'py_usage'.

Looking in the first chapter, which you finally referenced, I do see an entry for '<script>', with the brackets, that can be both a target and container of links. That usage, with a generic argument name in angle brackets, may be unique in the docs. (I looked at trace, profile, pydoc, timeit, test, and doctest docs.) So don't be so surprised that others are not familiar with it. 

Now that is cleared up:
+1 on the links suggested in the original message.

-1 on a link to the tracker issue. That is not a coherent document and cannot be edited and improved. If more doc is needed, there should have been and could be a PEP, addition to the <script> entry, or a new chapter section 1.3 Zipfiles.

---
>Terry, might that other issue be #12298?

Yes. I see you have applied a fix.
History
Date User Action Args
2011-10-07 22:16:13terry.reedysetrecipients: + terry.reedy, ncoghlan, ezio.melotti, eric.araujo, docs@python, Kyle.Simpson, mikehoy
2011-10-07 22:16:13terry.reedysetmessageid: <1318025773.71.0.242689641188.issue12602@psf.upfronthosting.co.za>
2011-10-07 22:16:13terry.reedylinkissue12602 messages
2011-10-07 22:16:12terry.reedycreate