Add stubs...

Author: Diptorup Deb

docs/docfiles/intro.rst

@@ -1,20 +1,30 @@
 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
+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.
+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 SYCL's 
+``kernel`` and ``program`` classes.
 
+Core Features
+-------------
 
-.. toctree::
-   :maxdepth: 2
-   :caption: Contents:
+.. todo::
 
+   Coming soon.
 
-Indices and tables
-==================
+User Guidies
+------------
+
+.. todo::
+
+    Device Management.
+
+.. todo::
+
+    USM Memory Management
 
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`

docs/docfiles/toc_pyapi.rst

@@ -1,10 +1,11 @@
-Python API
-==========
+dpctl Python API
+================
 
 .. toctree::
-    :maxdepth: 1
+    :hidden:
 
     dpctl - SYCL runtime wrapper classes and queue manager <dpctl_pyapi>
     dpctl.dptensor - Data-parallel tensor containers <dpctl.dptensor_api>
     dpctl.memory - USM memory manager <dpctl.memory_api>
     dpctl.program - Program manager <dpctl.program_api>
+

docs/doxyrest-config.lua.in

@@ -146,7 +146,7 @@ FOOTNOTE_MEMBER_PREFIX = nil
 --! formatting of module item declarations.
 --!
 
-LANGUAGE = C
+LANGUAGE = CPP
 
 --!
 --! Convert ``\verbatim`` sections in doxy-comments to ``.. code-block::``

docs/index_doxyrest.rst.in

@@ -6,8 +6,10 @@
 .. include:: ./docfiles/intro.rst
 
 .. toctree::
-    :maxdepth: 3
-    :caption: Contents:
+    :maxdepth: 1
+    :caption: API Documentation
 
     docfiles/toc_pyapi
     @DOXYREST_OUTPUT_DIR_NAME@/index
+
+.. include:: ./docfiles/boilerplate.rst

docs/index_no_doxyrest.rst.in

@@ -6,7 +6,9 @@
 .. include:: ./docfiles/intro.rst
 
 .. toctree::
-    :maxdepth: 3
-    :caption: Contents:
+    :maxdepth: 1
+    :caption: API Documentation
 
     docfiles/toc_pyapi
+
+.. include:: ./docfiles/boilerplate.rst