summaryrefslogtreecommitdiff
path: root/lib/testtools/Makefile
diff options
context:
space:
mode:
Diffstat (limited to 'lib/testtools/Makefile')
-rw-r--r--lib/testtools/Makefile27
1 files changed, 24 insertions, 3 deletions
diff --git a/lib/testtools/Makefile b/lib/testtools/Makefile
index c36fbd8012..b3e40ecddf 100644
--- a/lib/testtools/Makefile
+++ b/lib/testtools/Makefile
@@ -12,7 +12,7 @@ TAGS: ${SOURCES}
tags: ${SOURCES}
ctags -R testtools/
-clean:
+clean: clean-sphinx
rm -f TAGS tags
find testtools -name "*.pyc" -exec rm '{}' \;
@@ -22,14 +22,35 @@ prerelease:
release:
./setup.py sdist upload --sign
+ $(PYTHON) scripts/_lp_release.py
snapshot: prerelease
./setup.py sdist
+### Documentation ###
+
apidocs:
- pydoctor --make-html --add-package testtools \
+ # pydoctor emits deprecation warnings under Ubuntu 10.10 LTS
+ PYTHONWARNINGS='ignore::DeprecationWarning' \
+ pydoctor --make-html --add-package testtools \
--docformat=restructuredtext --project-name=testtools \
--project-url=https://launchpad.net/testtools
+doc/news.rst:
+ ln -s ../NEWS doc/news.rst
+
+docs: doc/news.rst docs-sphinx
+ rm doc/news.rst
+
+docs-sphinx: html-sphinx
+
+# Clean out generated documentation
+clean-sphinx:
+ cd doc && make clean
+
+# Build the html docs using Sphinx.
+html-sphinx:
+ cd doc && make html
-.PHONY: check clean prerelease release apidocs
+.PHONY: apidocs docs-sphinx clean-sphinx html-sphinx docs
+.PHONY: check clean prerelease release