[Boost-docs] Breakage in Doxygen rule

Subject: [Boost-docs] Breakage in Doxygen rule
From: John Maddock (john_at_[hidden])
Date: 2008-12-02 13:59:16

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."

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 :-(

Since the command has no effect, I'm tempted to just go ahead and delete it, 
but I assume it was put there for a reason, and is supposed to be deleting 
*something*, I just don't know what :-(

The del command was introduced by Rene here BTW: 
https://svn.boost.org/trac/boost/changeset/37457/trunk/boost/tools/build/v2/tools/doxygen.jam

Anyone any ideas?  Rene?

Thanks, John.