From: Vladimír Vondruš <mosra@centrum.cz>
Date: Thu, 13 Sep 2018 10:18:16 +0000 (+0200)
Subject: doxygen: display the deprecation label next to the name, not after brief.
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~cjwatson/git?a=commitdiff_plain;h=83ad8df83e846d438c2fd437948a06ac0a9177d0;p=blog.git

doxygen: display the deprecation label next to the name, not after brief.
---

diff --git a/doxygen/templates/annotated.html b/doxygen/templates/annotated.html
index f2b83fe5..c1e156ec 100644
--- a/doxygen/templates/annotated.html
+++ b/doxygen/templates/annotated.html
@@ -7,15 +7,13 @@
           {% for i in index.symbols recursive %}
           {% if i.children %}
           <li class="m-dox-collapsible{% if loop.depth > M_CLASS_TREE_EXPAND_LEVELS or (i.kind != 'namespace' and not M_EXPAND_INNER_TYPES) %} collapsed{% endif %}">
-            <a href="#" onclick="return toggle(this)">{{ i.kind }}</a> <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a> <span class="m-dox">{{ i.brief }}</span>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %}
-
-            {# the above is here to preserve the newline #}
+            <a href="#" onclick="return toggle(this)">{{ i.kind }}</a> <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %} <span class="m-dox">{{ i.brief }}</span>
             <ul class="m-dox">
 {{ loop(i.children)|indent(4, true) }}
             </ul>
           </li>
           {% else %}
-          <li>{{ i.kind }} <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a> <span class="m-dox">{{ i.brief }}</span>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %}</li>
+          <li>{{ i.kind }} <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %} <span class="m-dox">{{ i.brief }}</span></li>
           {% endif %}
           {% endfor %}
         </ul>
diff --git a/doxygen/templates/files.html b/doxygen/templates/files.html
index 602cc8c6..09efe44a 100644
--- a/doxygen/templates/files.html
+++ b/doxygen/templates/files.html
@@ -7,15 +7,13 @@
           {% for i in index.files recursive %}
           {% if i.children %}
           <li class="m-dox-collapsible{% if loop.depth > M_FILE_TREE_EXPAND_LEVELS %} collapsed{% endif %}">
-            <a href="#" onclick="return toggle(this)">{{ i.kind }}</a> <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a> <span class="m-dox">{{ i.brief }}</span>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %}
-
-            {# the above is here to preserve the newline #}
+            <a href="#" onclick="return toggle(this)">{{ i.kind }}</a> <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %} <span class="m-dox">{{ i.brief }}</span>
             <ul class="m-dox">
 {{ loop(i.children)|indent(4, true) }}
             </ul>
           </li>
           {% else %}
-          <li>{{ i.kind }} <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a> <span class="m-dox">{{ i.brief }}</span>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %}</li>
+          <li>{{ i.kind }} <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %} <span class="m-dox">{{ i.brief }}</span></li>
           {% endif %}
           {% endfor %}
         </ul>
diff --git a/doxygen/templates/modules.html b/doxygen/templates/modules.html
index c43d0a56..68ab0266 100644
--- a/doxygen/templates/modules.html
+++ b/doxygen/templates/modules.html
@@ -7,15 +7,13 @@
           {% for i in index.modules recursive %}
           {% if i.has_nestable_children %}
           <li class="m-dox-collapsible">
-            <a href="#" onclick="return toggle(this)">module</a> <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a> <span class="m-dox">{{ i.brief }}</span>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %}
-
-            {# the above is here to preserve the newline #}
+            <a href="#" onclick="return toggle(this)">module</a> <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %} <span class="m-dox">{{ i.brief }}</span>
             <ul class="m-dox">
 {{ loop(i.children)|indent(4, true) }}
             </ul>
           </li>
           {% else %}
-          <li>module <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a> <span class="m-dox">{{ i.brief }}</span>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %}</li>
+          <li>module <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %} <span class="m-dox">{{ i.brief }}</span></li>
           {% endif %}
           {% endfor %}
         </ul>
diff --git a/doxygen/templates/namespaces.html b/doxygen/templates/namespaces.html
index 70b2bc8f..63794bc1 100644
--- a/doxygen/templates/namespaces.html
+++ b/doxygen/templates/namespaces.html
@@ -7,15 +7,13 @@
           {% for i in index.symbols|selectattr('kind', 'equalto', 'namespace') recursive %}
           {% if i.has_nestable_children %}
           <li class="m-dox-collapsible">
-            <a href="#" onclick="return toggle(this)">{{ i.kind }}</a> <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a> <span class="m-dox">{{ i.brief }}</span>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %}
-
-            {# the above is here to preserve the newline #}
+            <a href="#" onclick="return toggle(this)">{{ i.kind }}</a> <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %} <span class="m-dox">{{ i.brief }}</span>
             <ul class="m-dox">
 {{ loop(i.children|selectattr('kind', 'equalto', 'namespace'))|indent(4, true) }}
             </ul>
           </li>
           {% else %}
-          <li>{{ i.kind }} <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a> <span class="m-dox">{{ i.brief }}</span>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %}</li>
+          <li>{{ i.kind }} <a href="{{ i.url }}" class="m-dox">{{ i.name }}</a>{% if i.is_deprecated %} <span class="m-label m-danger">deprecated</span>{% endif %} <span class="m-dox">{{ i.brief }}</span></li>
           {% endif %}
           {% endfor %}
         </ul>
diff --git a/doxygen/test/compound_deprecated/annotated.html b/doxygen/test/compound_deprecated/annotated.html
index d4a13d7f..6a7fba39 100644
--- a/doxygen/test/compound_deprecated/annotated.html
+++ b/doxygen/test/compound_deprecated/annotated.html
@@ -22,12 +22,12 @@
         <h1>Classes</h2>
         <ul class="m-dox">
           <li class="m-dox-collapsible">
-            <a href="#" onclick="return toggle(this)">namespace</a> <a href="namespaceDeprecatedNamespace.html" class="m-dox">DeprecatedNamespace</a> <span class="m-dox">A namespace.</span> <span class="m-label m-danger">deprecated</span>
+            <a href="#" onclick="return toggle(this)">namespace</a> <a href="namespaceDeprecatedNamespace.html" class="m-dox">DeprecatedNamespace</a> <span class="m-label m-danger">deprecated</span> <span class="m-dox">A namespace.</span>
             <ul class="m-dox">
-              <li>struct <a href="structDeprecatedNamespace_1_1BaseDeprecatedClass.html" class="m-dox">BaseDeprecatedClass</a> <span class="m-dox">A base class.</span> <span class="m-label m-danger">deprecated</span></li>
-              <li>struct <a href="structDeprecatedNamespace_1_1DeprecatedClass.html" class="m-dox">DeprecatedClass</a> <span class="m-dox">A class.</span> <span class="m-label m-danger">deprecated</span></li>
-              <li>struct <a href="structDeprecatedNamespace_1_1DeprecatedStruct.html" class="m-dox">DeprecatedStruct</a> <span class="m-dox">A struct.</span> <span class="m-label m-danger">deprecated</span></li>
-              <li>union <a href="unionDeprecatedNamespace_1_1DeprecatedUnion.html" class="m-dox">DeprecatedUnion</a> <span class="m-dox">An union.</span> <span class="m-label m-danger">deprecated</span></li>
+              <li>struct <a href="structDeprecatedNamespace_1_1BaseDeprecatedClass.html" class="m-dox">BaseDeprecatedClass</a> <span class="m-label m-danger">deprecated</span> <span class="m-dox">A base class.</span></li>
+              <li>struct <a href="structDeprecatedNamespace_1_1DeprecatedClass.html" class="m-dox">DeprecatedClass</a> <span class="m-label m-danger">deprecated</span> <span class="m-dox">A class.</span></li>
+              <li>struct <a href="structDeprecatedNamespace_1_1DeprecatedStruct.html" class="m-dox">DeprecatedStruct</a> <span class="m-label m-danger">deprecated</span> <span class="m-dox">A struct.</span></li>
+              <li>union <a href="unionDeprecatedNamespace_1_1DeprecatedUnion.html" class="m-dox">DeprecatedUnion</a> <span class="m-label m-danger">deprecated</span> <span class="m-dox">An union.</span></li>
             </ul>
           </li>
         </ul>
diff --git a/doxygen/test/compound_deprecated/files.html b/doxygen/test/compound_deprecated/files.html
index 4bbbc429..70f8fac8 100644
--- a/doxygen/test/compound_deprecated/files.html
+++ b/doxygen/test/compound_deprecated/files.html
@@ -25,12 +25,12 @@
             <a href="#" onclick="return toggle(this)">dir</a> <a href="dir_da5033def2d0db76e9883b31b76b3d0c.html" class="m-dox">Dir</a> <span class="m-dox">A directory.</span>
             <ul class="m-dox">
               <li class="m-dox-collapsible collapsed">
-                <a href="#" onclick="return toggle(this)">dir</a> <a href="dir_89d28accb4b69f59411b7eddd48bbfbd.html" class="m-dox">DeprecatedSubdir</a> <span class="m-dox">A directory.</span> <span class="m-label m-danger">deprecated</span>
+                <a href="#" onclick="return toggle(this)">dir</a> <a href="dir_89d28accb4b69f59411b7eddd48bbfbd.html" class="m-dox">DeprecatedSubdir</a> <span class="m-label m-danger">deprecated</span> <span class="m-dox">A directory.</span>
                 <ul class="m-dox">
                   <li>file <a href="File_8h.html" class="m-dox">File.h</a> <span class="m-dox">A file.</span></li>
                 </ul>
               </li>
-              <li>file <a href="DeprecatedFile_8h.html" class="m-dox">DeprecatedFile.h</a> <span class="m-dox">A file.</span> <span class="m-label m-danger">deprecated</span></li>
+              <li>file <a href="DeprecatedFile_8h.html" class="m-dox">DeprecatedFile.h</a> <span class="m-label m-danger">deprecated</span> <span class="m-dox">A file.</span></li>
             </ul>
           </li>
         </ul>
@@ -54,4 +54,4 @@
   </div>
 </article></main>
 </body>
-</html>
\ No newline at end of file
+</html>
diff --git a/doxygen/test/compound_deprecated/modules.html b/doxygen/test/compound_deprecated/modules.html
index 261cffc6..215598b2 100644
--- a/doxygen/test/compound_deprecated/modules.html
+++ b/doxygen/test/compound_deprecated/modules.html
@@ -24,7 +24,7 @@
           <li class="m-dox-collapsible">
             <a href="#" onclick="return toggle(this)">module</a> <a href="group__group.html" class="m-dox">A group</a> <span class="m-dox"></span>
             <ul class="m-dox">
-              <li>module <a href="group__deprecated-group.html" class="m-dox">A group</a> <span class="m-dox"></span> <span class="m-label m-danger">deprecated</span></li>
+              <li>module <a href="group__deprecated-group.html" class="m-dox">A group</a> <span class="m-label m-danger">deprecated</span> <span class="m-dox"></span></li>
             </ul>
           </li>
         </ul>
@@ -48,4 +48,4 @@
   </div>
 </article></main>
 </body>
-</html>
\ No newline at end of file
+</html>
diff --git a/doxygen/test/compound_deprecated/namespaces.html b/doxygen/test/compound_deprecated/namespaces.html
index 891726dd..6ed2b5fb 100644
--- a/doxygen/test/compound_deprecated/namespaces.html
+++ b/doxygen/test/compound_deprecated/namespaces.html
@@ -21,7 +21,7 @@
       <div class="m-col-l-10 m-push-l-1">
         <h1>Namespaces</h2>
         <ul class="m-dox">
-          <li>namespace <a href="namespaceDeprecatedNamespace.html" class="m-dox">DeprecatedNamespace</a> <span class="m-dox">A namespace.</span> <span class="m-label m-danger">deprecated</span></li>
+          <li>namespace <a href="namespaceDeprecatedNamespace.html" class="m-dox">DeprecatedNamespace</a> <span class="m-label m-danger">deprecated</span> <span class="m-dox">A namespace.</span></li>
         </ul>
         <script>
         function toggle(e) {