Update API formatting for jsdoc generation.

Updates the formatting of the API to enable generation of documentation from the
api.js file.  No changes to the API are being made.

Progress on #183.
Merge pull request #231 from nicksay/jsdoc-api

Update API formatting for jsdoc generation.