From 5528e210deb433ccc2c36aa894310a2908ef0c27 Mon Sep 17 00:00:00 2001
From: Russell Bryant <russell@russellbryant.com>
Date: Sun, 2 Nov 2008 05:47:13 +0000
Subject: [PATCH] Modify the Makefile logic for extracting documentation.  -
 Build the documentation when you run "make", as opposed to "make install"  -
 Only rebuild the documentation when source code has been changed

git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@153577 65c4cc65-6c06-0410-ace0-fbb531ad65f3
---
 Makefile | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/Makefile b/Makefile
index 0521518e0b..90a47c946d 100644
--- a/Makefile
+++ b/Makefile
@@ -351,7 +351,7 @@ all: _all
 	@echo " +               $(mK) install               +"  
 	@echo " +-------------------------------------------+"  
 
-_all: cleantest makeopts $(SUBDIRS)
+_all: cleantest makeopts $(SUBDIRS) doc/core-en_US.xml
 
 makeopts: configure
 	@echo "****"
@@ -484,19 +484,19 @@ datafiles: _all
 	mkdir -p $(DESTDIR)$(AGI_DIR)
 	$(MAKE) -C sounds install
 
-documentation:
+doc/core-en_US.xml: $(foreach dir,$(MOD_SUBDIRS),$(wildcard $(dir)/*.c) $(wildcard $(dir)/*.cc)) 
 	@echo -n "Building Documentation For: "
-	@echo "<?xml version=\"1.0\" encoding=\"UTF-8\"?>" > doc/core-en_US.xml
-	@echo "<!DOCTYPE docs SYSTEM \"appdocsxml.dtd\">" >> doc/core-en_US.xml
-	@echo "<docs>" >> doc/core-en_US.xml
+	@echo "<?xml version=\"1.0\" encoding=\"UTF-8\"?>" > $@
+	@echo "<!DOCTYPE docs SYSTEM \"appdocsxml.dtd\">" >> $@
+	@echo "<docs>" >> $@
 	@for x in $(MOD_SUBDIRS); do \
 		echo -n "$$x " ; \
 		for i in $$x/*.c; do \
-			$(AWK) -f build_tools/get_documentation $$i >> doc/core-en_US.xml ; \
+			$(AWK) -f build_tools/get_documentation $$i >> $@ ; \
 		done ; \
 	done
-	@echo "</docs>" >> doc/core-en_US.xml
-	@echo -e "\ndoc/core-en_US.xml --> $(ASTDATADIR)/documentation/core-en_US.xml"
+	@echo
+	@echo "</docs>" >> $@
 
 update: 
 	@if [ -d .svn ]; then \
@@ -597,7 +597,7 @@ ifneq ($(findstring ~,$(DESTDIR)),)
 	@exit 1
 endif
 
-install: badshell datafiles documentation bininstall
+install: badshell datafiles bininstall
 	@if [ -x /usr/sbin/asterisk-post-install ]; then \
 		/usr/sbin/asterisk-post-install $(DESTDIR) . ; \
 	fi
-- 
GitLab