RF - source-release target with clean, a few release doc cleanups

Author: matthew-brett

Makefile

@@ -247,8 +247,9 @@ sdist-tests:
 bdist-egg-tests:
 	$(PYTHON) -c 'from nisext.testers import bdist_egg_tests; bdist_egg_tests("nibabel")'
 
-source-release: clean
+source-release: distclean
 	python -m compileall .
+	make distclean
 	python setup.py sdist --formats=gztar,zip
 
 venv-tests:

doc/source/devel/make_release.rst

@@ -142,12 +142,15 @@ Release checklist
     make doctest
     cd ..
 
+* Check everything compiles without syntax errors::
+
+    python -m compileall .
+
 * The release should now be ready.
 
 * Edit :file:`nibabel/info.py` to set ``_version_extra`` to ``''``; commit.
   Then::
 
-    make distclean
     make source-release
 
 * Once everything looks good, upload the source release to PyPi.  See
@@ -194,6 +197,10 @@ Release checklist
   If this is just a maintenance release from ``maint/1.0.x`` or similar, just
   tag and set the version number to - say - ``1.0.2.dev``.
 
+* Push tags::
+
+    git push --tags
+
 * Make next development release tag
 
     After each release the master branch should be tagged