Re: [Boost-build] Breakage in Doxygen rule

Subject: Re: [Boost-build] Breakage in Doxygen rule
From: Vladimir Prus (ghost_at_[hidden])
Date: 2008-12-02 13:14:22

On Tuesday 02 December 2008 16:59:16 John Maddock wrote:
> In doxygen.jam the rule:
> 
> actions doxygen-action
> {
>    $(RM) "$(*.XML)" & "$(NAME:E=doxygen)" "$(>)" && echo "Stamped" > "$(<)"
> }
> 
> The $(RM) "$(*.XML)" part expands to (for example from the accumulators 
> docs):
> 
>    del /f /q 
> "..\..\..\bin.v2\libs\accumulators\doc\msvc-8.0\debug\threading-multi\statsdoc\*.xml"
> 
> But there is no such directory, and there never will be (as it's created by 
> any of the rules), so the del command fails with:
> 
>    "The system cannot find the file specified."

I presume this code is supposed to remove stale XML files -- does the error happens
if you touch any of the headers and run bjam again? I would expect that in that
case, stale XML files be removed.

> Now, this doesn't actually terminate the build (which surprises me 
> actually), but the error message is identical to some genuine errors emitted 
> by Doxygen if it can't find the external tools it needs (like latex etc), 
> which makes it darn hard to figure out whether the build was OK or not :-(

We can redirect that 'del' into 'nul', I think.

- Volodya