authorgravatar for andrew@ziglang.orgAndrew Kelley <andrew@ziglang.org> 2019-10-08 22:39:12-04:00
committergravatar for andrew@ziglang.orgAndrew Kelley <andrew@ziglang.org> 2019-10-08 22:39:12-04:00
logca3250a57c9d0c4011b66b32c500750087070a08
tree8f17ae2823ebd40f677967d3c61331c529072689
parentcdaaf7c725660de4a9c081abe1ee4078352905c5
signaturelock-open Commit is signed but in an unrecognized format.

generated docs: add global variables

See #3409

2 files changed, 38 insertions(+), 0 deletions(-)

lib/std/special/docs/index.html+5
......@@ -308,6 +308,11 @@
308308 <ul id="listTypes">
309309 </ul>
310310 </div>
311 <div id="sectGlobalVars" class="hidden">
312 <h2>Global Variables</h2>
313 <div id="listGlobalVars">
314 </div>
315 </div>
311316 <div id="sectFns" class="hidden">
312317 <h2>Functions</h2>
313318 <ul id="listFns">
lib/std/special/docs/main.js+33
......@@ -10,6 +10,8 @@
1010 var domListFns = document.getElementById("listFns");
1111 var domSectFields = document.getElementById("sectFields");
1212 var domListFields = document.getElementById("listFields");
13 var domSectGlobalVars = document.getElementById("sectGlobalVars");
14 var domListGlobalVars = document.getElementById("listGlobalVars");
1315 var domFnProto = document.getElementById("fnProto");
1416 var domFnProtoCode = document.getElementById("fnProtoCode");
1517 var domFnDocs = document.getElementById("fnDocs");
......@@ -111,6 +113,7 @@
111113 domFnNoExamples.classList.add("hidden");
112114 domFnErrorsAnyError.classList.add("hidden");
113115 domTableFnErrors.classList.add("hidden");
116 domSectGlobalVars.classList.add("hidden");
114117
115118 renderTitle();
116119 renderInfo();
......@@ -560,8 +563,13 @@
560563 function renderContainer(container) {
561564 var typesList = [];
562565 var fnsList = [];
566 var varsList = [];
563567 for (var i = 0; i < container.pubDecls.length; i += 1) {
564568 var decl = zigAnalysis.decls[container.pubDecls[i]];
569 if (decl.kind === 'var') {
570 varsList.push(decl);
571 continue;
572 }
565573 if (decl.type != null) {
566574 if (decl.type == typeTypeId) {
567575 typesList.push(decl);
......@@ -583,6 +591,9 @@
583591 fnsList.sort(function(a, b) {
584592 return operatorCompare(a.name, b.name);
585593 });
594 varsList.sort(function(a, b) {
595 return operatorCompare(a.name, b.name);
596 });
586597
587598 if (typesList.length !== 0) {
588599 resizeDomList(domListTypes, typesList.length, '<li><a href="#"></a></li>');
......@@ -620,6 +631,27 @@
620631 }
621632 domSectFields.classList.remove("hidden");
622633 }
634
635 if (varsList.length !== 0) {
636 resizeDomList(domListGlobalVars, varsList.length, '<div></div>');
637 for (var i = 0; i < varsList.length; i += 1) {
638 var decl = varsList[i];
639 var divDom = domListGlobalVars.children[i];
640 var innerHtml = "";
641
642 innerHtml += '<pre><span class="tok-kw">pub</span> <span class="tok-kw">var</span> <a href="' +
643 navLinkDecl(decl.name) + '">' + escapeHtml(decl.name) + '</a>: ' +
644 typeIndexName(decl.type, true, true) + '</pre>';
645
646 var docs = zigAnalysis.astNodes[decl.src].docs;
647 if (docs != null) {
648 innerHtml += markdown(docs);
649 }
650
651 divDom.innerHTML = innerHtml;
652 }
653 domSectGlobalVars.classList.remove("hidden");
654 }
623655 }
624656
625657 function operatorCompare(a, b) {
......@@ -917,6 +949,7 @@
917949 break;
918950 case 83:
919951 domSearch.focus();
952 domSearch.select();
920953 ev.preventDefault();
921954 ev.stopPropagation();
922955 startAsyncSearch();