Boost logo

Boost-Build :

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.

Boost-Build list run by bdawes at, david.abrahams at, gregod at, cpdaniel at, john at