added docs for the 3-parameter call.  How to view the compiled docs in shoes?

Hello,

   This pull request addresses an open newcomer-friendly issue relating to documentation.  If I didn't do this the way you wanted, let me know what you would like changed please.

   I have got shoes samples running (mac OSX) but do not see how to build and/or view the documentation.  Can someone give any guidance?

Thanks,
Dave