Update public_api.rb
Adding some specs, and adding the limit parameter to all derived methods.
Merge branch 'optional-limit-param'