[gcc/devel/omp/gcc-12] libgomp.texi: Document OpenMP context selectors

[gcc/devel/omp/gcc-12] libgomp.texi: Document OpenMP context selectors

[Tobias Burnus]

https://gcc.gnu.org/g:bf4e0a66d0027fc20f216afc8e84d8ae35baf0ca

commit bf4e0a66d0027fc20f216afc8e84d8ae35baf0ca
Author: Tobias Burnus <tobias@codesourcery.com>
Date:   Mon Jul 4 21:45:43 2022 +0200

    libgomp.texi: Document OpenMP context selectors
    
    libgomp/
            * libgomp.texi (Offload-Target Specifics): New chapter; add section
            to document OpenMP context selectors.
    
    (cherry picked from commit 61fe7b7d463f2f6bbeb175c345a68b844b396d56)

Diff:
---
 libgomp/ChangeLog.omp |  8 ++++++++
 libgomp/libgomp.texi  | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 40 insertions(+)

diff --git a/libgomp/ChangeLog.omp b/libgomp/ChangeLog.omp
index 5e1997de255..be874675d35 100644
--- a/libgomp/ChangeLog.omp
+++ b/libgomp/ChangeLog.omp
@@ -1,3 +1,11 @@
+2022-07-04  Tobias Burnus  <tobias@codesourcery.com>
+
+	Backport from mainline:
+	2022-05-17  Tobias Burnus  <tobias@codesourcery.com>
+
+	* libgomp.texi (Offload-Target Specifics): New chapter; add section
+	to document OpenMP context selectors.
+
 2022-07-04  Tobias Burnus  <tobias@codesourcery.com>
 
 	Backport from mainline:
diff --git a/libgomp/libgomp.texi b/libgomp/libgomp.texi
index 4c25da345a6..93b9523a662 100644
--- a/libgomp/libgomp.texi
+++ b/libgomp/libgomp.texi
@@ -113,6 +113,7 @@ changed to GNU Offloading and Multi Processing Runtime Library.
 * OpenACC Library Interoperability:: OpenACC library interoperability with the
                                NVIDIA CUBLAS library.
 * OpenACC Profiling Interface::
+* Offload-Target Specifics::   Notes on offload-target specific internals
 * The libgomp ABI::            Notes on the external ABI presented by libgomp.
 * Reporting Bugs::             How to report bugs in the GNU Offloading and
                                Multi Processing Runtime Library.
@@ -4249,6 +4250,37 @@ offloading devices (it's not clear if they should be):
 @item @code{acc_memcpy_from_device}, @code{acc_memcpy_from_device_async}
 @end itemize
 
+@c ---------------------------------------------------------------------
+@c Offload-Target Specifics
+@c ---------------------------------------------------------------------
+
+@node Offload-Target Specifics
+@chapter Offload-Target Specifics
+
+The following sections present notes on the offload-target specifics.
+
+@menu
+* OpenMP Context Selectors::
+@end menu
+
+@node OpenMP Context Selectors
+@section OpenMP Context Selectors
+
+@code{vendor} is always @code{gnu}. References are to the GCC manual.
+
+@multitable @columnfractions .60 .10 .25
+@headitem @code{arch} @tab @code{kind} @tab @code{isa}
+@item @code{intel_mic}, @code{x86}, @code{x86_64}, @code{i386}, @code{i486},
+      @code{i586}, @code{i686}, @code{ia32}
+      @tab @code{host}
+      @tab See @code{-m...} flags in ``x86 Options'' (without @code{-m})
+@item @code{amdgcn} @code{gcn}
+      @tab @code{gpu}
+      @tab See @code{-march=} in ``AMD GCN Options''
+@item @code{nvptx}
+      @tab @code{gpu}
+      @tab See @code{-misa=} in ``Nvidia PTX Options''
+@end multitable
 
 
 @c ---------------------------------------------------------------------