X-Git-Url: http://gitweb.michael.orlitzky.com/?p=dunshire.git;a=blobdiff_plain;f=makefile;h=13b18cbc52cf09b3bf86b2b7fa8e38b373144b1d;hp=0cd51823d36ae7faabae243778b6d66319fc7a35;hb=HEAD;hpb=bdb596b84a06d0c97e39d42586a51fc36ba44186

diff --git a/makefile b/makefile
index 0cd5182..13b18cb 100644
--- a/makefile
+++ b/makefile
@@ -1,22 +1,55 @@
 PN := dunshire
 SRCS := $(PN)/*.py test/*.py
 
-doc: $(SRCS) doc/source/conf.py doc/makefile
+# Sphinx tries to keep track of which docs need to be built on its
+# own. We could do better, but we would have to duplicate all of the
+# information that we already gave Sphinx to make it work. Thus the
+# "doc" target will unconditionally invoke sphinx.
+.PHONY: doc
+doc:
 	cd doc && $(MAKE) html
 
+# Run the doctests contained in the sphinx documentation, which aren't
+# run as part of the normal test suite (because nobody wants to wait
+# for sphinx to run).
 .PHONY: doctest
 doctest:
 	cd doc && $(MAKE) doctest
 
+# Run the test suite once.
 .PHONY: check
 check:
-	PYTHONPATH="." python test/
+	PYTHONPATH="." test/__main__.py
 
+# Run the test suite once, loudly. This is used in Gentoo, for example
+# where we want users to see the output from the test suite on the off
+# chance that it fails and they have to report it.
+.PHONY: check-verbose
+check-verbose:
+	PYTHONPATH="." test/__main__.py --verbose
+
+# Run the test suite forever, but only the parts of it that are
+# randomized.
+.PHONY: check-loop
+check-loop:
+	PYTHONPATH="." test/__main__.py --no-doctests --loop
+
+# Run pylint to obtain some unconstructive criticism on my coding style.
 .PHONY: lint
 lint:
 	pylint --rcfile=./.pylintrc $(SRCS)
 
+# Create a source distribution tarball. First we clean up, to make
+# sure no junk gets added to the distribution. Then we build the docs
+# so that users will get some usable HTML documentation and not just
+# the source files.
+.PHONY: dist
+dist: clean doc
+	python setup.py sdist
+
+# Delete urrythang.
 .PHONY: clean
 clean:
 	rm -rf $(PN)/__pycache__ test/__pycache__ doc/build
 	rm -rf $(PN).egg-info
+	rm -rf dist