<doc.docbook-dep.mk> handles implicit dependencies of DocBook documentation

This feature can be disabled with DOCBOOK_DEPS_DISABLE=YES

Missing dependencies will be reported as a warning, and should
be fixed by the document authors.

PR: 222826

de_DE.ISO8859-1/books/fdp-primer/Makefile

@@ -52,4 +52,7 @@ SRCS+= chapters.ent
 URL_RELPREFIX?=	../../../..
 DOC_PREFIX?=	${.CURDIR}/../../..
 
+# Fixme!
+DOCBOOK_DEPS_DISABLE=YES
+
 .include "${DOC_PREFIX}/share/mk/doc.project.mk"

en_US.ISO8859-1/articles/freebsd-releng/Makefile

@@ -12,14 +12,10 @@ INSTALL_ONLY_COMPRESSED?=
 
 SRCS=		article.xml
 
-DEPS!= egrep '<!ENTITY release\.[^ ]+ SYSTEM "./releng-[^ ]+\.xml">' \
-	${SRCS} | sed -E 's,.*"./([^"]+)".*,\1,'
-
 CSS_SHEET_ADDITIONS=extra.css
 
 URL_RELPREFIX?=	../../../..
 DOC_PREFIX?=	${.CURDIR}/../../..
 
-index.html ${DOC}.html: ${DEPS}
-
 .include "${DOC_PREFIX}/share/mk/doc.project.mk"
+

share/mk/doc.docbook-dep.mk

@@ -0,0 +1,30 @@
+#
+# $FreeBSD$
+#
+# This include file <doc.docbook-dep.mk> handles implicit dependencies of
+# DocBook documentation in the FreeBSD Documentation Project.
+#
+
+#
+# extract the depending *.xml files from the main
+# input sources on the fly:
+#
+# <!ENTITY release.building SYSTEM "./releng-building.xml">
+#
+# 	=> ./releng-building.xml
+#
+
+.if ${.TARGETS} == "all"
+_DOCBOOK_DEPS_SYSTEM != for i in $$(egrep '<!ENTITY [^ ]+ SYSTEM "[^ ]+\.xml">' ${SRCS} | sed -E 's,.*"([^"]+)".*,\1,');do \
+			  if [ -e $$i ]; then \
+			    echo $i; \
+			  else \
+			    echo "Warning: dep file $$(pwd)/$$i does not exists" >&2; \
+			  fi; \
+			done
+.endif
+
+DOCBOOK_DEPS += ${_DOCBOOK_DEPS_SYSTEM}
+
+index.html ${DOC}.html: ${DOCBOOK_DEPS}
+

share/mk/doc.project.mk

@@ -99,6 +99,11 @@ DOC_LOCAL_MK=	${DOC_PREFIX}/${LANGCODE}/share/mk/doc.local.mk
 .if defined(DOC)
 .if ${DOCFORMAT} == "docbook"
 .include "doc.docbook.mk"
+
+.if !defined(DOCBOOK_DEPS_DISABLE) || ${DOCBOOK_DEPS_DISABLE} != "YES"
+.include "doc.docbook-dep.mk"
+.endif
+
 .endif
 .if ${DOCFORMAT} == "slides"
 .include "doc.slides.mk"

zh_TW.UTF-8/books/fdp-primer/Makefile

@@ -31,4 +31,7 @@ IMAGES_LIB+=	callouts/5.png
 URL_RELPREFIX?=	../../../..
 DOC_PREFIX?=	${.CURDIR}/../../..
 
+# Fixme!
+DOCBOOK_DEPS_DISABLE=YES
+
 .include "${DOC_PREFIX}/share/mk/doc.project.mk"

zh_TW.UTF-8/books/handbook/Makefile

@@ -161,4 +161,7 @@ SYMLINKS=	${DESTDIR} index.html handbook.html
 URL_RELPREFIX?=	../../../..
 DOC_PREFIX?=	${.CURDIR}/../../..
 
+# Fixme!
+DOCBOOK_DEPS_DISABLE=YES
+
 .include "${DOC_PREFIX}/share/mk/doc.project.mk"