From b42efe92e42e65696f31763be41349fd81807b05 Mon Sep 17 00:00:00 2001
From: Steven Watanabe <steven@providere-consulting.com>
Date: Tue, 31 Mar 2015 16:13:31 -0600
Subject: [PATCH 1/3] Handle <ndash/> generated by doxygen.

---
 xsl/doxygen/doxygen2boostbook.xsl | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/xsl/doxygen/doxygen2boostbook.xsl b/xsl/doxygen/doxygen2boostbook.xsl
index d3a21cf..b8065ac 100644
--- a/xsl/doxygen/doxygen2boostbook.xsl
+++ b/xsl/doxygen/doxygen2boostbook.xsl
@@ -1521,6 +1521,10 @@
     <sbr/>
   </xsl:template>
 
+  <xsl:template match="ndash" mode="passthrough">
+    <xsl:text>&#8211;</xsl:text>
+  </xsl:template>
+  
   <xsl:template match="briefdescription" mode="passthrough">
     <xsl:if test="text()|*">
       <purpose>

From 30911053b5fd4fb0546e27e7dd3ac062069b7ec3 Mon Sep 17 00:00:00 2001
From: Daniel James <daniel@calamity.org.uk>
Date: Sun, 10 Jan 2016 14:46:14 +0000
Subject: [PATCH 2/3] Convert the complicated doxygen preformatted tags.

Reported here:

http://lists.boost.org/boost-docs/2016/01/5335.php

Can currently see the error here:

http://www.boost.org/doc/libs/1_60_0/doc/html/boost/container/small_vector_base.html
---
 xsl/doxygen/doxygen2boostbook.xsl | 38 +++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/xsl/doxygen/doxygen2boostbook.xsl b/xsl/doxygen/doxygen2boostbook.xsl
index b8065ac..577484b 100644
--- a/xsl/doxygen/doxygen2boostbook.xsl
+++ b/xsl/doxygen/doxygen2boostbook.xsl
@@ -1710,6 +1710,44 @@
     </xsl:choose>
   </xsl:template>
 
+  <!-- Handle preformatted.
+       Doxygen generates markup such as:
+         <para><preformatted>void foo() {</preformatted></para>
+         <para><preformatted>}</preformatted></para>
+       This complicated mess tries to combine that into a single
+       programlisting element.
+    -->
+  <xsl:template match="para[preformatted][count(preformatted)=count(*)]" mode="passthrough">
+    <!-- Only do this for the first of a group of paras. -->
+    <xsl:if test="not(preceding-sibling::para[1][preformatted][count(preformatted)=count(*)])">
+      <programlisting>
+        <!-- This node's children. -->
+        <xsl:apply-templates mode="passthrough" select="./preformatted/node()"/>
+
+        <!-- Adjacent para nodes' children.
+             Based on code at: http://stackoverflow.com/a/2092144 -->
+        <xsl:variable name="program_paragraphs" select="following-sibling::para[preformatted][count(preformatted)=count(*)]" />
+        <xsl:for-each select="following-sibling::para[preformatted][count(preformatted)=count(*)]">
+          <xsl:variable name="index" select="position()"/>
+          <xsl:if test="generate-id(.)=generate-id($program_paragraphs[$index])">
+            <xsl:text>&#xa;</xsl:text>
+            <xsl:apply-templates mode="passthrough" select="./preformatted/node()"/>
+          </xsl:if>
+        </xsl:for-each>
+      </programlisting>
+    </xsl:if>
+  </xsl:template>
+
+  <!-- Remove empty preformatted elements. -->
+  <xsl:template match="preformatted[not(node())]" mode="passthrough"/>
+
+  <!-- Convert remaining to programlisting. -->
+  <xsl:template match="preformatted" mode="passthrough">
+    <programlisting>
+      <xsl:apply-templates mode="passthrough"/>
+    </programlisting>
+  </xsl:template>
+
   <!-- Handle program listings -->
   <xsl:template match="programlisting" mode="passthrough">
     <programlisting language="c++">

From f1aef5c98ea7ffa1d215980f091c16290b1128b2 Mon Sep 17 00:00:00 2001
From: Daniel James <daniel@calamity.org.uk>
Date: Wed, 13 Jan 2016 19:33:09 +0000
Subject: [PATCH 3/3] Fix the <pre> block workaround in doxygen2boostbook.xsl

It turns out the '\code' blocks don't have this problem, so an easier
fix would be just to use them. But now I've implemented the workaround,
might as well leave it in, in case anyone wants to use <pre> blocks in
the future.
---
 test/doxygen/autodoc.gold         | 18 ++++++++++++++++--
 test/doxygen/boost/example.hpp    | 28 ++++++++++++++++++++++++++++
 xsl/doxygen/doxygen2boostbook.xsl |  6 +++---
 3 files changed, 47 insertions(+), 5 deletions(-)

diff --git a/test/doxygen/autodoc.gold b/test/doxygen/autodoc.gold
index 95c8181..58434b1 100644
--- a/test/doxygen/autodoc.gold
+++ b/test/doxygen/autodoc.gold
@@ -63,8 +63,22 @@ Embedded docbook list:</para><para>
 <listitem><para>Second list item</para></listitem>
 </itemizedlist>
 Line 1<sbr/>
- Line 2</para><para><programlisting language="c++">void foo() {}
-</programlisting></para><para>
+Line 2</para><para><programlisting language="c++">void foo() {}
+void foo2() {}
+</programlisting></para><para><programlisting language="c++">void bar() {}
+
+void bar2() {}
+</programlisting></para><para>Alternative way of writing code, has a complicated workaround because doxygen treats the empty line as a paragraph separator:</para><programlisting>
+int bar();
+
+int bar2();
+</programlisting><para>Unfortunately the workaround will merge consecutive blocks, like this:</para><programlisting>
+int foo();
+
+
+
+int foo2();
+</programlisting><para>
 </para></description></struct><struct name="specialization_test"><template>
       <template-type-parameter name="T"/>
     </template></struct><struct-specialization name="specialization_test"><template>
diff --git a/test/doxygen/boost/example.hpp b/test/doxygen/boost/example.hpp
index 629a6d9..9b32da0 100644
--- a/test/doxygen/boost/example.hpp
+++ b/test/doxygen/boost/example.hpp
@@ -153,8 +153,36 @@ namespace example
      *
      * \code
      *     void foo() {}
+     *     void foo2() {}
      * \endcode
      *
+     * \code
+     *     void bar() {}
+     *
+     *     void bar2() {}
+     * \endcode
+     *
+     * Alternative way of writing code, has a complicated workaround
+     * because doxygen treats the empty line as a paragraph
+     * separator:
+     *
+     * <pre>
+     * int bar();
+     *
+     * int bar2();
+     * </pre>
+     *
+     * Unfortunately the workaround will merge consecutive blocks,
+     * like this:
+     *
+     * <pre>
+     * int foo();
+     * </pre>
+     *
+     * <pre>
+     * int foo2();
+     * </pre>
+     *
      * \tparam TypeParameter A template parameter
      * \tparam NonTypeParameter This is a non-type template parameter
      * \tparam TypeParameterWithDefault This is a template parameter with a default argument
diff --git a/xsl/doxygen/doxygen2boostbook.xsl b/xsl/doxygen/doxygen2boostbook.xsl
index 577484b..5d68930 100644
--- a/xsl/doxygen/doxygen2boostbook.xsl
+++ b/xsl/doxygen/doxygen2boostbook.xsl
@@ -1726,11 +1726,11 @@
 
         <!-- Adjacent para nodes' children.
              Based on code at: http://stackoverflow.com/a/2092144 -->
-        <xsl:variable name="program_paragraphs" select="following-sibling::para[preformatted][count(preformatted)=count(*)]" />
+        <xsl:variable name="following-siblings" select="following-sibling::*" />
         <xsl:for-each select="following-sibling::para[preformatted][count(preformatted)=count(*)]">
           <xsl:variable name="index" select="position()"/>
-          <xsl:if test="generate-id(.)=generate-id($program_paragraphs[$index])">
-            <xsl:text>&#xa;</xsl:text>
+          <xsl:if test="generate-id(.)=generate-id($following-siblings[$index])">
+            <xsl:text>&#xa;&#xa;</xsl:text>
             <xsl:apply-templates mode="passthrough" select="./preformatted/node()"/>
           </xsl:if>
         </xsl:for-each>