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.
Is this still true? And if it is, should we have a bug tracking this?