Replace the grunt docs tasks with grunt-jsdoc

Replace builddoc and exportdocjson grunt tasks with grunt-jsdoc.
To avoid an error I added a fake comment to a @todo param in the p2.js
file.

Author: vbornand

Gruntfile.js

@@ -21,7 +21,7 @@ module.exports = function (grunt) {
 
     grunt.registerTask('dist', ['replace:pixi', 'replace:p2', 'build', 'copy']);
 
-    grunt.registerTask('docs', [ 'clean:docs', 'pixidoc', 'builddoc', 'replace:docs', 'clean:out']);
+    grunt.registerTask('docs', [ 'clean:docs', 'pixidoc', 'jsdoc:html', 'replace:docs', 'clean:out']);
 
-    grunt.registerTask('tsdocs', ['clean:out', 'pixidoc', 'gitclone:plugins', 'exportdocjson', 'buildtsdoc:pixi', 'buildtsdoc:phaser', 'replace:phasertsdefheader', 'clean:out']);
+    grunt.registerTask('tsdocs', ['clean:out', 'pixidoc', 'gitclone:plugins', 'jsdoc:json', 'buildtsdoc:pixi', 'buildtsdoc:phaser', 'replace:phasertsdefheader', 'clean:out']);
 };

package.json

@@ -43,8 +43,8 @@
     "load-grunt-config": "~0.7.2",
     "yuidocjs": "^0.3.50",
     "jsdoc": "~3.3.0-alpha10",
-    "grunt-jsdoc": "~0.5.7",
-	"typescript-services": "~0.1.5",
-	"grunt-git": "^0.3.3"
+    "grunt-jsdoc": "~0.6.2-beta",
+    "typescript-services": "~0.1.5",
+    "grunt-git": "^0.3.3"
   }
 }

resources/jsdoc Export JSON/template/publish.js

@@ -4,6 +4,8 @@
  */
 'use strict';
 
+var path = require('jsdoc/path');
+
 function findClass(parentNode, className)
 {
     var elements =
@@ -109,5 +111,5 @@ exports.publish = function (data, opts) {
 
     graft2(root, data().get());
     var fs = require('fs');
-    fs.writeFileSync(opts.destination, JSON.stringify(root), 'utf8');
+    fs.writeFileSync(path.join(env.opts.destination, 'docs.json'), JSON.stringify(root), 'utf8');
 };

src/physics/p2/p2.js

@@ -10158,7 +10158,7 @@ Capsule.prototype = new Shape();
  * @method conputeMomentOfInertia
  * @param  {Number} mass
  * @return {Number}
- * @todo
+ * @todo !
  */
 Capsule.prototype.computeMomentOfInertia = function(mass){
     // Approximate with rectangle

tasks/builddoc.js

@@ -0,0 +1,19 @@
+module.exports = {
+    html: {
+        src: ['./README.md'],
+        options: {
+            configure: 'tasks/jsdoc-conf.json',
+            /* The destination and private options must be redefined event if there are always in the configure file otherwise, grunt-jsdoc overwrite it with its default values */
+            destination: 'docs',
+            private: false
+        }
+    },
+    json: {
+        src: [],
+        options: {
+            configure: 'tasks/jsdocexportjson-conf.json',
+            /* The destination optios must be redefined event if there is always in the configure file otherwise, grunt-jsdoc overwrite it with its default value */
+            destination: './out'
+        }
+    }
+};