Boost logo

Boost-Build :

Subject: Re: [Boost-build] Doxygen rule change ?
From: Steven Watanabe (watanabesj_at_[hidden])
Date: 2016-04-26 11:44:59


AMDG

On 04/26/2016 09:23 AM, Edward Diener wrote:
> On 4/26/2016 8:09 AM, PJB wrote:
>> Wouldn't this be something better implemented by a post-build script,
>> rather than boost-build?
>
> No, because the doxygen rule is part of a larger Boost Build process
> which builds boostbook output as HTML and/or PDF files.
>

  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.

>>
>> On 26 April 2016 at 12:54, Edward Diener <eldiener_at_[hidden]
>> <mailto:eldiener_at_[hidden]>> wrote:
>>
>> It turns out that there is no guarantee when using doxygen that the
>> order of the files generated in the XML doc is the same as the order
>> of the sources which an end-user specifies for doxygen to scan.
>> Although it often works out that the two orders are the same, it is
>> possible they are not. The VMD documentation shows an instance where
>> they are not the same, nor have I found out from doxygen anything
>> about why the orders might be different.
>>
>> <snip>
>>
>> Can something be done in Boost Build to change the xml file
>> generated by doxygen so that the file entries are either in the
>> order specified as input sources or in some sort of alphabetic order
>> ? <snip>
>

In Christ,
Steven Watanabe


Boost-Build list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk