[OpenCL][8.0.0 Release] Notes for OpenCL

[Anastasia]

docs/ReleaseNotes.rst

14 ↗

(On Diff #187779)

@hans I am not sure if it's best to list all languages supported (i.e. OpenMP, Renderscript, CUDA are still missing) or alternatively we could change to something like - Clang C language family frontend? The latter one is taken from the main page: https://clang.llvm.org/. Although, OpenMP is missing on the main page.

[Anastasia]

docs/ReleaseNotes.rst

14 ↗

(On Diff #187779)

@ABataev should the main page be updated to list OpenMP explicitly?

[ABataev]

docs/ReleaseNotes.rst

14 ↗

(On Diff #187779)

Well, generally speaking, OpenMP is not a programming language, it is an API, i.e. just an extension for C/C++/Fortran. Not sure that it must be in the list of the actual languages.

[Anastasia]

docs/ReleaseNotes.rst

14 ↗

(On Diff #187779)

Ok, then I guess it will be ok to leave it out in this update to the release notes too!

[AlexeySotkin]

docs/ReleaseNotes.rst

228 ↗

(On Diff #187779)

Why the "C" is removed ?

[AlexeySotkin]

docs/ReleaseNotes.rst

228 ↗

(On Diff #187779)

Should we call the section like: "OpenCL Support in Clang"?

[kkwli0]

docs/ReleaseNotes.rst

14 ↗

(On Diff #187779)

I agree with Alexey. OpenMP is an API specification not quite a language yet.

[Anastasia]

docs/ReleaseNotes.rst

228 ↗

(On Diff #187779)

I would like to leave "Changes" in as it described the difference in this release. And I think "Language" should stay to be more precise that this doesn't cover libraries or runtime.

So I was think of either:
OpenCL Kernel Language Change in Clang
or
'OpenCL C/C++ Language Changes in Clang'

I am a bit worried about the last one since it might link to the OpenCL C++ spec... even though it was used in the past release notes... but now that the direction has been changed I am not sure. Any opinion?

[Anastasia]

Updated the section title!

[Anastasia]

docs/ReleaseNotes.rst

228 ↗

(On Diff #187779)

We might need to finalize this quickly. @hans when is the last day to commit this to the release branch?

[hans]

docs/ReleaseNotes.rst

228 ↗

(On Diff #187779)

Within a day or two would be good.

But it looks like it got accepted now. Will you commit to the branch, or would you like me to do it for you?

[Anastasia]

Committed to the release branch r354799.

FYI, I did a couple of formatting changes and typo fixes.

[hans]

Many thanks!

cfe/branches/release_80/docs/ReleaseNotes.rst

 =========================
 Clang 8.0.0 Release Notes
 =========================
 
 .. contents::
    :local:
    :depth: 2
 
 Written by the `LLVM Team <https://llvm.org/>`_
 
 Introduction
 ============
 
-This document contains the release notes for the Clang C/C++/Objective-C
+This document contains the release notes for the Clang C/C++/Objective-C/OpenCL
 frontend, part of the LLVM Compiler Infrastructure, release 8.0.0. Here we
 describe the status of Clang in some detail, including major
 improvements from the previous release and new feature work. For the
 general LLVM release notes, see `the LLVM
 documentation <https://llvm.org/docs/ReleaseNotes.html>`_. All LLVM
 releases may be downloaded from the `LLVM releases web
 site <https://llvm.org/releases/>`_.
 

 
 ...
 
 Objective-C Language Changes in Clang
 -------------------------------------
 
 ...
 
-OpenCL C Language Changes in Clang
-----------------------------------
+OpenCL Kernel Language Changes in Clang
+---------------------------------------
+
+Misc:
+
+- Improved address space support with Clang builtins.
+
+- Improved various diagnostics for vectors with element types from extensions;
+  values used in attributes; duplicate address spaces.
+
+- Allow blocks to capture arrays.
+
+- Allow zero assignment and comparisons between variables of ``queue_t`` type.
+
+- Improved diagnostics of formatting specifiers and argument promotions for
+  vector types in ``printf``.
+
+- Fixed return type of enqueued kernel and pipe builtins.
+
+- Fixed address space of ``clk_event_t`` generated in the IR.
+
+- Fixed address space when passing/returning structs.
+
+Header file fixes:
+
+- Added missing extension guards around several builtin function overloads.
+
+- Fixed serialization support when registering vendor extensions using pragmas.
+
+- Fixed OpenCL version in declarations of builtin functions with sampler-less
+  image accesses.
+
+New vendor extensions added:
+
+- ``cl_intel_planar_yuv``
+
+- ``cl_intel_device_side_avc_motion_estimation``
+
+
+C++ for OpenCL:
+
+- Added support of address space conversions in C style casts.
+
+- Enabled address spaces for references.
+
+- Fixed use of address spaces in templates: address space deduction and diagnostics.
+
+- Changed default address space to work with C++ specific concepts: class members,
+  template parameters, etc.
+
+- Added generic address space by default to the generated hidden 'this' parameter.
+
+- Extend overload ranking rules for address spaces.
 
-...
 
 ABI Changes in Clang
 --------------------
 
 - `_Alignof` and `alignof` now return the ABI alignment of a type, as opposed
   to the preferred alignment.
 
   - This is more in keeping with the language of the standards, as well as