optional description of @param and @returns

src/ngdoc.js

@@ -390,7 +390,7 @@ Doc.prototype = {
         this.shortName = this.name.split(".").pop().trim();
       }
     }
-    
+
     this.id = this.id || // if we have an id just use it
       (this.ngdoc === 'error' ? this.name : '') ||
       (((this.file||'').match(/.*(\/|\\)([^(\/|\\)]*)\.ngdoc/)||{})[2]) || // try to extract it from file name
@@ -409,16 +409,16 @@ Doc.prototype = {
             self.moduleName = match[1];
           }
         } else if (atName == 'param') {
-          match = text.match(/^\{([^}]+)\}\s+(([^\s=]+)|\[(\S+)=([^\]]+)\])\s+(.*)/);
-                             //  1      1    23       3   4   4 5      5  2   6  6
+          match = text.match(/^\{([^}]+)}\s+(([^\s=]+)|\[(\S+)=([^\]]+)])(?:\s+(.*)|$)/);
+                             //  1     1    23       3   4   4 5      5 2      6  6
           if (!match) {
             throw new Error("Not a valid 'param' format: " + text + ' (found in: ' + self.file + ':' + self.line + ')');
           }
 
           var optional = (match[1].slice(-1) === '=');
           var param = {
             name: match[4] || match[3],
-            description:self.markdown(text.replace(match[0], match[6])),
+            description: match[6] ? self.markdown(text.replace(match[0], match[6])) : '',
             type: optional ? match[1].substring(0, match[1].length-1) : match[1],
             optional: optional,
             default: match[5]
@@ -440,13 +440,13 @@ Doc.prototype = {
             self.param.push(param);
           }
         } else if (atName == 'returns' || atName == 'return') {
-          match = text.match(/^\{([^}]+)\}\s+(.*)/);
+          match = text.match(/^\{([^}]+)}(?:\s+(.*)|$)/);
           if (!match) {
             throw new Error("Not a valid 'returns' format: " + text + ' (found in: ' + self.file + ':' + self.line + ')');
           }
           self.returns = {
             type: match[1],
-            description: self.markdown(text.replace(match[0], match[2]))
+            description: match[2] ? self.markdown(text.replace(match[0], match[2])) : ''
           };
         } else if(atName == 'requires') {
           match = text.match(/^([^\s]*)\s*([\S\s]*)/);
@@ -609,6 +609,7 @@ Doc.prototype = {
 
           dom.html('</td>');
           dom.html('<td>');
+
           dom.html(param.description);
           if (param.default) {
             dom.html(' <p><em>(default: ' + param.default + ')</em></p>');