Execute the file with "--help" as an added switch for options.
But if you want more ... use a text editor on the file in question. don't take anybody else's word for it.
There are notes at the top which generally answer most question, and the sql queries and conditions upon which they run are IN the file. Have at it.
Also have a look in /usr/src/astguiclient/trunk/docs ... there are a lot of questions answered in this folder related to their associated scripts.