Build epydoc API documents by default

diff --git a/.gitignore b/.gitignore
index d9e230f..f607c3c 100644 (file)
--- 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 (file)
--- 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 (file)
--- 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 (executable)
--- 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