Merge pull request #347 from steff456/constants-rst

PR: Transform constants.md to rst format

Author: asmeurer

spec/API_specification/constants.md

@@ -0,0 +1,24 @@
+Constants
+=========
+
+    Array API specification for constants.
+
+A conforming implementation of the array API standard must provide and support the following constants adhering to the following conventions.
+
+-   Each constant must have a Python floating-point data type (i.e., ``float``) and be provided as a Python scalar value.
+
+Objects in API
+--------------
+
+.. currentmodule:: signatures.constants
+
+..
+  NOTE: please keep the functions in alphabetical order
+
+.. autosummary::
+   :toctree: generated
+
+   e
+   inf
+   nan
+   pi

spec/API_specification/constants.rst

@@ -0,0 +1,25 @@
+e = 2.718281828459045
+"""
+IEEE 754 floating-point representation of Euler's constant.
+
+``e = 2.71828182845904523536028747135266249775724709369995...``
+"""
+
+inf = float('inf')
+"""
+IEEE 754 floating-point representation of (positive) infinity.
+"""
+
+nan = float('nan')
+"""
+IEEE 754 floating-point representation of Not a Number (``NaN``).
+"""
+
+pi = 3.141592653589793
+"""
+IEEE 754 floating-point representation of the mathematical constant ``π``.
+
+``pi = 3.1415926535897932384626433...``
+"""
+
+__all__ = ['e', 'inf', 'nan', 'pi']