Clarify docs for limit parameter of timeline macro

Prompted by a comment in #975