working around jsdoc bugs

Author: nfriedly

Diff for: README.md

@@ -152,3 +152,4 @@ For use with `.recognizeBlob({play: true})` - slows the results down to match th
 * consider renaming recognizeBlob to recognizeFile to make the usage more obvious
 * consider an `interim` event for recognize/format/timing streams to avoid objectMode (in most cases)
 * ajax / playFile demo 
+* fix documentation generation

Diff for: dist/watson-speech.js

@@ -3,8 +3,19 @@
 
 'use strict';
 
+/**
+ * @namespace WatsonSpeech
+ */
+
+/**
+ * Version - for public releases, this should have the version number, e.g 'v1.0.0'
+ */
 exports.version = process.env.TRAVIS_BRANCH;
 
+/**
+ * SpeechToText
+ * @type {*|exports|module.exports}
+ */
 exports.SpeechToText = require('./speech-to-text');
 
 // todo: add text-to-speech

Diff for: index.js

@@ -1,8 +1,9 @@
 {
   "source": {
-    "include": [ "./", "speech-to-text/" ]
+    "include": [ "./index.js", "./speech-to-text/" ]
   },
-  "options": {
+  "note": "at some point, the options param was apparently renamed to opts",
+  "opts": {
     "package": "package.json",
     "readme": "README.md",
     "recurse": false,

Diff for: jsdoc/config.json

@@ -12,7 +12,7 @@
     "minify": "with-package uglifyjs --compress --mangle --screw-ie8 dist/watson-speech.js --output dist/watson-speech.min.js --preamble \"// IBM Watson Speech JavaScript SDK\n// vpkg.version\n// Generated at `date`\n// Copyright IBM (pkg.license)\"",
     "watchify": "watchify index.js --standalone WatsonSpeech --outfile dist/watson-speech.js --debug --verbose",
     "build": "npm run browserify && npm run minify",
-    "doc": "jsdoc -c jsdoc/config.json",
+    "doc": "jsdoc -c jsdoc/config.json --debug",
     "watch-doc": "nodemon --watch lib/ --watch services/ --watch jsdoc/ --watch package.json --ext js,tmpl --exec npm run doc"
   },
   "author": "Nathan Friedly <http://nfriedly.com>",