Configure epydoc via setup.cfg

diff --git a/.gitignore b/.gitignore
index 4413d2bb3b3c0e6e329d14ac81e0836fd73a2e85..4864fdfe9ffd36f4cf46c3f922954737c3a74a3c 100644 (file)
--- a/.gitignore
+++ b/.gitignore
@@ -9,7 +9,6 @@ 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/docs b/debian/docs
index ccd359dbb3aaa5ade5107ac41457a6652d5058d6..ce06068d03427dda86cfe70a51b47f29fb2e76d2 100644 (file)
--- a/debian/docs
+++ b/debian/docs
@@ -1,3 +1,3 @@
 README
 docs/manual-html/
-docs/apidocs/
+build/apidocs/

diff --git a/debian/rules b/debian/rules
index 5dd5d7b2e890a82427e0a3267913eaab35f76235..89d1a534f22de4fc1b6fc1b53c5ddad5d9c6c9c9 100755 (executable)
--- a/debian/rules
+++ b/debian/rules
@@ -47,9 +47,7 @@ docs/git-pbuilder.1: bin/git-pbuilder
        pod2man $< $@
 
 apidocs:
-       epydoc -v -n git-buildpackage --no-sourcecode -o docs/apidocs/ \
-           --url=https://honk.sigxcpu.org/piki/projects/git-buildpackage/ \
-           --fail-on-docstring-warning gbp/ tests/test_Git*.py
+       epydoc --config=setup.cfg
 
 ifeq (,$(filter nocheck,$(DEB_BUILD_OPTIONS)))
 pychecker:
@@ -77,6 +75,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/ docs/apidocs/
+       -rm -r docs/manual-html/
 
 .PHONY: checks

diff --git a/setup.cfg b/setup.cfg
index 8923264052a2c8ee1a9312fe6dcf6c411c1fe9b2..7dfbe05a5d82eb73d76bdfab6cd06636a57c2dee 100644 (file)
--- a/setup.cfg
+++ b/setup.cfg
@@ -2,3 +2,11 @@
 with-doctest=1
 with-coverage=1
 cover-package=gbp
+
+[epydoc]
+name = git-buildpackage
+sourcecode = no
+url = https://honk.sigxcpu.org/piki/projects/git-buildpackage/
+target = build/apidocs/
+fail-on = docstring_warning
+modules = gbp, tests/test_Git*.py