Message217170
Inconsistencies / confusion with documentation Index Tab. Example (line numbers added for comments that follow):
1 max
2 built-in function
3 max (datetime.date attribute)
4 (datetime.datetime attribute)
5 (datetime.time attribute)
6 max() built-in function
7 (decimal.Context method)
8 (decimal.Decimal method)
9 (in module audioloop)
The following all lead to confusion and frustration:
Having 3 rows (1, 3, 6)that begin with max.
Having an entry (1) that does nothing when double-clicked.
double-clicking (2) takes us to a reference rather than a definition.
RECOMMENDATION:
change to:
max() built-in function
(sequence operation)
(decimal.Context method)
(decimal.Decimal method)
max
(datetime.date attribute)
(datetime.datetime attribute)
(datetime.time attribute)
where double-clicking the first line goes to the max() definition
in 2. Built-in Functions
These comments apply, with a number of variations, to most built-in functions index entries. |
|
Date |
User |
Action |
Args |
2014-04-25 20:27:41 | bgailer | set | recipients:
+ bgailer, docs@python |
2014-04-25 20:27:41 | bgailer | set | messageid: <1398457661.12.0.679738685491.issue21352@psf.upfronthosting.co.za> |
2014-04-25 20:27:40 | bgailer | link | issue21352 messages |
2014-04-25 20:27:38 | bgailer | create | |
|