This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author kyle.roberts
Recipients docs@python, eric.araujo, ezio.melotti, georg.brandl, kyle.roberts, twouters
Date 2013-04-10.03:21:33
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1365564094.08.0.278906847393.issue17661@psf.upfronthosting.co.za>
In-reply-to
Content
Adding a '.' to the beginning (i.e. `.repr`) creates a link to repr.html#repr.repr. This made more sense after perusing Sphinx's documentation:

"If you prefix the name with a dot, this order is reversed. For example, in the documentation of Python’s codecs module, :py:func:`open` always refers to the built-in function, while :py:func:`.open` refers to codecs.open()."

I'm not sure what other options I can try after looking at the reST documentation. It seems like our best bet would be if we could define a priority for same-name functions when two definitions are discovered. I didn't see a way to do this in Sphinx/reST so I'm not sure how to move forward with this. I'm assuming we don't want to link directly to the correct url if it can be avoided.

Also, I noticed http://docs.python.org/2/library/repr.html#module-repr links to the wrong repr() a few times where it mentions the "built-in" function.
History
Date User Action Args
2013-04-10 03:21:34kyle.robertssetrecipients: + kyle.roberts, twouters, georg.brandl, ezio.melotti, eric.araujo, docs@python
2013-04-10 03:21:34kyle.robertssetmessageid: <1365564094.08.0.278906847393.issue17661@psf.upfronthosting.co.za>
2013-04-10 03:21:34kyle.robertslinkissue17661 messages
2013-04-10 03:21:33kyle.robertscreate