[Boost-bugs] [Boost C++ Libraries] #2937: Workaround buggy XML from doxygen

Subject: [Boost-bugs] [Boost C++ Libraries] #2937: Workaround buggy XML from doxygen
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2009-04-11 12:34:37

#2937: Workaround buggy XML from doxygen
-------------------------------------+--------------------------------------
 Reporter:  danieljames              |       Owner:  danieljames  
     Type:  Bugs                     |      Status:  new          
Milestone:  Boost 1.39.0             |   Component:  Documentation
  Version:  Boost Development Trunk  |    Severity:  Problem      
 Keywords:                           |  
-------------------------------------+--------------------------------------
 For this code:

 {{{
     template <typename TypeParameter, int NonTypeParameter,
         typename TypeParameterWithDefault = int>
     struct example_template {};
 }}}

 Doxygen 1.5.6 would generates the parameter list:

 {{{
     <templateparamlist>
       <param>
         <type>typename</type>
         <declname>TypeParameter</declname>
         <defname>TypeParameter</defname>
       </param>
       <param>
         <type>int</type>
         <declname>NonTypeParameter</declname>
         <defname>NonTypeParameter</defname>
       </param>
       <param>
         <type>typename</type>
         <declname>TypeParameterWithDefault</declname>
         <defname>TypeParameterWithDefault</defname>
         <defval>int</defval>
       </param>
     </templateparamlist>
 }}}

 But Doxygen 1.5.8 generates:
 {{{
     <templateparamlist>
       <param>
         <type>typename TypeParameter</type>
       </param>
       <param>
         <type>int</type>
         <declname>NonTypeParameter</declname>
         <defname>NonTypeParameter</defname>
       </param>
       <param>
         <type>typename TypeParameterWithDefault</type>
         <defval>int</defval>
       </param>
     </templateparamlist>
 }}}

 Note that the names of type parameters are inside the type. This is
 confusing doxygen2boostbook and I need to work around it.

-- 
Ticket URL: <https://svn.boost.org/trac/boost/ticket/2937>
Boost C++ Libraries <http://www.boost.org/>
Boost provides free peer-reviewed portable C++ source libraries.