From 0875cf30ae9a2b7c93ac917bdaa93b8020a43562 Mon Sep 17 00:00:00 2001
From: Tomek Mrugalski <tomasz@isc.org>
Date: Tue, 2 Oct 2018 15:17:06 +0200
Subject: [PATCH] [#10,!3] Couple convenience make targets added

---
 doc/Makefile.am | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/doc/Makefile.am b/doc/Makefile.am
index 98c3de0377..2b21e409c4 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -74,12 +74,21 @@ guide:
 clean:
 	rm -rf html
 
-templates:
+# This target will generate templates. There's no need to run it, unless
+# new commands have been added or there are existing commands that are
+# still not documented.
+templates: docgen
 	docgen/generate-templates docgen/cmds-list
 
-api: templates
+# This will generate the api.xml file using docgen generator. It will
+# read the JSON files from api/ directory. Make sure they're up to date.
+api: templates docgen
 	docgen/kea-docgen api/*.json
 
+# This convenience target makes sure the docgen tool is built properly
+docgen:
+	$(MAKE) -C docgen
+
 # That's a bit of a hack, but we are making sure that devel target
 # is always valid. The alternative is to make devel depend on all
 # *.cc *.h files in the whole tree.
-- 
GitLab