Changed instructions on foreman parser, and added per_page hash element

The directions at the header of the file were old, so I tried to make the header match reality.

I also added a per_page hash element as well. This could be better done with a hash parameter, but that's a bit outside my comfort level.