added some examples to the doco to get API calls working from curl and R...

...uby