fix: use arguments to \par if available

Author: Nerixyz

src/lib/AST/ParseJavadoc.cpp

@@ -1026,22 +1026,30 @@ visitBlockCommandComment(
         visitChildren(C->getParagraph());
         if(! paragraph.children.empty())
         {
-            // the first TextComment is the heading text
-            doc::String text(std::move(
-                    paragraph.children.front()->string));
-
-            // VFALCO Unfortunately clang puts at least
-            // one space in front of the text, which seems
-            // incorrect.
-            auto const s = trim(text);
-            if(s.size() != text.size())
-                text = s;
-
-            doc::Heading heading(std::move(text));
-            jd_.emplace_back(std::move(heading));
-
-            // remaining TextComment, if any
-            paragraph.children.erase(paragraph.children.begin());
+            if (C->getNumArgs() > 0)
+            {
+                jd_.emplace_back(doc::Heading(C->getArgText(0).str()));
+            }
+            else
+            {
+                // the first TextComment is the heading text
+                doc::String text(std::move(
+                        paragraph.children.front()->string));
+
+                // VFALCO Unfortunately clang puts at least
+                // one space in front of the text, which seems
+                // incorrect.
+                auto const s = trim(text);
+                if(s.size() != text.size())
+                    text = s;
+
+                doc::Heading heading(std::move(text));
+                jd_.emplace_back(std::move(heading));
+
+                // remaining TextComment, if any
+                paragraph.children.erase(paragraph.children.begin());
+            }
+
             if(! paragraph.children.empty())
                 jd_.emplace_back(std::move(paragraph));
         }