Add support for "this[Symbol.foo]" members and update Iterable to use it

Author: nkronlage

content/JavaScript/iterable.jsdoc

@@ -9,6 +9,17 @@ You can loop over all values in an iterable object by using a
 
 See %%/Iterator|Iterator%% for more details.
 
+Version:
+ECMAScript 2015
+
+Spec:
+http://www.ecma-international.org/ecma-262/6.0/#sec-iterable-interface
+
+----
+instance[Symbol.iterator] : Iterator
+
+Returns an iterator for this object.
+
 <example>
 // Arrays are a built in Iterable object
 var arr = ['a', 'b', 'c'];
@@ -26,9 +37,3 @@ while (!current.done) {
   current = iterator.next();
 }
 </example>
-
-Version:
-ECMAScript 2015
-
-Spec:
-http://www.ecma-international.org/ecma-262/6.0/#sec-iterable-interface

jsdocparser.js

@@ -468,6 +468,14 @@ var parseMember = function(member) {
     type = type.substring(0, commentStartIndex).trim();
   }
 
+  // Process Indexer [Symbol]
+  if (res = name.match(/^\s*\[\s*(\w*\.\w*)\s*\]/)) {
+    return { parameters: [{ name: res[1] }],
+             type: 'Indexer',
+             returnType: parseMember(type),
+             description: description };
+  }
+
   // Process Indexer
   if (res = name.match(/^\s*\[(.*)\]/)) {
     return { parameters: parseParamList(res[1]),

templates/member.ejs

@@ -170,6 +170,16 @@ var renderMember = function(member, isPrimary, nestedRenderMember) {
     res += '</table>'
     res += '<span class="subfunctionclose">}</span>';
   }
+  else if (!member.type) {
+    if (!/^\w+\.\w+$/.test(member.name)) {
+      throw 'Unexpected member type: ' + member.name; 
+    }
+
+    const nameParts = member.name.split('.');
+    const href = '/' + nameParts[0] + '#' + nameParts[1];
+
+    res = `<a href="${href}">${ res }</a>`;
+  }
   else {
     res += '&nbsp;:&nbsp;' + renderType(member.type);
   }

test-jsdocparser.js

@@ -270,7 +270,8 @@ testParse('[b : c] : d', // indexer
     returnType: 'd'
   });
 
-testParse('a : b, c', // multiple inheritance
-  { name: 'a',
-    type: ['b', 'c']
+testParse('[a.b] : c', // symbol indexer
+  { type: 'Indexer',
+    parameters: [ { name: 'a.b' } ],
+    returnType: 'c'
   });