Merge pull request #426 from IntelPython/setup_pie

Improvements to setup.py

Author: Diptorup Deb

README.md

@@ -67,6 +67,14 @@ For development:
 python setup.py develop
 ```
 
+It is also possible to build dpctl using [DPC++ toolchain](https://github.com/intel/llvm/blob/sycl/sycl/doc/GetStartedGuide.md) instead of oneAPI DPC++. Instead of activating the oneAPI environment, indicate the toolchain installation prefix with `--sycl-compiler-prefix` option, e.g.
+
+```cmd
+python setup.py develop --sycl-compiler-prefix=${DPCPP_ROOT}/llvm/build
+```
+
+Please use `python setup.py develop --help` for more details.
+
 Install Wheel Package from Pypi
 ==================================
 1. Install dpctl

docs/docfiles/user_guides/QuickStart.rst

@@ -165,9 +165,19 @@ to build and install
 Building using custom dpcpp
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. todo::
+It is possible to build dpctl from source using .. _DPC++ toolchain: https://github.com/intel/llvm/blob/sycl/sycl/doc/GetStartedGuide.md
+instead of the DPC++ compiler that comes with oneAPI. One reason for doing this
+may be to enable support for CUDA devices.
 
-    Instructions coming soon.
+Following steps in :ref:`Build and Install with setuptools` use command line
+option :code:`--sycl-compiler-prefix`, for example:
+
+.. code-block:: bash
+
+    python setup.py develop --sycl-compiler-prefix=${DPCPP_ROOT}/llvm/build
+
+Available options and their descriptions can be retrieved using option
+:code:`--help`.
 
 Using dpctl
 -----------

dpctl/_sycl_context.pyx

@@ -16,6 +16,7 @@
 
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 """ Implements SyclContext Cython extension type.
 """

dpctl/_sycl_device.pyx

@@ -16,6 +16,7 @@
 
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 """ Implements SyclDevice Cython extension type.
 """

dpctl/_sycl_device_factory.pyx

@@ -16,6 +16,7 @@
 
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 """ This module implements several device creation helper functions:
 

dpctl/_sycl_event.pyx

@@ -16,6 +16,7 @@
 
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 """ Implements SyclEvent Cython extension type.
 """

dpctl/_sycl_platform.pyx

@@ -16,6 +16,7 @@
 #
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 """ Implements SyclPlatform Cython extension type.
 """

dpctl/_sycl_queue.pyx

@@ -16,6 +16,7 @@
 
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 """ Implements SyclQueue Cython extension type.
 """

dpctl/_sycl_queue_manager.pyx

@@ -16,6 +16,7 @@
 #
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 from __future__ import print_function
 

dpctl/memory/_memory.pyx

@@ -16,6 +16,7 @@
 
 # distutils: language = c++
 # cython: language_level=3
+# cython: linetrace=True
 
 """This file implements Python buffer protocol using Sycl USM shared and host
 allocators. The USM device allocator is also exposed through this module for