render orphan @Par headings

Render @Par headings when the @Par has no children paragraphs

#feat

fix #787

Author: alandefreitas

src/lib/AST/ParseJavadoc.cpp

@@ -1233,24 +1233,26 @@ visitBlockCommandComment(
         doc::Paragraph paragraph;
         auto scope = enterScope(paragraph);
         visitChildren(C->getParagraph());
-        if(! paragraph.children.empty())
+        if (C->getNumArgs() > 0)
         {
-            if (C->getNumArgs() > 0)
-            {
-                jd_.emplace_back(doc::Heading(C->getArgText(0).str()));
-            }
-            else
+            jd_.emplace_back(doc::Heading(C->getArgText(0).str()));
+        }
+        if (!paragraph.children.empty())
+        {
+            // the first TextComment is the heading text
+            if (C->getNumArgs() == 0)
             {
-                // 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())
+                if (auto const s = trim(text);
+                    s.size() != text.size())
+                {
                     text = s;
+                }
 
                 doc::Heading heading(std::move(text));
                 jd_.emplace_back(std::move(heading));
@@ -1259,8 +1261,10 @@ visitBlockCommandComment(
                 paragraph.children.erase(paragraph.children.begin());
             }
 
-            if(! paragraph.children.empty())
+            if (!paragraph.children.empty())
+            {
                 jd_.emplace_back(std::move(paragraph));
+            }
         }
         return;
     }

test-files/golden-tests/javadoc/par-1.adoc

@@ -0,0 +1,166 @@
+= Reference
+:mrdocs:
+
+[#index]
+== Global namespace
+
+
+=== Functions
+
+[cols=2]
+|===
+| Name | Description 
+
+| <<f1,`f1`>> 
+| Brief
+
+
+
+| <<f2,`f2`>> 
+| Brief
+
+
+
+| <<f3,`f3`>> 
+| Brief
+
+
+
+| <<f4,`f4`>> 
+| Brief
+
+
+
+|===
+
+[#f1]
+== f1
+
+
+Brief
+
+
+
+=== Synopsis
+
+
+Declared in `&lt;par&hyphen;1&period;cpp&gt;`
+
+[source,cpp,subs="verbatim,replacements,macros,-callouts"]
+----
+void
+f1();
+----
+
+=== Description
+
+
+
+=== Custom par
+
+Paragraph 1
+
+[,cpp]
+----
+void f1();
+----
+
+
+[#f2]
+== f2
+
+
+Brief
+
+
+
+=== Synopsis
+
+
+Declared in `&lt;par&hyphen;1&period;cpp&gt;`
+
+[source,cpp,subs="verbatim,replacements,macros,-callouts"]
+----
+void
+f2();
+----
+
+=== Description
+
+
+
+=== Custom par
+
+Paragraph 2
+
+[,cpp]
+----
+void f2();
+----
+
+
+[#f3]
+== f3
+
+
+Brief
+
+
+
+=== Synopsis
+
+
+Declared in `&lt;par&hyphen;1&period;cpp&gt;`
+
+[source,cpp,subs="verbatim,replacements,macros,-callouts"]
+----
+void
+f3();
+----
+
+=== Description
+
+
+
+=== Custom par
+
+[,cpp]
+----
+void f3();
+----
+
+
+[#f4]
+== f4
+
+
+Brief
+
+
+
+=== Synopsis
+
+
+Declared in `&lt;par&hyphen;1&period;cpp&gt;`
+
+[source,cpp,subs="verbatim,replacements,macros,-callouts"]
+----
+void
+f4();
+----
+
+=== Description
+
+
+
+=== Custom par
+
+[,cpp]
+----
+void f4();
+----
+
+
+
+
+[.small]#Created with https://www.mrdocs.com[MrDocs]#

test-files/golden-tests/javadoc/par-1.cpp

@@ -0,0 +1,43 @@
+/** Brief
+
+    @par Custom par
+    Paragraph 1
+
+    @code
+    void f1();
+    @endcode
+
+ */
+void f1();
+
+/** Brief
+
+    @par Custom par
+
+    Paragraph 2
+
+    @code
+    void f2();
+    @endcode
+
+ */
+void f2();
+
+/** Brief
+
+    @par Custom par
+    @code
+    void f3();
+    @endcode
+ */
+void f3();
+
+/** Brief
+
+    @par Custom par
+
+    @code
+    void f4();
+    @endcode
+ */
+void f4();

test-files/golden-tests/snippets/is_prime.adoc

@@ -40,6 +40,9 @@ is_prime(unsigned long long n) noexcept;
 === Description
 
 
+
+=== Complexity
+
 Linear in n.
 
 

test-files/golden-tests/snippets/is_prime.html

@@ -46,6 +46,7 @@ <h3>Synopsis</h3>
 </div>
 <div>
 <h3>Description</h3>
+<h3>Complexity</h3>
 <p><span>Linear in n.</span></p>
 
 

test-files/golden-tests/snippets/is_prime.xml

@@ -14,6 +14,7 @@
       <para>
         <text>Return true if a number is prime.</text>
       </para>
+      <head>Complexity</head>
       <para>
         <text>Linear in n.</text>
       </para>