From 8a547d9e811ab3d78b88b2a802338a0550b38902 Mon Sep 17 00:00:00 2001
From: Timon Kruiper <timonkruiper@gmail.com>
Date: Wed, 9 Oct 2019 10:12:08 +0200
Subject: [PATCH] Docs: adds docs comments to struct fields

---
 lib/std/special/docs/index.html |  8 +++++---
 lib/std/special/docs/main.js    | 22 +++++++++++++++++-----
 2 files changed, 22 insertions(+), 8 deletions(-)

diff --git a/lib/std/special/docs/index.html b/lib/std/special/docs/index.html
index 2508308ce..9d6dc2f2a 100644
--- a/lib/std/special/docs/index.html
+++ b/lib/std/special/docs/index.html
@@ -158,7 +158,7 @@
         vertical-align: top;
       }
 
-      #sectGlobalVars td, #sectFns td {
+      #sectGlobalVars td, #sectFns td, #sectFields td {
         vertical-align: top;
         margin: 0;
         padding: 0.5em;
@@ -313,8 +313,10 @@
     </div>
     <div id="sectFields" class="hidden">
       <h2>Fields</h2>
-      <ul id="listFields">
-      </ul>
+      <table>
+        <tbody id="listFields">
+        </tbody>
+      </table>
     </div>
     <div id="sectTypes" class="hidden">
       <h2>Types</h2>
diff --git a/lib/std/special/docs/main.js b/lib/std/special/docs/main.js
index 5d6e00674..27fae11d7 100644
--- a/lib/std/special/docs/main.js
+++ b/lib/std/special/docs/main.js
@@ -693,14 +693,26 @@
         }
 
         if (container.fields.length !== 0) {
-            resizeDomList(domListFields, container.fields.length, '<li></li>');
+            resizeDomList(domListFields, container.fields.length,
+                '<tr><td></td><td></td><td></td></tr>');
             for (var i = 0; i < container.fields.length; i += 1) {
-                var liDom = domListFields.children[i];
                 var field = container.fields[i];
+                var trDom = domListFields.children[i];
 
-                var protoHtml = escapeHtml(field.name) + ": ";
-                protoHtml += typeIndexName(field.type, true, true);
-                liDom.innerHTML = protoHtml;
+                var tdName = trDom.children[0];
+                var tdType = trDom.children[1];
+                var tdDesc = trDom.children[2];
+
+                tdName.textContent = field.name;
+
+                tdType.innerHTML = typeIndexName(field.type, true, true);
+
+                var docs = zigAnalysis.astNodes[field.src].docs;
+                if (docs != null) {
+                    tdDesc.innerHTML = shortDescMarkdown(docs);
+                } else {
+                    tdDesc.textContent = "";
+                }
             }
             domSectFields.classList.remove("hidden");
         }