[C++ for OpenCL] Added references section. (#518)

* [C++ for OpenCL] Added references section.

The document is updated to cite the references where needed.

Author: AnastasiaStulova

CXX_for_OpenCL.txt

@@ -48,5 +48,9 @@ include::cxx4opencl/address_spaces.txt[]
 
 <<<
 
+include::cxx4opencl/references.txt[]
+
+<<<
+
 include::cxx4opencl/acknowledgements.txt[]
 

cxx4opencl/address_spaces.txt

@@ -10,8 +10,8 @@
 This section only documents behavior related to {cpp} features. For example
 conversion rules are extended from the qualification conversion {cpp}17
 `[conv.qual]` but the compatibility is determined using notation of sets and
-overlapping of address spaces from Embedded C
-(`ISO/IEC JTC1 SC22 WG14 N1021 s3.1.3`). For OpenCL it means that implicit
+overlapping of address spaces from `section 5.1.3` of <<embedded-c-spec,
+The Embedded C Specification>>. For OpenCL it means that implicit
 conversions are allowed from a named address space (except for `+__constant+`)
 to generic (`OpenCL C v2.0 6.5.5`). The reverse conversion is only allowed
 explicitly. The `+__constant+` address space does not overlap with any other
@@ -60,7 +60,7 @@ rules from address space pointer conversion (`OpenCL v2.0 s6.5.5`).
 
 This section details what happens if address spaces for types are not
 provided in the source code explicitly. Most of the logic for address space
-deduction (i.e. default address space) follows rules from `OpenCL 2.0 s6.5`.
+deduction (i.e. default address space) follows rules from `OpenCL v2.0 s6.5`.
 
 References inherit rules from pointers and therefore refer to generic
 address space objects by default (see <<references, _References_>>).

cxx4opencl/intro.txt

@@ -10,29 +10,31 @@ most of regular {cpp} features in OpenCL kernel code. Most functionality
 from {cpp} and OpenCL C is inherited. Since both OpenCL C and {cpp} are
 derived from C and moreover {cpp} is almost fully backward compatible with C,
 the main design principle of {cpp} for OpenCL is to reapply existing OpenCL
-concepts to {cpp}. Therefore, it is important to refer to OpenCL v2.0 section
-3.2 and section 3.3 detailing fundamental differences of OpenCL execution and
-memory models from the conventional C and {cpp} view.
+concepts to {cpp}. Therefore, it is important to refer to
+<<opencl-spec, The OpenCL Specification, Version 2.0>> `section
+3.2` and `section 3.3` detailing fundamental differences of OpenCL execution
+and memory models from the conventional C and {cpp} view.
 
 This document describes the programming language in details. It is not
-structured as a standalone document, but rather as an addition to `OpenCL C
-v2.0 s6` and {cpp}17 (`ISO/IEC 14882:2017`). Where necessary this document
-refers to the specifications of those languages accordingly. A full
-understanding of {cpp} for OpenCL requires familiarity with the
+structured as a standalone document, but rather as an addition to OpenCL C
+v2.0 defined in <<openclc-spec, The OpenCL C Specification, Version 2.0>>
+and {cpp}17 defined in <<cpp17-spec, The C++17 Specification>>. Where necessary
+this document refers to the specifications of those languages accordingly.
+A full understanding of {cpp} for OpenCL requires familiarity with the
 specifications or other documentation of both languages that {cpp} for OpenCL
 is built upon.
 
 The description of {cpp} for OpenCL starts from highlighting <<diff2openclc,
 _the differences to OpenCL C_>> and <<diff2cxx, _the differences to {cpp}_>>.
 
 The majority of content covers the behavior that is not documented in
-the OpenCL C v2.0 section 6 and {cpp}17 specifications. This is mainly
+the OpenCL C v2.0 `section 6` and {cpp}17 specifications. This is mainly
 related to interactions between OpenCL and {cpp} language features.
 
 == The {cpp} for OpenCL Programming Language 
 
-This programming language inherits features from `OpenCL C v2.0 s6` as well
-as {cpp}17 (`ISO/IEC 14882:2017`). Detailed aspects of OpenCL and {cpp} are not
+This programming language inherits features from `OpenCL C v2.0,
+s6` as well as {cpp}17. Detailed aspects of OpenCL and {cpp} are not
 described in this document as they can be found in their official
 specifications.
 

cxx4opencl/references.txt

@@ -0,0 +1,19 @@
+// Copyright 2019-2020 The Khronos Group. This work is licensed under a
+// Creative Commons Attribution 4.0 International License; see
+// http://creativecommons.org/licenses/by/4.0/
+
+== Normative References
+
+   . [[opencl-spec]] "`The OpenCL Specification, Version 2.0`",
+     https://www.khronos.org/registry/OpenCL/.
+   . [[openclc-spec]] "`The OpenCL C Specification, Version 2.0`",
+     https://www.khronos.org/registry/OpenCL/.
+   . [[cpp17-spec]] "`ISO/IEC 14882:2017 - Programming languages — {CPP}`",
+     https://www.iso.org/standard/68564.html.
+     References are to sections of this specific version, referred to as the
+     "`The C++17 Specification`", although other versions exist.
+   . [[embedded-c-spec]] "`ISO/IEC TR 18037:2008 Programming languages -
+     C - Extensions to support embedded processors`",
+     https://www.iso.org/standard/51126.html.
+     References are to sections of this specific version, referred to as the
+     "`The Embedded C Specification`", although other versions exist.