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.

classification
Title: Confusing typography Python Ref 5.9
Type: Stage:
Components: Documentation Versions: Python 2.5
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: Nosy List: georg.brandl, gpk
Priority: normal Keywords:

Created on 2007-08-19 10:40 by gpk, last changed 2022-04-11 14:56 by admin. This issue is now closed.

Messages (3)
msg32662 - (view) Author: Greg Kochanski (gpk) Date: 2007-08-19 10:40
In the python reference manual, section 5.9,
all that stuff with italic "opa", "opb" etc
reads rather poorly because of a visually confusing
choice of names.

The bit about "...then a opa b opb c ... y opy z opz"
looks more like "aopabopbcopc...yopyzopz" : in other
words a unintelligible string of gibberish.   A similar
problem occurs slightly below.

Note that the spaces *are* really there, but they do not show up well in the italic font used on my Firefox/Debian system, so it's hard to parse.
The visual confusion is exacerbated by the similarities
in the operator and variable names (e.g. "opa" and "a",
then "opb" then "b"), and also by the use of a three-character string to mean "operator a" versus a
one-character name for the variable.

So, please change "opa" to "A" et cetera, or make some
other change that makes it easier to read.
msg32663 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2007-08-21 06:12
Thanks, fixed in rev. 57256.
msg32664 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2007-08-21 06:12
Thanks, fixed in rev. 57256.
History
Date User Action Args
2022-04-11 14:56:26adminsetgithub: 45327
2007-08-19 10:40:53gpkcreate