Subject: Re: [boost] [geometry] Documentation building
From: Alexey Kutumov (alexey.kutumov_at_[hidden])
Date: 2013-02-18 08:59:42
> I'm working on CMake'fication of boost libraries, and i 've got issue when
> > building documentation of Boost.Geometry. This library uses
> > utility for convertiong doxygen XML to quickbook, and this utility uses
> > RapidXML for xml processing. I found rapidxml in Boost.PropertyTree
> > library, but it is in detail subdirectory and also have different
> > namespaces (`boost::property_tree::detail::rapidxml` vs `rapidxml`)
> > Can i use rapidxml from PropertyTree library, or i must write CMake
> > for searching rapidxml as thirdparty library?
> Unfortunately they're not interchangeable. PropertyTree has rapidxml in
> boost::property_tree::detail namespace and in the "official" release it
> is in global namespace. The doxygen_xml2qbk currently assumes that the
> "official" one is used.
> Aside from this. During my work on the spatial index library I've
> developed an version of this tool which supports additional doxygen
> features like paragraphs, warnings, text formatting and automatic
> references. You might check it out. It can be found here:
> If --output_style alt is passed as a parameter like in
> the alternative qbk is generated for a class or a group.
> The example of a reference which structure is defined here:
> looks like this:
Thanks for responce, i'll try these changes.
I'm not sure whether my sources is up to date, but i made some changes, you
can find them here:
* Added optional parameter with output file (it is needed for CMake script).
* Also i fixed issue with brackets in description (added proper escaping).
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk