Document the allowed parameters for get_pages()

[wonderboymusic]

I found some craziness in #9470. It's no wonder: there is almost no documentation for the parameters one can pass to get_pages(). We should add some.

[DrewAPicture]

This one is definitely near the top of the list. A first-round patch is welcome, but we'd like it to conform to the soon-to-be public inline-docs standards, so don't overexert too much just yet :)

[DrewAPicture]

25186.diff​ documents the arguments in the new hash notation style :)

Could probably add a long description here, and docs for the filter(s) will be added separately.

[wonderboymusic]

In 25266:

Add docs to the woefully under-documented get_pages().

Props DrewAPicture.
Fixes #25186.

[DrewAPicture]

@wonderboymusic mind also committing the spacing etc. fixes in 25186.3.diff​?

[wonderboymusic]

In 25268:

Fix spacing in docs for get_pages().

Props DrewAPicture.
See #25186.

[nacin]

In 25271:

More adjustments and improvements for inline documentation for get_pages(). see #25186.