fix: dev: jslint/jshint cosmetics. @minor
fix: typo in code prevented ``limit`` option to work properly.
new: doc: pimped and stuffed up the docs.