• Peter Eisentraut's avatar
    Rearrangement of the HTML docs build rules · 4ef8dc7a
    Peter Eisentraut authored
    Set up proper makefile dependencies in the documentation build rules,
    especially around the HTML/index build.  The problem we've had with all
    previous solutions is that we have used the same file name, such as HTML.index
    or bookindex.sgml, to mean different things at different stages of the build,
    and make can't distinguish that.  The solution here is that the first jade run
    produces HTML.index, but does not require bookindex.sgml at all, and produces
    no other html output (the latter an idea from Alvaro).  The second jade run
    includes bookindex.sgml, but does not recreate HTML.index.  That way, when you
    change an sgml file, jade is run twice and at the end all dependencies are
    satisfied.  Omitting the html output in the first stage also makes the full
    build a lot faster.
    
    When you run one of the print format targets, only the first jade run is run,
    then the print target-specific commands.  If an HTML build has completed
    previously, the first jade run is skipped because the dependencies have
    already been satisfied.
    
    The draft and check targets for quick builds and syntax verification are still
    there.
    4ef8dc7a
filelist.sgml 6.84 KB