From 3d5f8a80b68c3143ae3e057d0191d8e17701e18a Mon Sep 17 00:00:00 2001
From: telamonian <mklein@jhu.edu>
Date: Fri, 12 Jul 2019 02:43:30 -0400
Subject: [PATCH] fixed sphinx warning for deprecated source_parsers config
 field

fixed as per https://www.sphinx-doc.org/en/master/usage/markdown.html
---
 docs/source/conf.py | 23 +++++++++++------------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/docs/source/conf.py b/docs/source/conf.py
index befd8fa4fe70..3c9852504c59 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -22,7 +22,6 @@
 # sys.path.insert(0, os.path.abspath('.'))
 
 # For conversion from markdown to html
-import recommonmark.parser
 from recommonmark.transform import AutoStructify
 
 
@@ -35,24 +34,24 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ['sphinx.ext.intersphinx',
+extensions = [
+    'recommonmark',
+    'sphinx.ext.intersphinx',
     'sphinx.ext.mathjax',
-    'sphinx_copybutton']
+    'sphinx_copybutton'
+]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
-# The suffix(es) of source filenames.
-# You can specify multiple suffix as a list of string:
-#
-# source_suffix = ['.rst', '.md']
-
-source_parsers = {
-    '.md': 'recommonmark.parser.CommonMarkParser',
+# The file extensions of source files.
+# Sphinx considers the files with this suffix as sources.
+# The value can be a dictionary mapping file extensions to file types.
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.md': 'markdown'
 }
 
-source_suffix = ['.rst', '.md']
-
 # The master toctree document.
 master_doc = 'index'