aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGuido Günther <agx@sigxcpu.org>2011-07-29 18:23:42 +0200
committerGuido Günther <agx@sigxcpu.org>2011-07-30 14:38:32 +0200
commit2fbac773f79a4c6cf074e29804244ea90b9b1cb4 (patch)
tree57e8dee69d020f89116ca77da2afca3f668ed35e
parent61b720359540801fde1465379c72e15e70fa4675 (diff)
Build epydoc API documents by default
-rw-r--r--.gitignore1
-rw-r--r--debian/control2
-rw-r--r--debian/docs1
-rwxr-xr-xdebian/rules12
4 files changed, 10 insertions, 6 deletions
diff --git a/.gitignore b/.gitignore
index d9e230f..f607c3c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -18,6 +18,7 @@ docs/manual-html/
docs/manpage.links
docs/manpage.refs
docs/version.ent
+docs/apidocs/
debian/git-buildpackage.*.debhelper
debian/git-buildpackage.debhelper.*
diff --git a/debian/control b/debian/control
index 11a4924..12ef49d 100644
--- a/debian/control
+++ b/debian/control
@@ -4,7 +4,7 @@ Priority: optional
Maintainer: Guido Günther <agx@sigxcpu.org>
Build-Depends: cdbs (>= 0.4.90~), debhelper (>= 5), python (>> 2.6.6-3~),
pychecker, gtk-doc-tools, sgml2x, docbook-utils, jade, python-dateutil, python-nose,
- bash-completion, perl,
+ bash-completion, perl, python-epydoc,
# For the testsuite
git-core, bzip2, unzip
Standards-Version: 3.9.2
diff --git a/debian/docs b/debian/docs
index 7fdec51..ccd359d 100644
--- a/debian/docs
+++ b/debian/docs
@@ -1,2 +1,3 @@
README
docs/manual-html/
+docs/apidocs/
diff --git a/debian/rules b/debian/rules
index 4642563..a7cf68f 100755
--- a/debian/rules
+++ b/debian/rules
@@ -42,21 +42,23 @@ $(MANUAL): docs/manual.sgml docs/chapters/*.sgml docs/manpages/*.sgml
docbook-2-html -s local $<
cp /usr/share/gtk-doc/data/*.png $(MANUAL)
+
docs/git-pbuilder.1: git-pbuilder
pod2man $< $@
-ifeq (,$(filter nocheck,$(DEB_BUILD_OPTIONS)))
-
links_stamp:
for c in $(COMMANDS); do \
ln -s $$c $$(echo $$c | sed -e 's,-,_,g').py; \
done
touch links_stamp
+apidocs: links_stamp
+ epydoc -o docs/apidocs/ gbp*.py git*.py gbp/
+
+ifeq (,$(filter nocheck,$(DEB_BUILD_OPTIONS)))
pychecker:
PYTHONPATH=. pychecker $(PYCHECKER_ARGS) -q git*.py gbp*.py
-
checks: links_stamp pychecker
export GIT_AUTHOR_NAME="Gbp Tests"; \
export GIT_AUTHOR_EMAIL=tests@example.com; \
@@ -71,7 +73,7 @@ $(GBP_VERSION): debian/changelog
$(VERSION_ENT): debian/changelog
echo '<!ENTITY gbp-version "$(DEB_VERSION)">' > $(VERSION_ENT)
-build/git-buildpackage:: $(MANPAGES) $(MANUAL) $(GBP_VERSION) checks
+build/git-buildpackage:: $(MANPAGES) $(MANUAL) $(GBP_VERSION) checks apidocs
binary-post-install/git-buildpackage::
dh_bash-completion
@@ -79,6 +81,6 @@ binary-post-install/git-buildpackage::
clean::
-rm git_*.py gbp_*.py gbp/gbp_version.py links_stamp
-rm docs/*.1 docs/manpage.* $(VERSION_ENT) git-pbuilder.1
- -rm -r docs/manual-html/
+ -rm -r docs/manual-html/ docs/apidocs/
.PHONY: checks