[docs] [issue10008] Two links point to same place
Terry J. Reedy
report at bugs.python.org
Sun Oct 10 21:55:19 CEST 2010
Terry J. Reedy <tjreedy at udel.edu> added the comment:
When I initially wrote "I have no idea what ', ' is supposed to mean.
", you should have believed that and explained ;-). I now understand that most index entries have one link, which we might call the  link. When the entry should have more than one link, the index entry text is followed by '' and, if needed, '', '', and so on. These place-holder labels should each have different links, or should not be there at all.
So "ZipFile (class in zipfile" and "" are two separate texts that should have two different links, but the two links are the same, and that, I agree, is wrong. Another example with duplicate links:
tracer() (in module turtle), 
3.1.2 and 3.2a2 indexes have Zipfile error but not tracer error (because '' is not present).
Doc people: the attached patch is a diagnostic patch rather than a fixup patch. I do not know whether the problem is in .rst sources or Sphinx.
assignee: docs at python ->
stage: -> needs patch
type: -> behavior
versions: +Python 3.1, Python 3.2
Python tracker <report at bugs.python.org>
More information about the docs