: the documentation of 'cursorMarks' recommends to fetch until a query returns : the cursorMark that was passed in to a request. : : But that always requires an additional request at the end, so I wonder if I : can stop already, if a request returns less results than requested (num rows). : There won't be new documents added during the search in my use case, so could : there every be a non-empty 'page' after a non-full 'page'?
You could stop then -- if that fits your usecase -- but the documentation (in particular the sentence you are refering to) is trying to be as straightforward and general as possible ... which includes the use case where someone is "tailing" an index and documents may be continually added. When originally writing those docs, I did have a bit in there about *either* getting back less then "rows" docs *or* getting back the same cursor you passed in (to try to cover both use cases as efficiently as possible) but it seemed more confusing -- and i was worried people might be suprised/confused when the number of docs was perfectly divisible by "rows" so the "less then rows" case could still wind up in a final request that returned "0" docs. the current docs seemed like a good balance between brevity & clarity, with the added bonus of being correct :) But as Anshum said: if you have suggested improvements for rewording, patches/PRs certainly welcome. It's hard to have a good perspective on what docs are helpful to new users whne you have been working with the software for 14 years and wrote the code in question. -Hoss http://www.lucidworks.com/