Fixes to the platforms rst file.

Author: Diptorup Deb

docs/docfiles/urls.rst

@@ -5,7 +5,7 @@
 
 .. _Section 4.6: https://www.khronos.org/registry/SYCL/specs/sycl-2020/html/sycl-2020.html#_sycl_runtime_classes
 .. _SYCL 2020 spec: https://www.khronos.org/registry/SYCL/specs/sycl-2020/html/sycl-2020.html
-.. _sycl platform: https://sycl.readthedocs.io/en/latest/iface/platform.html
+.. _sycl::platform: https://sycl.readthedocs.io/en/latest/iface/platform.html
 .. _sycl device: https://sycl.readthedocs.io/en/latest/iface/device.html
 .. _sycl queue: https://sycl.readthedocs.io/en/latest/iface/queue.html
 .. _sycl event: https://sycl.readthedocs.io/en/latest/iface/event.html

docs/docfiles/user_guides/manual/platforms.rst

@@ -4,22 +4,21 @@
 Platform
 ########
 
-A platform abstracts one or more XPU that is connected to the host and that can
-be used for computation. The platforms queryable using dpctl depends on the
-device drivers that are installed on a system. A single driver may control
-multiple physical XPU, thus a platform may also consist of multiple XPUs.
-
 In dpctl, the class :class:`dpctl.SyclPlatform` represents a platform and
-abstracts the `sycl platform`_ SYCL runtime class.
+abstracts the `sycl::platform`_ SYCL runtime class. A platform abstracts one or
+more XPU that is connected to the host and that can be used for computation. The
+platforms queryable using dpctl depends on the device drivers that are installed
+on a system. A single driver may control multiple physical XPU, thus a platform
+may also consist of multiple XPUs.
 
 The platforms available on a system can be queried using the
 :func:`dpctl.lsplatform` function. In addition, as illustrated in the following
 example it is possible to print out metadata about a platform.
 
 .. literalinclude:: ../../../../examples/python/lsplatform.py
     :language: python
-    :start-after: #START
-    :end-before: #END
+    :start-after: # START
+    :end-before: # END
 
 The example is can be executed as follows:
 
@@ -35,4 +34,4 @@ The possible output for the example may be:
     The verbosity for the output can be controlled using the ``verbosity``
     keyword argument. Refer :func:`dpctl.lsplatform`.
 
-.. include:: ../../../urls.rst
+.. include:: ../../urls.rst