From 03120084bb5ac1b59b8eb1ee7f279df53cedb4bf Mon Sep 17 00:00:00 2001
From: Andrey Semashev <andrey.semashev@gmail.com>
Date: Sat, 29 Jun 2024 20:57:29 +0300
Subject: [PATCH] Pass through contents of parblock in Doxygen.

\parblock can be used to group multiple paragraps under a block command
that expects a single paragraph as argument (e.g. \returns). So just
forward the contents of the parblock in the current context.
---
 xsl/doxygen/doxygen2boostbook.xsl | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/xsl/doxygen/doxygen2boostbook.xsl b/xsl/doxygen/doxygen2boostbook.xsl
index 01996e5..eaedd3f 100644
--- a/xsl/doxygen/doxygen2boostbook.xsl
+++ b/xsl/doxygen/doxygen2boostbook.xsl
@@ -1582,9 +1582,21 @@
     <xsl:value-of select="."/>
   </xsl:template>
   <xsl:template match="para" mode="passthrough">
-    <para>
-      <xsl:apply-templates mode="passthrough"/>
-    </para>
+    <xsl:choose>
+      <xsl:when test="parblock">
+        <!-- parblock is expected to contain a number of paragraphs,
+             so just forward them directly in the current context. -->
+        <xsl:apply-templates mode="passthrough"/>
+      </xsl:when>
+      <xsl:otherwise>
+        <para>
+          <xsl:apply-templates mode="passthrough"/>
+        </para>
+      </xsl:otherwise>
+    </xsl:choose>
+  </xsl:template>
+  <xsl:template match="parblock" mode="passthrough">
+    <xsl:apply-templates mode="passthrough"/>
   </xsl:template>
   <xsl:template match="copydoc" mode="passthrough">
     <xsl:apply-templates mode="passthrough"/>