Get Nox build session to work on Windows (pypa#488)

Author: Thea Flowers

Makefile

@@ -3,6 +3,7 @@
 # Attribution-ShareAlike license:
 #   http://creativecommons.org/licenses/by-sa/3.0.
 
+import shutil
 import nox
 
 
@@ -12,7 +13,8 @@ def build(session):
     session.install('-r', 'requirements.txt')
     # Treat warnings as errors.
     session.env['SPHINXOPTS'] = '-W'
-    session.run('make', 'clean', 'html')
+    session.run(shutil.rmtree, 'build', ignore_errors=True)
+    session.run('sphinx-build', '-W', '-b', 'html', 'source', 'build')
 
 
 @nox.session

make.bat

@@ -30,8 +30,8 @@ typically in your project's :file:`setup.py` file.
 
 .. seealso::
 
-   * :any:`metadata_description`
-   * :any:`metadata_description_content_type`
+   * :ref:`description-optional`
+   * :ref:`description-content-type-optional`
 
 For example, to set these values in a package's :file:`setup.py` file,
 use ``setup()``'s ``long_description`` and ``long_description_content_type``.