add some sample documentation; allow user to specify number of rows retu...

...rned (set to 0 to get count only)