Paging controls. Apollo caps a search at 100 per page and 500 pages.
page defaults to 1 because of quirk #3: when draining a list — reading
members in order to move them out — always re-read page 1. Removals shift
every later page, so advancing to page 2 skips records. Read page 1, move,
read page 1 again; it now surfaces what used to be page 2. The default is 1
precisely so a caller who has not read that paragraph still drains correctly.
Paging controls. Apollo caps a search at 100 per page and 500 pages.
pagedefaults to 1 because of quirk #3: when draining a list — reading members in order to move them out — always re-read page 1. Removals shift every later page, so advancing to page 2 skips records. Read page 1, move, read page 1 again; it now surfaces what used to be page 2. The default is 1 precisely so a caller who has not read that paragraph still drains correctly.