Re: [Boost-build] Doxygen rule change ?

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