Reorganize rst files into a sub-folder.

Author: Diptorup Deb

docs/conf.in

@@ -33,6 +33,7 @@ extensions = [
     "sphinx.ext.githubpages",
     "sphinx.ext.autodoc",
     "sphinx.ext.napoleon",
+    "sphinx.ext.todo",
 ]
 
 use_doxyrest = "@DPCTL_ENABLE_DOXYREST@"
@@ -61,7 +62,7 @@ source_suffix = ".rst"
 # This pattern also affects html_static_path and html_extra_path.
 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
 
-highlight_language = "C"
+highlight_language = "Python"
 
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = "sphinx"

docs/dpctl.dptensor_api.rst renamed to docs/docfiles/dpctl.dptensor_api.rst

@@ -0,0 +1,20 @@
+Welcome to Data-parallel Control (dpctl)'s documentation!
+=========================================================
+
+Data-parallel control (``dpctl``) is a library that exposes SYCL and DPCPP to
+languages other than C++. Currently, ``dpctl`` provides SYCL bindings for C and
+Python making it possible to access SYCL runtime objects and methods from these
+languages. The SYCL functionality covered by ``dpctl`` includes the core SYCL runtime classes described in Section 4.6 of the `SYCL 2020 spec <https://www.khronos.org/registry/SYCL/specs/sycl-2020/html/sycl-2020.html#_sycl_runtime_classes>`_ and USM memory management. ``Dpctl`` also has experimental support for DPCPP ``kernel`` and ``program`` classes.
+
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`

docs/dpctl.memory_api.rst renamed to docs/docfiles/dpctl.memory_api.rst

@@ -3,24 +3,11 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to Data-parallel Control (dpctl)'s documentation!
-=========================================================
-
-.. toctree::
-   :maxdepth: 2
-   :caption: Contents:
-
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+.. include:: ./docfiles/intro.rst
 
 .. toctree::
     :maxdepth: 3
     :caption: Contents:
 
-    toc_pyapi
+    docfiles/toc_pyapi
     @DOXYREST_OUTPUT_DIR_NAME@/index

docs/dpctl.program_api.rst renamed to docs/docfiles/dpctl.program_api.rst

@@ -3,23 +3,10 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to Data-parallel Control (dpctl)'s documentation!
-=========================================================
-
-.. toctree::
-   :maxdepth: 2
-   :caption: Contents:
-
-
-Indices and tables
-==================
-
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+.. include:: ./docfiles/intro.rst
 
 .. toctree::
     :maxdepth: 3
     :caption: Contents:
 
-    toc_pyapi
+    docfiles/toc_pyapi