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 -- Mailing list: https://launchpad.net/~zorba-coders Post to : firstname.lastname@example.org Unsubscribe : https://launchpad.net/~zorba-coders More help : https://help.launchpad.net/ListHelp