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 ncoghlan
Recipients docs@python, ezio.melotti, madison.may, mikehoy, ncoghlan, rhettinger, techtonik, terry.reedy
Date 2013-09-22.11:48:06
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1379850486.67.0.172276426578.issue19024@psf.upfronthosting.co.za>
In-reply-to
Content
Unfortunately, there's currently no good place for this kind of detailed syntax reference documentation to go. The library reference doesn't cover syntax, the tutorial doesn't go into detailed semantics, and the language reference is written more for language implementors than it is for users.

My Python User's Reference project (http://svn.python.org/view/sandbox/trunk/userref/README.txt?view=markup) was designed to fill that gap, but I never found the time to do the ReST conversion myself, and nobody ever expressed interest in helping out with it, so it's now five years out of date.

Creating a cut down version of that as the "Python Syntax Reference" might be a reasonable approach. However, it's a project that could easily start life outside the core CPython repository.
History
Date User Action Args
2013-09-22 11:48:06ncoghlansetrecipients: + ncoghlan, rhettinger, terry.reedy, techtonik, ezio.melotti, docs@python, mikehoy, madison.may
2013-09-22 11:48:06ncoghlansetmessageid: <1379850486.67.0.172276426578.issue19024@psf.upfronthosting.co.za>
2013-09-22 11:48:06ncoghlanlinkissue19024 messages
2013-09-22 11:48:06ncoghlancreate