authorgravatar for andrew@ziglang.orgAndrew Kelley <andrew@ziglang.org> 2019-10-08 23:33:19-04:00
committergravatar for andrew@ziglang.orgAndrew Kelley <andrew@ziglang.org> 2019-10-08 23:33:19-04:00
log71fb4ef8dad086321d98cac1cb10ac5869a53e76
treed713cbaf9b2c933bb497598e21a97ea12aedc951
parent1586f244c44fa8814877c249a1c295e8a3785c2e
signaturelock-open Commit is signed but in an unrecognized format.

generated docs: separate Error Sets from Types


2 files changed, 34 insertions(+), 1 deletions(-)

lib/std/special/docs/index.html+5
...@@ -330,6 +330,11 @@...@@ -330,6 +330,11 @@
330 <ul id="listFns">330 <ul id="listFns">
331 </ul>331 </ul>
332 </div>332 </div>
333 <div id="sectErrSets" class="hidden">
334 <h2>Error Sets</h2>
335 <ul id="listErrSets">
336 </ul>
337 </div>
333 </section>338 </section>
334 <div id="helpDialog" class="hidden">339 <div id="helpDialog" class="hidden">
335 <h1>Keyboard Shortcuts</h1>340 <h1>Keyboard Shortcuts</h1>
lib/std/special/docs/main.js+29-1
...@@ -6,6 +6,8 @@...@@ -6,6 +6,8 @@
6 var domListPkgs = document.getElementById("listPkgs");6 var domListPkgs = document.getElementById("listPkgs");
7 var domSectTypes = document.getElementById("sectTypes");7 var domSectTypes = document.getElementById("sectTypes");
8 var domListTypes = document.getElementById("listTypes");8 var domListTypes = document.getElementById("listTypes");
9 var domSectErrSets = document.getElementById("sectErrSets");
10 var domListErrSets = document.getElementById("listErrSets");
9 var domSectFns = document.getElementById("sectFns");11 var domSectFns = document.getElementById("sectFns");
10 var domListFns = document.getElementById("listFns");12 var domListFns = document.getElementById("listFns");
11 var domSectFields = document.getElementById("sectFields");13 var domSectFields = document.getElementById("sectFields");
...@@ -101,6 +103,7 @@...@@ -101,6 +103,7 @@
101 domFnDocs.classList.add("hidden");103 domFnDocs.classList.add("hidden");
102 domSectPkgs.classList.add("hidden");104 domSectPkgs.classList.add("hidden");
103 domSectTypes.classList.add("hidden");105 domSectTypes.classList.add("hidden");
106 domSectErrSets.classList.add("hidden");
104 domSectFns.classList.add("hidden");107 domSectFns.classList.add("hidden");
105 domSectFields.classList.add("hidden");108 domSectFields.classList.add("hidden");
106 domSectSearchResults.classList.add("hidden");109 domSectSearchResults.classList.add("hidden");
...@@ -174,6 +177,11 @@...@@ -174,6 +177,11 @@
174 }177 }
175 }178 }
176179
180 function typeIsErrSet(typeIndex) {
181 var typeObj = zigAnalysis.types[typeIndex];
182 return typeObj.kind === typeKindErrSetId;
183 }
184
177 function typeIsGenericFn(typeIndex) {185 function typeIsGenericFn(typeIndex) {
178 var typeObj = zigAnalysis.types[typeIndex];186 var typeObj = zigAnalysis.types[typeIndex];
179 if (typeObj.kind !== typeKindFnId) {187 if (typeObj.kind !== typeKindFnId) {
...@@ -578,6 +586,7 @@...@@ -578,6 +586,7 @@
578586
579 function renderContainer(container) {587 function renderContainer(container) {
580 var typesList = [];588 var typesList = [];
589 var errSetsList = [];
581 var fnsList = [];590 var fnsList = [];
582 var varsList = [];591 var varsList = [];
583 for (var i = 0; i < container.pubDecls.length; i += 1) {592 for (var i = 0; i < container.pubDecls.length; i += 1) {
...@@ -588,7 +597,11 @@...@@ -588,7 +597,11 @@
588 }597 }
589 if (decl.type != null) {598 if (decl.type != null) {
590 if (decl.type == typeTypeId) {599 if (decl.type == typeTypeId) {
591 typesList.push(decl);600 if (typeIsErrSet(decl.value)) {
601 errSetsList.push(decl);
602 } else {
603 typesList.push(decl);
604 }
592 } else {605 } else {
593 var typeKind = zigAnalysis.types[decl.type].kind;606 var typeKind = zigAnalysis.types[decl.type].kind;
594 if (typeKind === typeKindFnId) {607 if (typeKind === typeKindFnId) {
...@@ -604,6 +617,9 @@...@@ -604,6 +617,9 @@
604 typesList.sort(function(a, b) {617 typesList.sort(function(a, b) {
605 return operatorCompare(a.name, b.name);618 return operatorCompare(a.name, b.name);
606 });619 });
620 errSetsList.sort(function(a, b) {
621 return operatorCompare(a.name, b.name);
622 });
607 fnsList.sort(function(a, b) {623 fnsList.sort(function(a, b) {
608 return operatorCompare(a.name, b.name);624 return operatorCompare(a.name, b.name);
609 });625 });
...@@ -623,6 +639,18 @@...@@ -623,6 +639,18 @@
623 domSectTypes.classList.remove("hidden");639 domSectTypes.classList.remove("hidden");
624 }640 }
625641
642 if (errSetsList.length !== 0) {
643 resizeDomList(domListErrSets, errSetsList.length, '<li><a href="#"></a></li>');
644 for (var i = 0; i < errSetsList.length; i += 1) {
645 var liDom = domListErrSets.children[i];
646 var aDom = liDom.children[0];
647 var decl = errSetsList[i];
648 aDom.textContent = decl.name;
649 aDom.setAttribute('href', navLinkDecl(decl.name));
650 }
651 domSectErrSets.classList.remove("hidden");
652 }
653
626 if (fnsList.length !== 0) {654 if (fnsList.length !== 0) {
627 resizeDomList(domListFns, fnsList.length, '<li><a href="#"></a></li>');655 resizeDomList(domListFns, fnsList.length, '<li><a href="#"></a></li>');
628 for (var i = 0; i < fnsList.length; i += 1) {656 for (var i = 0; i < fnsList.length; i += 1) {