[Bug 222826] handling of dependencies in doc build

[bugzilla-noreply at freebsd.org]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=222826

            Bug ID: 222826
           Summary: handling of dependencies in doc build
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Documentation
          Assignee: freebsd-doc at FreeBSD.org
          Reporter: wosch at FreeBSD.org

We need a better way of handling dependencies in the doc build. It should be
run automatically.


the proposed solution:

By default, the makefiles will check for dependencies of *.xml include files.
If you do not like that or the build fails then you can disable this with  

DOCBOOK_DEPS_DISABLE=YES

in the ./Makefile

If you want add dependencies explicitly, you can do this with

DOCBOOK_DEPS= ./some-file

and any change of "some-file" will force a rebuild of the document.

There are definitions of include files which does not exists (e.g. uses.xml,
versions.xml) In that case we print a warning and ignore it. This affects
mostly translated documents.

-- 
You are receiving this mail because:
You are the assignee for the bug.