From: Vladimír Vondruš <mosra@centrum.cz>
Date: Mon, 29 Jan 2018 22:47:32 +0000 (+0100)
Subject: doxygen: render Reference in TOC only if there is some reference.
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~cjwatson/git?a=commitdiff_plain;h=10d62f3e19eeea7a7a99d4e5cd756e0aadd33233;p=blog.git

doxygen: render Reference in TOC only if there is some reference.
---

diff --git a/doxygen/templates/base-reference.html b/doxygen/templates/base-reference.html
index 811fe571..51a87e05 100644
--- a/doxygen/templates/base-reference.html
+++ b/doxygen/templates/base-reference.html
@@ -41,6 +41,7 @@
             <li><a href="#{{ id }}">{{ name }}</a></li>
             {% endif %}
             {% endfor %}
+            {% if compound.modules or compound.dirs or compound.files or compound.namespaces or compound.classes or compound.typedefs or compound.funcs or compound.vars or compound.defines or compound.groups %}
             <li>
               Reference
               <ul>
@@ -79,6 +80,7 @@
                 {% endfor %}
               </ul>
             </li>
+            {% endif %}
           </ul>
         </div>
         {% endif %}
diff --git a/doxygen/test/compound_modules/group__subgroup.html b/doxygen/test/compound_modules/group__subgroup.html
index 73269df6..0033b88c 100644
--- a/doxygen/test/compound_modules/group__subgroup.html
+++ b/doxygen/test/compound_modules/group__subgroup.html
@@ -35,33 +35,10 @@
         <div class="m-block m-default">
           <h3>Contents</h3>
           <ul>
-            <li>
-              Reference
-              <ul>
-                <li><a href="#func-members">Functions</a></li>
-              </ul>
-            </li>
+            <li><a href="#subgroup-description">Description</a></li>
           </ul>
         </div>
-        <section id="func-members">
-          <h2><a href="#func-members">Functions</a></h3>
-          <dl class="m-dox">
-            <dt>
-              <span class="m-dox-wrap-bumper">auto <a href="#gac0124d4b60010824c0b73bd5f27759c6" class="m-dox">fizzbuzz</a>(</span><span class="m-dox-wrap">) -&gt; int</span>
-            </dt>
-            <dd>Returns 5 every 5 runs or something.</dd>
-          </dl>
-        </section>
-        <section>
-          <h2>Function documentation</h2>
-          <section class="m-dox-details" id="gac0124d4b60010824c0b73bd5f27759c6"><div>
-            <h3>
-              <span class="m-dox-wrap-bumper">int </span><span class="m-dox-wrap"><span class="m-dox-wrap-bumper"><a href="#gac0124d4b60010824c0b73bd5f27759c6" class="m-dox-self">fizzbuzz</a>(</span><span class="m-dox-wrap">)</span></span>
-            </h3>
-            <p>Returns 5 every 5 runs or something.</p>
-<p>Did I pass the interview now?</p>
-          </div></section>
-        </section>
+<section id="subgroup-description"><h2><a href="#subgroup-description">Description</a></h2><p>Subgroup description. There are <strong>no members</strong>, so there should be also no Reference section in the TOC.</p></section>
       </div>
     </div>
   </div>
diff --git a/doxygen/test/compound_modules/input.h b/doxygen/test/compound_modules/input.h
index 753fe3a0..c795f7f8 100644
--- a/doxygen/test/compound_modules/input.h
+++ b/doxygen/test/compound_modules/input.h
@@ -21,13 +21,9 @@ void bar();
 @defgroup subgroup A subgroup
 @brief Subgroup brief description
 @ingroup group
-@{ */
 
-/**
-@brief Returns 5 every 5 runs or something
+@section subgroup-description Description
 
-Did I pass the interview now?
+Subgroup description. There are **no members**, so there should be also no
+Reference section in the TOC.
 */
-int fizzbuzz();
-
-/*@}*/