no empty column templates

#style
cppalliance · Jan 2, 2025 · b305f67 · b305f67
1 parent 351658e
commit b305f67
Show file tree

Hide file tree

Showing 160 changed files with 2,770 additions and 6,059 deletions.
diff --git a/share/mrdocs/addons/generator/common/partials/symbol/detail/members-table-row.hbs b/share/mrdocs/addons/generator/common/partials/symbol/detail/members-table-row.hbs
@@ -4,13 +4,15 @@
 {{! Member name, linked to its documentation }}
 {{#>markup/a href=url}}{{#>markup/code}}{{>symbol/name . nolink=true}}{{/markup/code}}{{/markup/a}} {{>symbol/special-function-suffix .}}
 {{~/markup/td}}
+{{#if (eq includeBrief true)}}
 {{#>markup/td}}
 {{#if (ne kind "overloads")~}}
 {{{~doc.brief}}}
 {{else~}}
 {{#each (unique (pluck (pluck members "doc") "brief"))~}}
 {{{.}}}
 {{/each~}}
+{{/if~}}
+{{~/markup/td~}}
 {{/if}}
-{{~/markup/td}}
 {{~/markup/tr}}
diff --git a/share/mrdocs/addons/generator/common/partials/symbol/members-table.hbs b/share/mrdocs/addons/generator/common/partials/symbol/members-table.hbs
@@ -13,6 +13,7 @@
 --}}
 {{#if (any_of_by members "isRegular" "isSeeBelow")}}
 {{#>markup/h level=(select @root.config.multipage 1 2)}}{{title}}{{/markup/h}}
+{{#if (any_of_by members "doc")}}
 {{#>markup/table cols=2}}
 {{#>markup/thead}}
 {{#>markup/tr~}}
@@ -22,8 +23,22 @@
 {{/markup/thead}}
 {{#>markup/tbody}}
 {{#each (filter_by (sort_by members "name") "isRegular" "isSeeBelow")}}
-{{> symbol/detail/members-table-row .}}
+{{> symbol/detail/members-table-row . includeBrief=true}}
 {{/each}}
 {{/markup/tbody}}
 {{/markup/table}}
+{{else}}
+{{#>markup/table cols=1}}
+{{#>markup/thead}}
+{{#>markup/tr~}}
+{{#>markup/th}}Name{{/markup/th}}
+{{/markup/tr}}
+{{/markup/thead}}
+{{#>markup/tbody}}
+{{#each (filter_by (sort_by members "name") "isRegular" "isSeeBelow")}}
+{{> symbol/detail/members-table-row . includeBrief=false}}
+{{/each}}
+{{/markup/tbody}}
+{{/markup/table}}
+{{/if}}
 {{/if}}
diff --git a/test-files/golden-tests/core/libcxx.adoc b/test-files/golden-tests/core/libcxx.adoc
@@ -7,13 +7,11 @@
 
 === Namespaces
 
-[cols=2]
+[cols=1]
 |===
-| Name | Description 
+| Name 
 
 | <<std,`std`>> 
-| 
-
 |===
 === Functions
 

diff --git a/test-files/golden-tests/core/libcxx.html b/test-files/golden-tests/core/libcxx.html
@@ -13,13 +13,12 @@ <h2>Namespaces</h2>
 <table style="table-layout: fixed; width: 100%;">
 <thead>
 <tr>
-<th>Name</th><th>Description</th>
+<th>Name</th>
 </tr>
 </thead>
 <tbody>
 <tr>
-<td><a href="#std"><code>std</code></a> </td><td>
-</td></tr>
+<td><a href="#std"><code>std</code></a> </td></tr>
 </tbody>
 </table>
 <h2>Functions</h2>

diff --git a/test-files/golden-tests/core/utf-8.adoc b/test-files/golden-tests/core/utf-8.adoc
@@ -7,13 +7,11 @@
 
 === Functions
 
-[cols=2]
+[cols=1]
 |===
-| Name | Description 
+| Name 
 
 | <<Христос_воскрес,`Христос&lowbar;воскрес`>> 
-| 
-
 |===
 
 [#Христос_воскрес]

diff --git a/test-files/golden-tests/core/utf-8.html b/test-files/golden-tests/core/utf-8.html
@@ -13,13 +13,12 @@ <h2>Functions</h2>
 <table style="table-layout: fixed; width: 100%;">
 <thead>
 <tr>
-<th>Name</th><th>Description</th>
+<th>Name</th>
 </tr>
 </thead>
 <tbody>
 <tr>
-<td><a href="#Христос_воскрес"><code>Христос_воскрес</code></a> </td><td>
-</td></tr>
+<td><a href="#Христос_воскрес"><code>Христос_воскрес</code></a> </td></tr>
 </tbody>
 </table>
 </div>

diff --git a/test-files/golden-tests/filters/file/include-self.adoc b/test-files/golden-tests/filters/file/include-self.adoc
@@ -7,13 +7,11 @@
 
 === Namespaces
 
-[cols=2]
+[cols=1]
 |===
-| Name | Description 
+| Name 
 
 | <<TEST,`TEST`>> 
-| 
-
 |===
 
 [#TEST]
@@ -22,13 +20,11 @@
 
 === Types
 
-[cols=2]
+[cols=1]
 |===
-| Name | Description 
+| Name 
 
 | <<TEST-SUCCESS,`SUCCESS`>> 
-| 
-
 |===
 
 [#TEST-SUCCESS]

diff --git a/test-files/golden-tests/filters/file/include-self.html b/test-files/golden-tests/filters/file/include-self.html
@@ -13,13 +13,12 @@ <h2>Namespaces</h2>
 <table style="table-layout: fixed; width: 100%;">
 <thead>
 <tr>
-<th>Name</th><th>Description</th>
+<th>Name</th>
 </tr>
 </thead>
 <tbody>
 <tr>
-<td><a href="#TEST"><code>TEST</code></a> </td><td>
-</td></tr>
+<td><a href="#TEST"><code>TEST</code></a> </td></tr>
 </tbody>
 </table>
 </div>
@@ -31,13 +30,12 @@ <h2>Types</h2>
 <table style="table-layout: fixed; width: 100%;">
 <thead>
 <tr>
-<th>Name</th><th>Description</th>
+<th>Name</th>
 </tr>
 </thead>
 <tbody>
 <tr>
-<td><a href="#TEST-SUCCESS"><code>SUCCESS</code></a> </td><td>
-</td></tr>
+<td><a href="#TEST-SUCCESS"><code>SUCCESS</code></a> </td></tr>
 </tbody>
 </table>
 </div>

diff --git a/test-files/golden-tests/filters/symbol-name/blacklist_0.adoc b/test-files/golden-tests/filters/symbol-name/blacklist_0.adoc
@@ -7,22 +7,14 @@
 
 === Namespaces
 
-[cols=2]
+[cols=1]
 |===
-| Name | Description 
+| Name 
 
 | <<N0,`N0`>> 
-| 
-
 | <<N3,`N3`>> 
-| 
-
 | <<N4,`N4`>> 
-| 
-
 | <<N7,`N7`>> 
-| 
-
 |===
 
 [#N0]
@@ -31,13 +23,11 @@
 
 === Functions
 
-[cols=2]
+[cols=1]
 |===
-| Name | Description 
+| Name 
 
 | <<N0-f0,`f0`>> 
-| 
-
 |===
 
 [#N0-f0]
@@ -66,16 +56,12 @@ f0();
 
 === Namespaces
 
-[cols=2]
+[cols=1]
 |===
-| Name | Description 
+| Name 
 
 | <<N4-N5,`N5`>> 
-| 
-
 | <<N4-N6,`N6`>> 
-| 
-
 |===
 
 [#N4-N5]
@@ -84,13 +70,11 @@ f0();
 
 === Functions
 
-[cols=2]
+[cols=1]
 |===
-| Name | Description 
+| Name 
 
 | <<N4-N5-f1,`f1`>> 
-| 
-
 |===
 
 [#N4-N5-f1]
@@ -114,13 +98,11 @@ f1();
 
 === Functions
 
-[cols=2]
+[cols=1]
 |===
-| Name | Description 
+| Name 
 
 | <<N4-N6-f1,`f1`>> 
-| 
-
 |===
 
 [#N4-N6-f1]
@@ -144,16 +126,12 @@ f1();
 
 === Namespaces
 
-[cols=2]
+[cols=1]
 |===
-| Name | Description 
+| Name 
 
 | <<N7-N8,`N8`>> 
-| 
-
 | <<N7-N9,`N9`>> 
-| 
-
 |===
 
 [#N7-N8]
@@ -167,13 +145,11 @@ f1();
 
 === Functions
 
-[cols=2]
+[cols=1]
 |===
-| Name | Description 
+| Name 
 
 | <<N7-N9-g0,`g0`>> 
-| 
-
 |===
 
 [#N7-N9-g0]