Boost logo

Boost-Build :

Subject: Re: [Boost-build] Doxygen rule change ?
From: Edward Diener (eldiener_at_[hidden])
Date: 2016-04-26 11:23:21


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.

>
> 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.
>
> 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 acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk