Commit 6330dfbea6d5434dc694aebd0203ea13e2511a0e | zig

author	Andrew Kelley <andrew@ziglang.org> 2019-10-10 11:03:16-04:00
committer	Andrew Kelley <andrew@ziglang.org> 2019-10-10 11:03:16-04:00
log	6330dfbea6d5434dc694aebd0203ea13e2511a0e
tree	a22bc9534dbbcd0b6632003b40d42684422bef6d
parent	b9d63551de3518001c992ec799a67c2e726d4f5b
signature	Commit is signed but in an unrecognized format.

generated docs: better listing of functions

1 files changed, 19 insertions(+), 18 deletions(-)

lib
- std
  - special
    docs
    main.js

lib/std/special/docs/main.js+19-18

 @@ -376,24 +376,24 @@
         }
     }
-    function typeIndexName(typeIndex, wantHtml, wantLink, fnDecl, skipFnName) {
+    function typeIndexName(typeIndex, wantHtml, wantLink, fnDecl, linkFnNameDecl) {
         var typeObj = zigAnalysis.types[typeIndex];
         if (wantLink) {
             var declIndex = getCanonTypeDecl(typeIndex);
             var declPath = getCanonDeclPath(declIndex);
             var haveLink = declPath != null;
-            var typeNameHtml = typeName(typeObj, true, !haveLink, fnDecl, skipFnName);
+            var typeNameHtml = typeName(typeObj, true, !haveLink, fnDecl, linkFnNameDecl);
             if (haveLink) {
                 return '<a href="' + navLink(declPath.pkgNames, declPath.declNames) + '">' + typeNameHtml + '</a>';
             } else {
                 return typeNameHtml;
             }
         } else {
-            return typeName(typeObj, wantHtml, false, fnDecl, skipFnName);
+            return typeName(typeObj, wantHtml, false, fnDecl, linkFnNameDecl);
         }
     }
-    function typeName(typeObj, wantHtml, wantSubLink, fnDecl, skipFnName) {
+    function typeName(typeObj, wantHtml, wantSubLink, fnDecl, linkFnNameDecl) {
         switch (typeObj.kind) {
             case typeKinds.Array:
                 var name = "[";
 @@ -542,8 +542,15 @@
                 var payloadHtml = "";
                 if (wantHtml) {
                     payloadHtml += '<span class="tok-kw">fn</span>';
-                    if (fnDecl != null && !skipFnName) {
+                    if (fnDecl != null) {
-                        payloadHtml += ' <span class="tok-fn">' + escapeHtml(fnDecl.name) + '</span>';
+                        payloadHtml += ' <span class="tok-fn">';
+                        if (linkFnNameDecl != null) {
+                            payloadHtml += '<a href="' + linkFnNameDecl + '">' +
+                                escapeHtml(fnDecl.name) + '</a>';
+                        } else {
+                            payloadHtml += escapeHtml(fnDecl.name);
+                        }
+                        payloadHtml += '</span>';
                     }
                 } else {
                     payloadHtml += 'fn'
 @@ -655,7 +662,7 @@
     }
     function renderValue(decl) {
-        domFnProtoCode.innerHTML = '<span class="tok-kw">pub</span> <span class="tok-kw">const</span> ' +
+        domFnProtoCode.innerHTML = '<span class="tok-kw">const</span> ' +
             escapeHtml(decl.name) + ': ' + typeIndexName(decl.type, true, true);
         var docs = zigAnalysis.astNodes[decl.src].docs;
 @@ -668,7 +675,7 @@
     }
     function renderVar(decl) {
-        domFnProtoCode.innerHTML = '<span class="tok-kw">pub</span> <span class="tok-kw">var</span> ' +
+        domFnProtoCode.innerHTML = '<span class="tok-kw">var</span> ' +
             escapeHtml(decl.name) + ': ' + typeIndexName(decl.type, true, true);
         var docs = zigAnalysis.astNodes[decl.src].docs;
 @@ -758,21 +765,15 @@
         }
         if (fnsList.length !== 0) {
-            resizeDomList(domListFns, fnsList.length,
+            resizeDomList(domListFns, fnsList.length, '<tr><td></td><td></td></tr>');
-                '<tr><td><a href="#"></a></td><td></td><td></td></tr>');
             for (var i = 0; i < fnsList.length; i += 1) {
                 var decl = fnsList[i];
                 var trDom = domListFns.children[i];
-                var tdName = trDom.children[0];
+                var tdFnCode = trDom.children[0];
-                var tdNameA = tdName.children[0];
+                var tdDesc = trDom.children[1];
-                var tdType = trDom.children[1];
-                var tdDesc = trDom.children[2];
-                tdNameA.setAttribute('href', navLinkDecl(decl.name));
-                tdNameA.textContent = decl.name;
-                tdType.innerHTML = typeIndexName(decl.type, true, true, decl, true);
+                tdFnCode.innerHTML = typeIndexName(decl.type, true, true, decl, navLinkDecl(decl.name));
                 var docs = zigAnalysis.astNodes[decl.src].docs;
                 if (docs != null) {