Ultimately, Wagneers would like to be able to specify both a maximum number of cards for a search, and how many to return at a time. Currently, "limit" does the latter but people often expect it to mean the former.
There is a separate ticket for replacing the functionality of what is currently called limit: duplicate limit functionality with paging
Migrating may be tricky, so the earlier this is done the better. But it should be done with plenty of warning, i.e.: