Message135341
It doesn't. Sphinx still can't make any links, which btw also means that it's impossible to reference those methods within the Python documentation.
Also I want to point out that I find the information very hard to find as a human. The fact that integers are based on `numbers.Number` is -- at this point in time where 95% of all Python developers don't know about the `numbers` module or abstract base classes in general -- an implementation detail and as such should not affect the way `int` is documented.
I propose to have decent class references for int, str, ... similar to the reference for dict -- that is, document all attributes and methods in one place and make them referencable. For those who want to deep-dive into CPython internals, a note about those functionality actually being implemented in ABCs could be added.
(But I think that's out of scope for this ticket. I could open a new one if anyone agrees with me... :-) |
|
Date |
User |
Action |
Args |
2011-05-06 17:26:57 | jonash | set | recipients:
+ jonash, eric.araujo, docs@python, python-dev |
2011-05-06 17:26:56 | jonash | set | messageid: <1304702816.91.0.0778751980185.issue11977@psf.upfronthosting.co.za> |
2011-05-06 17:26:56 | jonash | link | issue11977 messages |
2011-05-06 17:26:56 | jonash | create | |
|