merge from master

rscohn2 · rscohn2 · commit b935225b7260 · 2020-05-29T14:15:42.000-05:00
diff --git a/scripts/oneapi.py b/scripts/oneapi.py
@@ -120,11 +120,13 @@ def sphinx(root, target):
     if not args.verbose:
         os.environ['LATEXMKOPTS'] = '--silent'
         os.environ['LATEXOPTS'] = '-interaction=nonstopmode -halt-on-error'
-    sphinx_args = ''
+    sphinx_args = '-N -j auto'
     if not args.verbose:
         sphinx_args += ' -q'
     if args.a:
         sphinx_args += ' -a'
+    if args.n:
+        sphinx_args += ' -n'
     shell('%s -M %s %s %s %s' % (sphinx_build,
                                  target,
                                  join(root,source_dir),
@@ -394,7 +396,8 @@ def main():
     parser.add_argument('--branch')
     parser.add_argument('--verbose', action='store_true')
     parser.add_argument('--dry-run', action='store_true')
-    parser.add_argument('-a', action='store_true')
+    parser.add_argument('-a', action='store_true', help='sphinx -a (build all files)')
+    parser.add_argument('-n', action='store_true', help='sphinx -n (nitpicky mode)')
     args = parser.parse_args()
 
     commands[args.action](args.root, args.action)
diff --git a/source/conf/common_conf.py b/source/conf/common_conf.py
@@ -31,7 +31,7 @@ def path_relative_to_repo_root(relative_path):
 ]
 
 env = {
-    'oneapi_version': '0.7',
+    'oneapi_version': '0.8',
     'l0_version': '0.91',
 }
 
diff --git a/source/elements/dpcpp/source/index.rst b/source/elements/dpcpp/source/index.rst
@@ -3,9 +3,9 @@
 
 .. _onedpcpp-section:
 
-=========================
-DPC++ |dpcpp_version|
-=========================
+=====
+DPC++
+=====
 
 Overview
 --------
diff --git a/source/elements/l0/source/index.rst b/source/elements/l0/source/index.rst
@@ -3,9 +3,9 @@
 
 .. _l0-section:
 
-=======================
-Level Zero |l0_version|
-=======================
+==========
+Level Zero
+==========
 
 The |l0_full_name| (Level Zero) provides low-level
 direct-to-metal interfaces that are tailored to the devices in a
diff --git a/source/elements/oneCCL/source/index.rst b/source/elements/oneCCL/source/index.rst
@@ -1,8 +1,8 @@
 .. _oneCCL-section:
 
-====================
-oneCCL |ccl_version|
-====================
+======
+oneCCL
+======
 
 .. toctree::
 
diff --git a/source/elements/oneDAL/source/index.rst b/source/elements/oneDAL/source/index.rst
@@ -3,9 +3,9 @@
 
 .. _oneDAL-section:
 
-==============================
-|dal_short_name| |dal_version|
-==============================
+================
+|dal_short_name|
+================
 
 
 .. |default_ctor_doc| replace:: Creates a new instance of class \
diff --git a/source/elements/oneDNN/source/index.rst b/source/elements/oneDNN/source/index.rst
@@ -7,8 +7,8 @@
 
 .. _oneDNN-section:
 
-oneDNN |dnn_version|
-====================
+oneDNN
+======
 
 |dnn_full_name| (oneDNN) is a performance library containing building blocks
 for for deep learning applications and frameworks. oneDNN supports:
diff --git a/source/elements/oneDPL/source/index.rst b/source/elements/oneDPL/source/index.rst
@@ -3,9 +3,9 @@
 
 .. _oneDPL-section:
 
-====================
-oneDPL |dpl_version|
-====================
+======
+oneDPL
+======
 
 The |dpl_full_name| (oneDPL) provides the functionality
 specified in the C++ standard, with extensions to support data parallelism
diff --git a/source/elements/oneMKL/source/index.rst b/source/elements/oneMKL/source/index.rst
@@ -3,9 +3,9 @@
 
 .. _oneMKL-section:
 
-====================
-oneMKL |mkl_version|
-====================
+======
+oneMKL
+======
 
 The |mkl_full_name| (oneMKL) defines a set of fundamental mathematical routines for use in high-performance computing and other applications. As part of oneAPI, oneMKL is designed to allow execution on a wide variety of computational devices: CPUs, GPUs, FPGAs, and other accelerators. The functionality is subdivided into several domains: dense linear algebra, sparse linear algebra, discrete Fourier transforms, random number generators and vector math.
 
diff --git a/source/elements/oneTBB/source/nested-index.rst b/source/elements/oneTBB/source/nested-index.rst
@@ -1,8 +1,8 @@
 .. _oneTBB-section:
 
-====================
-oneTBB |tbb_version|
-====================
+======
+oneTBB
+======
 
 .. toctree::
    :maxdepth: 2
diff --git a/source/elements/oneVPL/source/index.rst b/source/elements/oneVPL/source/index.rst
@@ -3,13 +3,13 @@
 
 .. _oneVPL-section:
 
-********************
-oneVPL |vpl_version|
-********************
+******
+oneVPL
+******
 
-**Thank you for using oneAPI Video Processing Library.  Based on developer
-  feedback, we are revising oneVPL to make it even better.  Stay tuned for a new
-  oneVPL.  Thanks again!**
+**Thank you for using oneAPI Video Processing Library.  Based on
+developer feedback, we are revising oneVPL to make it even better.
+Stay tuned for a new oneVPL.  Thanks again!**
 
 The |vpl_full_name| is a programming interface for video processing and video analytics,
 focusing on building portable media pipeline on CPU, GPU, Deep Learning (DL) 
diff --git a/source/versions.rst b/source/versions.rst
@@ -16,29 +16,36 @@ updates.
   ========  ==========  =========
   Version   Date        View                                                                                                            
   ========  ==========  =========
+  `0.8`_    05/29/2020  `HTML <https://spec.oneapi.com/versions/0.8/>`__ `PDF <https://spec.oneapi.com/versions/0.8/oneAPI-spec.pdf>`__
   `0.7`_    03/26/2020  `HTML <https://spec.oneapi.com/versions/0.7/>`__ `PDF <https://spec.oneapi.com/versions/0.7/oneAPI-spec.pdf>`__
   `0.5`_    11/17/2019  `HTML <https://spec.oneapi.com/versions/0.5.0/>`__                                                                
   ========  ==========  =========
 
-Every component has its own version. This table shows the relationship
-between oneAPI version and component versions.
-
-.. table:: Component Versions Table
-	   
-  +---------+------------+--------+--------+--------+--------+--------+--------+--------+--------+
-  | oneAPI  | Level Zero | DPC++  | oneDPL | oneDNN | oneCCL | oneDAL | oneTBB | oneVPL | oneMKL |
-  +=========+============+========+========+========+========+========+========+========+========+
-  | `0.7`_  | .91        | 0.7                                                                   |
-  +---------+------------+--------+--------+--------+--------+--------+--------+--------+--------+
-  | `0.5`_  | 0.5                                                                                |
-  +---------+------------+--------+--------+--------+--------+--------+--------+--------+--------+
-
 Release Notes
 =============
 
+0.8
+---
+
 0.7
 ---
 
+* DPC++: 10 new language extensions including performance features
+  like sub-groups and atomics, as well as features to allow more
+  concise programs.
+* oneDNN: Major restructuring of the document, with high-level
+  introduction to the concepts
+* Level Zero: Updated to 0.91. Open source release of driver
+  implementing the specification
+* oneDAL: Major restructuring of the document, with high-level
+  introduction to the concepts
+* oneVPL: Added support for device selection, context sharing,
+  workstream presets and configurations, video processing and encoding
+  APIs to easily construct a video processing pipeline.
+* oneMKL: Added USM APIs. Major restructuring of document. Added
+  architecture section with overview of execution model, memory model
+  and API design.
+
 0.5
 ---
 

Original file line number	Diff line number	Diff line change
`@@ -31,7 +31,7 @@ def path_relative_to_repo_root(relative_path):`
`31`	`31`	`]`
`32`	`32`
`33`	`33`	`env = {`
`34`		`- 'oneapi_version': '0.7',`
	`34`	`+ 'oneapi_version': '0.8',`
`35`	`35`	`'l0_version': '0.91',`
`36`	`36`	`}`
`37`	`37`