fix sphinx warnings + use readthedocs theme

murrayrm · murrayrm · commit 469ae009b6f2 · 2019-05-11T17:49:29.000-07:00
diff --git a/control/statesp.py b/control/statesp.py
@@ -424,8 +424,8 @@ def freqresp(self, omega):
 
              G(exp(j*omega*dt)) = mag*exp(j*phase).
 
-        Inputs
-        ------
+        Parameters
+        ----------
         omega: A list of frequencies in radians/sec at which the system
             should be evaluated. The list can be either a python list
             or a numpy array and will be sorted before evaluation.
diff --git a/doc-requirements.txt b/doc-requirements.txt
@@ -1,4 +1,5 @@
 numpy
 scipy
 matplotlib
+sphinx_rtd_theme
 numpydoc
diff --git a/doc/conf.py b/doc/conf.py
@@ -30,15 +30,15 @@
 # -- Project information -----------------------------------------------------
 
 project = u'Python Control Systems Library'
-copyright = u'2018, python-control.org'
+copyright = u'2019, python-control.org'
 author = u'Python Control Developers'
 
 # Version information - read from the source code
 import re
 import control
 
-# The short X.Y version
-version = re.sub(r'(\d+\.\d+)\.(.*)', r'\1', control.__version__)
+# The short X.Y.Z version
+version = re.sub(r'(\d+\.\d+\.\d+)(.*)', r'\1', control.__version__)
 
 # The full version, including alpha/beta/rc tags
 release = control.__version__
@@ -109,7 +109,7 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-# html_theme = 'alabaster'
+html_theme = 'sphinx_rtd_theme'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
@@ -120,7 +120,7 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+# html_static_path = ['_static']
 
 # Custom sidebar templates, must be a dictionary that maps document names
 # to template names.
