Message135334
> Is this a problem in our markup or a bug in intersphinx?
It's a markup problem -- those types are documented as functions, using the :func: role/`.. func::` directive.
It's not only a markup mismatch but, strictly speaking, it's *wrong* documentation: str, int, ... aren't functions, they're *classes* and should be documented as such. It's a bit odd to search for information on the str *class* in the list of built-in *functions*.
> If this work within one documentation set (as I believe it does)
It does not. For example, in http://docs.python.org/library/functions.html#max there's a reference to list.sort using :meth:`list.sort` but no link could be generated. How could it possibly work without decent documentation about the list data type? |
|
Date |
User |
Action |
Args |
2011-05-06 17:11:41 | jonash | set | recipients:
+ jonash, benjamin.peterson, ezio.melotti, eric.araujo, docs@python |
2011-05-06 17:11:41 | jonash | set | messageid: <1304701901.56.0.242773209884.issue11975@psf.upfronthosting.co.za> |
2011-05-06 17:11:41 | jonash | link | issue11975 messages |
2011-05-06 17:11:40 | jonash | create | |
|