gtk-doc-plugins.mak: Add 'check-inspected-versions' target; this helps identify files...

Original commit message from CVS:
* gtk-doc-plugins.mak:
Add 'check-inspected-versions' target; this helps identify
files that should have been removed or where the version
number should (ideally) be updated before a release
(which doesn't happen automatically if the releaser doesn't
build that plugin locally). Not adding at a distcheck hook
yet though, because it's not really that important and would
probably also be a problem on buildbots.

diff --git a/ChangeLog b/ChangeLog
index c99518f..2c731fa 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,14 @@
+2008-02-22  Tim-Philipp Müller  <tim at centricular dot net>
+
+       * gtk-doc-plugins.mak:
+         Add 'check-inspected-versions' target; this helps identify
+         files that should have been removed or where the version
+         number should (ideally) be updated before a release
+         (which doesn't happen automatically if the releaser doesn't
+         build that plugin locally). Not adding at a distcheck hook
+         yet though, because it's not really that important and would
+         probably also be a problem on buildbots.
+
 2008-02-22  Sebastian Dröge  <slomo@circular-chaos.org>
 
        * gst.supp:

diff --git a/gtk-doc-plugins.mak b/gtk-doc-plugins.mak
index f511cd0..71f60ba 100644 (file)
--- a/gtk-doc-plugins.mak
+++ b/gtk-doc-plugins.mak
@@ -2,8 +2,15 @@
 # for GStreamer plug-ins
 
 help:
+       @echo
        @echo "If you are a doc maintainer, run 'make update' to update"
        @echo "the documentation files maintained in CVS"
+       @echo
+       @echo Other useful make targets:
+       @echo
+       @echo  check-inspected-versions: make sure the inspected plugin info
+       @echo                            is up to date before a release
+       @echo
 
 # update the stuff maintained by doc maintainers
 update:
@@ -343,6 +350,21 @@ check-hierarchy: $(DOC_MODULE).hierarchy
 
 check: check-hierarchy
 
+# wildcard is apparently not portable to other makes, hence the use of find
+inspect_files = $(shell find $(top_srcdir)/docs/plugins/inspect -name '*.xml')
+
+check-inspected-versions:
+       @echo Checking plugin versions of inspected plugin data ...; \
+       fail=0 ; \
+       for each in $(inspect_files) ; do \
+         if (grep -H '<version>' $$each | grep -v '<version>$(VERSION)'); then \
+           echo $$each should be fixed to say version $(VERSION) or be removed ; \
+           echo "sed -i -e 's/<version.*version>/<version>$(VERSION)<\/version>/'" $$each; \
+           echo ; \
+           fail=1; \
+         fi ; \
+       done ; \
+       exit $$fail
 
 #
 # Require gtk-doc when making dist