Repository: PlasmaPy/PlasmaPy

Issue:
Rename math submodule
Namespaces are one honking great idea, so let's not have a submodule that shares a name with [an existing library](https://docs.python.org/3.6/library/math.html). Will require changing the filename, folder name, and purging all instances of it being imported.

Current frontrunner for replacement name is `mathematics`.

Discussion:

Patch:
diff --git a/docs/index.rst b/docs/index.rst
index e6a0a4e0..5c3727d3 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -31,7 +31,7 @@ Modules
     :maxdepth: 1
 
     atomic/index
-    math/index
+    mathematics/index
     physics/index
 
 Classes
diff --git a/docs/math/index.rst b/docs/math/index.rst
deleted file mode 100644
index 6368d851..00000000
--- a/docs/math/index.rst
+++ /dev/null
@@ -1,18 +0,0 @@
-.. py:module:: math
-
-.. _plasmapy-math:
-
-****
-Math
-****
-
-.. automodule:: plasmapy.math
-
-Functions
-=========
-
-The functions contained within the math subpackage are:
-
-* .. autofunction:: plasma_dispersion_func
-
-* .. autofunction:: plasma_dispersion_func_deriv
diff --git a/docs/mathematics/index.rst b/docs/mathematics/index.rst
new file mode 100644
index 00000000..a2ad3502
--- /dev/null
+++ b/docs/mathematics/index.rst
@@ -0,0 +1,18 @@
+.. py:module:: mathematics
+
+.. _plasmapy-mathematics:
+
+****
+Mathematics
+****
+
+.. automodule:: plasmapy.mathematics
+
+Functions
+=========
+
+The functions contained within the mathematics subpackage are:
+
+* .. autofunction:: plasma_dispersion_func
+
+* .. autofunction:: plasma_dispersion_func_deriv
diff --git a/plasmapy/__init__.py b/plasmapy/__init__.py
index f45b745f..8362b316 100644
--- a/plasmapy/__init__.py
+++ b/plasmapy/__init__.py
@@ -71,7 +71,7 @@ def _check_astropy_version():  # coveralls: ignore
     from . import classes
     from . import constants
     from . import atomic
-    from . import math
+    from . import mathematics
     from . import physics
     from . import utils
 except ImportError:  # coveralls: ignore
diff --git a/plasmapy/math/__init__.py b/plasmapy/math/__init__.py
deleted file mode 100644
index 48603f3e..00000000
--- a/plasmapy/math/__init__.py
+++ /dev/null
@@ -1,4 +0,0 @@
-from .math import (plasma_dispersion_func,
-                   plasma_dispersion_func_deriv)
-
-from . import tests
diff --git a/plasmapy/mathematics/__init__.py b/plasmapy/mathematics/__init__.py
new file mode 100644
index 00000000..33e80147
--- /dev/null
+++ b/plasmapy/mathematics/__init__.py
@@ -0,0 +1,4 @@
+from .mathematics import (plasma_dispersion_func,
+                          plasma_dispersion_func_deriv)
+
+from . import tests


Test patch:
diff --git a/plasmapy/math/math.py b/plasmapy/mathematics/mathematics.py
similarity index 100%
rename from plasmapy/math/math.py
rename to plasmapy/mathematics/mathematics.py
diff --git a/plasmapy/math/tests/__init__.py b/plasmapy/mathematics/tests/__init__.py
similarity index 100%
rename from plasmapy/math/tests/__init__.py
rename to plasmapy/mathematics/tests/__init__.py
diff --git a/plasmapy/math/tests/test_dispersion.py b/plasmapy/mathematics/tests/test_dispersion.py
similarity index 97%
rename from plasmapy/math/tests/test_dispersion.py
rename to plasmapy/mathematics/tests/test_dispersion.py
index 877c8c64..98349f58 100644
--- a/plasmapy/math/tests/test_dispersion.py
+++ b/plasmapy/mathematics/tests/test_dispersion.py
@@ -3,7 +3,7 @@
 import numpy as np
 import pytest
 from astropy import units as u
-from ..math import plasma_dispersion_func, plasma_dispersion_func_deriv
+from ..mathematics import plasma_dispersion_func, plasma_dispersion_func_deriv
 
 
 def test_plasma_dispersion_func():