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 markgrandi
Recipients docs@python, markgrandi
Date 2014-11-06.21:07:09
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1415308030.44.0.289698928336.issue22808@psf.upfronthosting.co.za>
In-reply-to
Content
In the asyncio documentation, specifically asyncio-eventloop.rst, in the description for BaseEventLoop.call_at(), it has:

   Arrange for the *callback* to be called at the given absolute timestamp *when* (an int or float), using the same time reference as :meth:`time`.

This links to the time module's time.time() method, which is incorrect as well as confusing, as the event loop's clock is NOT the same as time.time(), and it even says so on the top of the 'delayed calls' section

According the python documentation guide, it should have a period before it to make it refer to a method that is within the same module. I however decided to change it to `BaseEventLoop.time()`, because when i  see the text 'time()', even if it links to the right method, still makes me think of time.time(), which is again confusing and generally incorrect. 

Attached is a patch file, its a trivial change, but i did regenerate the docs and confirmed that it works, and clicking the link takes you to the right method in the page.
History
Date User Action Args
2014-11-06 21:07:10markgrandisetrecipients: + markgrandi, docs@python
2014-11-06 21:07:10markgrandisetmessageid: <1415308030.44.0.289698928336.issue22808@psf.upfronthosting.co.za>
2014-11-06 21:07:10markgrandilinkissue22808 messages
2014-11-06 21:07:10markgrandicreate