Author jonash
Recipients benjamin.peterson, docs@python, eric.araujo, ezio.melotti, jonash
Date 2011-05-06.17:11:40
SpamBayes Score 1.75138e-08
Marked as misclassified No
Message-id <1304701901.56.0.242773209884.issue11975@psf.upfronthosting.co.za>
In-reply-to
Content
> 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?
History
Date User Action Args
2011-05-06 17:11:41jonashsetrecipients: + jonash, benjamin.peterson, ezio.melotti, eric.araujo, docs@python
2011-05-06 17:11:41jonashsetmessageid: <1304701901.56.0.242773209884.issue11975@psf.upfronthosting.co.za>
2011-05-06 17:11:41jonashlinkissue11975 messages
2011-05-06 17:11:40jonashcreate