Re: [Boost-build] Doxygen rule change ?

Subject: Re: [Boost-build] Doxygen rule change ?
From: Daniel James (dnljms_at_[hidden])
Date: 2016-04-26 19:22:03

On 26 April 2016 at 16:44, Steven Watanabe <watanabesj_at_[hidden]> wrote:
>   If we need any post-processing, the right place to
> handle it is boostbook/xsl/doxygen/doxygen2boostbook.xsl.
> Of course, it would be much better if there were
> some way to convince doxygen to preserve the input
> order.  I'm assuming that this is in fact a problem
> in doxygen, not Boost.Build, since Boost.Build always
> sorts things alphabetically when it adjusts the order.

FWIW before doxygen2boostbook.xml is run, there's another xsl script
called collect.xsl which pulls together all the xml files that doxygen
generates into a single file. This reads in the list of files from a
file called index.xml. Its path is a bit unpredictable, but it can be
found using something like:

    find bin.v2/libs/vmd -name index.xml

That file is the file which determines the order of the headers. I
don't know if it's possible to modify collect.xsl to sort the order,
but if it is then it might be better than doxygen2boostbook.xsl as
it's a simpler xsl script.