zorba-coders team mailing list archive

[Chris Hillery <867125@xxxxxxxxxxxxxxxxxx>]

In that case, the "doc" target should have dependencies on the
xqdoc2xhtml module.

No matter what, a build target always does one thing: take a set of
inputs (which could be data, code, whatever) and produce some outputs.
In all cases, the target should depend on all inputs, so that it only
runs when the outputs are out of date in relation to any input.

*Ideally* it would be able to do some form of incremental build, but I
can see that that would be challenging for xqdoc, and in some cases
impossible like you said. However, that's not actually what the bug was
asking for. At the time, it was being proposed that "make doc" should be
added to the ALL target, so that it will be built *by default*. For that
to be reasonable, IMHO it needs to have completely correct dependency
checking, as well as being very fast (ideally under 10 seconds on
reasonable hardware).

However, at the moment, I'm not sure that anyone is asking for xqdoc to
be built by default anymore. So, this bug is not as high a priority as
it was. I think it would be nice if you typed "make doc" twice, that the
second time it would do nothing. But that's not super-urgent.

I'm adding Matthias to the CC for his take, and for the moment I'm
lowering the priority and removing from Milestone 2.1.

** Changed in: zorba
   Importance: High => Low

** Changed in: zorba
    Milestone: 2.1 => None

-- 
You received this bug notification because you are a member of Zorba
Coders, which is the registrant for Zorba.
https://bugs.launchpad.net/bugs/867125

Title:
  xqdoc does no dependency checking on inputs

Status in Zorba - The XQuery Processor:
  New

Bug description:
  Every time you type "make doc" it re-does the whole process, even if
  none of the inputs has changed. Until this is corrected, it is not
  reasonable to make the documentation part of the normal build process.

To manage notifications about this bug go to:
https://bugs.launchpad.net/zorba/+bug/867125/+subscriptions