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 rurpy2
Recipients docs@python, rurpy2
Date 2012-12-14.06:09:53
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1355465395.03.0.430403844231.issue16677@psf.upfronthosting.co.za>
In-reply-to
Content
Python Language Reference, chapter 6 "Expressions".

The last section (6.15) of this is titled, "Summary".  That title is misleading -- it is not really a summary of the "Expressions" chapter but rather, as the first sentence makes clear, a table of operator precedences.  It is not really even a "summary" of operator precedences since some of the preceeding operator sections don't mention their precedence.  And adding to the confusion, none of preceding sections even use the word precedence, referring instead to "binding" or "priority".

Operator precedences are something many users frequently look for frequently in a language reference and the lack of an Operator Precedence entry in the ToC makes this section hard to find.

There are no index entries for "operators/precedence" or "expressions/order of evaluation".  There is an index entry for "evaluation order" but that points to a different section.

At a minimum, this section should have its title changed from "Summary" to "Operator Precedence" and get one or more index entries.

In other languages operator precedence is often described and indexed under "order of evaluation", often as a subindex of "expressions".  In the Python reference, there is a very short section called, 6.14, "Evaluation Order" that immediately preceeds the Operator Precedence section.  That section and the Operator Precedence section could be effectively combined into a single section.
History
Date User Action Args
2012-12-14 06:09:55rurpy2setrecipients: + rurpy2, docs@python
2012-12-14 06:09:55rurpy2setmessageid: <1355465395.03.0.430403844231.issue16677@psf.upfronthosting.co.za>
2012-12-14 06:09:54rurpy2linkissue16677 messages
2012-12-14 06:09:53rurpy2create