formatting

setup.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python
+"""Setup script for python package."""
 
 import os
 import sys
@@ -14,14 +15,18 @@ sys.path.insert(0, src_dir)
 
 
 def read(fname):
-    """read file from same path as setup.py"""
+    """Read file from same path as setup.py."""
     return open(os.path.join(os.path.dirname(__file__), fname)).read()
 
 
 setuptools_scm_template = """\
-# coding: utf-8
-# file generated by setuptools_scm
-# don't change, don't track in version control
+#!/usr/bin/python
+#  -*- coding: utf-8 -*-
+\"\"\"Version identifier.
+
+file generated by setuptools_scm
+don't change, don't track in version control
+\"\"\"
 
 version = '{version}'
 """