Update DPC++ specification for 1.1 release (#384)

* Update DPC++ specification for 1.1 release.  Primarily addition of new extensions, and removal of previous extensions that have been successfully folded into the SYCL 2020 specification.

Signed-off-by: Michael Kinsner <michael.kinsner@intel.com>

* Clarify what extended atomics add over SYCL 2020

Signed-off-by: Michael Kinsner <michael.kinsner@intel.com>

* Incorporate @gmlueck input

Signed-off-by: Michael Kinsner <michael.kinsner@intel.com>

* Fix links that were to extension directories and not the actual spec documents

Signed-off-by: Michael Kinsner <michael.kinsner@intel.com>

* Remove assert description

Signed-off-by: Michael Kinsner <michael.kinsner@intel.com>

* enable building standalone dpcpp, formatting fix

Co-authored-by: Robert Cohn <rscohn2@gmail.com>

Author: Mike Kinsner

source/conf.py

@@ -21,6 +21,8 @@
 repo_root = '..'
 exec(open(join(repo_root, 'source', 'conf', 'common_conf.py')).read())
 
+extensions += ['notfound.extension']  # noqa: F821
+
 # -- Project information -----------------------------------------------------
 
 project = u'oneAPI Specification'

source/conf/common_conf.py

@@ -23,14 +23,12 @@
 )
 
 extensions = [
-    'notfound.extension',
     'sphinx.ext.autodoc',
     'sphinx.ext.doctest',
     'sphinx.ext.todo',
     'sphinx.ext.coverage',
     'sphinx.ext.mathjax',
     'sphinx.ext.ifconfig',
-    #    'sphinx.ext.imgconverter',
     'sphinx.ext.viewcode',
     'sphinx.ext.githubpages',
     'sphinx.ext.graphviz',
@@ -41,7 +39,6 @@
     'sphinx_substitution_extensions',
     'sphinxcontrib.plantuml',
     'breathe',
-    #      'vplapi',
     'dalapi',  # oneDAL API generator
 ]
 

source/elements/dpcpp/source/conf.py

@@ -18,10 +18,11 @@
 #
 import os
 import sys
-sys.path.insert(0, os.path.abspath(os.path.join('..','..','..','conf')))
-# element_conf needs to import this conf
-sys.path.insert(0, os.path.abspath('.'))
+from os.path import join
+
 
 project = 'dpcpp'
 
-from element_conf import *
+repo_root = join('..', '..', '..', '..')
+exec(open(join(repo_root, 'source', 'conf', 'common_conf.py')).read())
+exec(open(join(repo_root, 'source', 'conf', 'element_conf.py')).read())