From: Vladimír Vondruš <mosra@centrum.cz>
Date: Thu, 7 May 2020 14:16:36 +0000 (+0200)
Subject: documentation/doxygen: thanks for this bug also.
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~cjwatson/git?a=commitdiff_plain;h=40fbe68b0083cfbd6fd9eed94e570a4b3559a7f4;p=blog.git

documentation/doxygen: thanks for this bug also.
---

diff --git a/documentation/test_doxygen/compound_includes/First.h b/documentation/test_doxygen/compound_includes/First.h
index 40c92a22..62a48682 100644
--- a/documentation/test_doxygen/compound_includes/First.h
+++ b/documentation/test_doxygen/compound_includes/First.h
@@ -99,6 +99,7 @@ class Class {
 };
 
 /** @defgroup group A group
+@brief Brief description. If this is not present, the detailed description gets interpreted as brief in 1.8.18. FFS.
 
 All entries inside should have include information. (Unless the includes are disabled globally or the file is not documented.)
 @{ */
diff --git a/documentation/test_doxygen/compound_includes/group__group.html b/documentation/test_doxygen/compound_includes/group__group.html
index ae69bf6e..84c8bddb 100644
--- a/documentation/test_doxygen/compound_includes/group__group.html
+++ b/documentation/test_doxygen/compound_includes/group__group.html
@@ -21,6 +21,7 @@
       <div class="m-col-l-10 m-push-l-1">
         <h1>
           A group <span class="m-thin">module</span></h1>
+        <p>Brief description. If this is not present, the detailed description gets interpreted as brief in 1.8.18. FFS.</p>
         <div class="m-block m-default">
           <h3>Contents</h3>
           <ul>
diff --git a/documentation/test_doxygen/compound_includes_disabled/group__group.html b/documentation/test_doxygen/compound_includes_disabled/group__group.html
index 67de4f41..2d86e671 100644
--- a/documentation/test_doxygen/compound_includes_disabled/group__group.html
+++ b/documentation/test_doxygen/compound_includes_disabled/group__group.html
@@ -21,6 +21,7 @@
       <div class="m-col-l-10 m-push-l-1">
         <h1>
           A group <span class="m-thin">module</span></h1>
+        <p>Brief description. If this is not present, the detailed description gets interpreted as brief in 1.8.18. FFS.</p>
         <div class="m-block m-default">
           <h3>Contents</h3>
           <ul>
diff --git a/documentation/test_doxygen/compound_includes_undocumented_files/First.h b/documentation/test_doxygen/compound_includes_undocumented_files/First.h
index 338e898a..633a20d0 100644
--- a/documentation/test_doxygen/compound_includes_undocumented_files/First.h
+++ b/documentation/test_doxygen/compound_includes_undocumented_files/First.h
@@ -98,6 +98,7 @@ class Class {
 };
 
 /** @defgroup group A group
+@brief Brief description. If this is not present, the detailed description gets interpreted as brief in 1.8.18. FFS.
 
 All entries inside should have include information. (Unless the includes are disabled globally or the file is not documented.)
 @{ */
diff --git a/documentation/test_doxygen/compound_modules/group__group.html b/documentation/test_doxygen/compound_modules/group__group.html
index f252ca99..5214440b 100644
--- a/documentation/test_doxygen/compound_modules/group__group.html
+++ b/documentation/test_doxygen/compound_modules/group__group.html
@@ -32,6 +32,7 @@
       <div class="m-col-l-10 m-push-l-1">
         <h1>
           A group <span class="m-thin">module</span></h1>
+        <p>Brief description. If this is not present, the detailed description gets interpreted as brief in 1.8.18. FFS.</p>
         <div class="m-block m-default">
           <h3>Contents</h3>
           <ul>
diff --git a/documentation/test_doxygen/compound_modules/input.h b/documentation/test_doxygen/compound_modules/input.h
index 35ed583c..3bdb03d1 100644
--- a/documentation/test_doxygen/compound_modules/input.h
+++ b/documentation/test_doxygen/compound_modules/input.h
@@ -1,4 +1,5 @@
 /** @defgroup group A group
+@brief Brief description. If this is not present, the detailed description gets interpreted as brief in 1.8.18. FFS.
 
 Detailed description.
 @{ */
diff --git a/documentation/test_doxygen/compound_modules/modules.html b/documentation/test_doxygen/compound_modules/modules.html
index 955b6f82..8b51b1e1 100644
--- a/documentation/test_doxygen/compound_modules/modules.html
+++ b/documentation/test_doxygen/compound_modules/modules.html
@@ -33,7 +33,7 @@
         <h1>Modules</h2>
         <ul class="m-doc">
           <li class="m-doc-collapsible">
-            <a href="#" onclick="return toggle(this)">module</a> <a href="group__group.html" class="m-doc">A group</a> <span class="m-doc"></span>
+            <a href="#" onclick="return toggle(this)">module</a> <a href="group__group.html" class="m-doc">A group</a> <span class="m-doc">Brief description. If this is not present, the detailed description gets interpreted as brief in 1.8.18. FFS.</span>
             <ul class="m-doc">
               <li>module <a href="group__subgroup.html" class="m-doc">A subgroup</a> <span class="m-doc">Subgroup brief description.</span></li>
             </ul>
diff --git a/documentation/test_doxygen/search/Dir/File.h b/documentation/test_doxygen/search/Dir/File.h
index f080ea67..39c2f8da 100644
--- a/documentation/test_doxygen/search/Dir/File.h
+++ b/documentation/test_doxygen/search/Dir/File.h
@@ -76,6 +76,7 @@ enum class Enum {
 };
 
 /** @defgroup group A group
+ * @brief Brief description. If this is not present, the detailed description gets interpreted as brief in 1.8.18. FFS.
  *
  * @m_keywords{GL_GROUP}
  * @{