MAINT: Fix code comments.

A comment pertaining to docutils_namespace() had been separated
from the code that it was referring to.

Moved comment back to appropriate location and added a separate
comment to unrelated code to differentiate the two.

Author: rossbar

numpydoc/tests/test_full.py

@@ -25,11 +25,12 @@ def ignore(src, names):
     conf_dir = temp_dir
     out_dir = op.join(temp_dir, '_build', 'html')
     toctrees_dir = op.join(temp_dir, '_build', 'toctrees')
-    # Avoid warnings about re-registration, see:
-    # https://github.com/sphinx-doc/sphinx/issues/5038
+    # Set behavior across different Sphinx versions
     kwargs = dict()
     if LooseVersion(sphinx.__version__) >= LooseVersion('1.8'):
         kwargs.update(warningiserror=True, keep_going=True)
+    # Avoid warnings about re-registration, see:
+    # https://github.com/sphinx-doc/sphinx/issues/5038
     with docutils_namespace():
         app = Sphinx(src_dir, conf_dir, out_dir, toctrees_dir,
                      buildername='html', **kwargs)