[Boost-build] Doxygen rule change ?

Subject: [Boost-build] Doxygen rule change ?
From: Edward Diener (eldiener_at_[hidden])
Date: 2016-04-26 07:54:17

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.

This means that when using the doxygen rule in Boost build and I specify 
the sources in the order I would like to see the files appear in the 
reference section of the documentation, there is no guarantee that they 
will appear in that order in the reference. For doxygen itself, when 
generating HTML output, the generated order does not matter since 
doxygen shows the files generated in a directory tree where the files in 
any given directory in that tree are in alphabetical order.

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 ? I find it 
disappointing that the order of files for my VMD documentation's 
reference section is so confusing for the end-user, even when I 
specified the sources in the order in which I wanted the files in the 
reference section to appear.