CXX-176 implement limit

Swapped nToReturn for limit on all interfaces.  Implemented real limit
semantics.