Re: How to get syntax coloring in Quickboook Doxygen C++ Reference sections
"Paul A. Bristow" <[email protected]> Mon, 28 Oct 2013 18:43:15 -0000
| Newsgroups | gmane.comp.lib.boost.documentation |
|---|---|
| Message-ID | <[email protected]> |
> -----Original Message----- > From: Boost-docs [mailto:[email protected]] On Behalf Of Daniel James > Sent: Sunday, October 27, 2013 6:12 PM > To: Discussion of Boost Documentation > Subject: Re: [Boost-docs] How to get syntax coloring in Quickboook Doxygen C++ Reference sections > > On 27 October 2013 17:54, Paul A. Bristow <[email protected]> wrote: > > I'm haven't another déjà vu about this issue ;-) > > > > But is there something I am doing wrong that I am not seeing syntax > > coloring from this Doxygen comment, even after specifying that it is cpp. > > > > (Syntax coloring works fine from Quickbook snippets). > > > > @b Example: > > > > \code{.cpp} > > #include <boost/numeric/safe_cast.hpp> #include > > <boost/numeric/safe_integer.hpp> > > > > void f(){ > > safe_integer<char> i; > > unsigned char j; > > i = 1; > > j = safe_cast<unsigned char>(i); // ok > > i = -1; > > j = safe_cast<unsigned char>(i); // throws std::out_of_range exception > > i = 1024; > > j = safe_cast<unsigned char>(i); // throws std::out_of_range > > exception } \endcode > > > > This gives syntax colored if you use the doxywizard, but the html > > generated from Quickbook toolchain is just in 'code font' with the > > html source > > Where are you putting this code sample? I tried adding it to a class description and it was syntax > highlighted there. Syntax highlighting for doxygen documentation is handled in the boostbook to > docbook stage, and I guess it only does it in certain places. It might be possible to add it where you need > it. I put it with a function. I've checked that it works OK as a class example as Daniel reported. I've glanced at doxygen2boostbook.xsl but how to make it work for functions as well as classes didn't jump out at me ;-) (I can see uses for all types - even MACROs?) Hints? Thanks to all. Paul