Re: [Boost-bugs] [Boost C++ Libraries] #3309: Passthrough mode in doxygen2boostbook is not pass-through and ignores doxygen references

Subject: Re: [Boost-bugs] [Boost C++ Libraries] #3309: Passthrough mode in doxygen2boostbook is not pass-through and ignores doxygen references
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2009-08-01 19:25:52

#3309: Passthrough mode in doxygen2boostbook is not pass-through and ignores
doxygen references
--------------------------------------------------+-------------------------
 Reporter:  Mathias Gaunard <loufoque@…>          |       Owner:  danieljames  
     Type:  Bugs                                  |      Status:  assigned     
Milestone:  Boost 1.40.0                          |   Component:  Documentation
  Version:  Boost 1.39.0                          |    Severity:  Problem      
 Keywords:                                        |  
--------------------------------------------------+-------------------------

Comment(by Mathias Gaunard <loufoque@…>):

 1)
 {{{
 /** The argument must model the \c
 \xmlonly<conceptname>Foo</conceptname>\endxmlonly concept. */
 template<typename T>
 void use_foo(T& t);
 }}}

 Without this patch, <conceptname> will simply be ignored.

 2) I had to special case initializer elements so that they don't match *,
 but unfortunately my code is wrong, they certainly should not be ignored.
 This is the correct code:
 {{{
   <xsl:template match="initializer" mode="passthrough">
     <xsl:apply-templates mode="passthrough"/>
   </xsl:template>
 }}}

 3) doxygen provides some useful <ref> in the following scenario:
 {{{
 /** This function uses an instance of \c thingy */
 void bar();
 }}}

 with "thingy" a type doxygen knows about, this will generate the following
 xml :
 {{{
 <detaileddescription><para>
 This function uses an instance of <computeroutput><ref refid="..."
 kindref="compound">thingy</ref></computeroutput>
 </para></detaileddescription>
 }}}

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