Support INTERNAL ONLY enums in doxygen/boostbook documenation. Refs #3242.

Patch by Mathias Gaunard.

[SVN r54818]

test/doxygen/boost/example.hpp

@@ -22,6 +22,9 @@ namespace example
         static const int static_const_integer;
 
         enum class_enum { enumerator };
+        
+        /// INTERNAL ONLY
+        enum internal_enum { internal_enumerator };
     protected:
         int protected_integer;
         static int protected_static_integer;

xsl/doxygen/doxygen2boostbook.xsl

@@ -292,6 +292,15 @@
   </xsl:template>
 
   <xsl:template match="enumvalue">
+    <xsl:choose>
+      <!-- If the string INTERNAL ONLY is in the description, don't
+           emit this entity. This hack is necessary because Doxygen doesn't
+           tell us what is \internal and what isn't. -->
+      <xsl:when test="contains(detaileddescription/para, 'INTERNAL ONLY')"/>
+      <xsl:when test="contains(briefdescription/para, 'INTERNAL ONLY')"/>
+      <xsl:when test="contains(inbodydescription/para, 'INTERNAL ONLY')"/>
+      <xsl:otherwise>
+  
         <enumvalue>
           <xsl:attribute name="name">
             <xsl:value-of select="name"/>
@@ -307,6 +316,8 @@
           <xsl:apply-templates select="detaileddescription" mode="passthrough"/>
           <xsl:apply-templates select="inbodydescription" mode="passthrough"/>
         </enumvalue>
+      </xsl:otherwise>
+    </xsl:choose>
   </xsl:template>
 
   <xsl:template name="doxygen.include.header.rec">