On Mon, Sep 06, 2021 at 06:48:25PM +0200, Tobias Burnus wrote:
> Hi Jakub, hi all,
>
> as the issue came up from time to time, I thought it
> makes sense to add an implementation status.
>
> I settled on putting it into libgomp.texi instead of
> a webpage or another location.
>
> The 5.1 section should be fine – except for additional
> items. OpenMP 5.0 has stub wordings and needs to be filled.
> The version in the patch should be sufficient for now
> but it would be nice to have it completed before GCC 12.
> (Or even before the BoF in two weeks or OpenMP Con in
> a week, hmm.)
>
> OK? Comments? Typo/wording fixes?
>
> Tobias
>
> PS: Besides the OpenMP implementation status, also:
> * implementation details/choices could be added.
> * some hints regarding tricks & tips related to OpenMP
> and in particular offloading
> (e.g. -foffload-options=-latomic might be needed for nvptx*)
> * user-friendlier documentation how to build the offload compiler.
> (The offloading wiki page has too many internals and
> lacks a step-by-step guide.)
> Not all should be in libgomp.texi, however.
>
> (* Side note: it is mentioned indirectly: as example in
> https://gcc.gnu.org/onlinedocs/gcc/C-Dialect-Options.html#index-foffload )
>
> Currently, the OpenMP/offloading documentation is spread over:
>
> * libgomp: https://gcc.gnu.org/onlinedocs/libgomp/
> * gcc: https://gcc.gnu.org/onlinedocs/gcc/
> flags (-fopenmp(-simd), -foffload(-options=), ...)
> * gfortran: OpenMP + OpenMP Modules omp_lib and omp_lib_kinds
> (and likewise for OpenACC) https://gcc.gnu.org/onlinedocs/gfortran/
> * Project page: https://gcc.gnu.org/projects/gomp/
> * Wiki page: https://gcc.gnu.org/wiki/openmp
> (likewise: https://gcc.gnu.org/wiki/OpenACC
> and also: https://gcc.gnu.org/wiki/OpenACC/Implementation%20Status )
> * Offloading: https://gcc.gnu.org/wiki/Offloading
> plus https://gcc.gnu.org/wiki/nvptx
> plus configure-time options at https://gcc.gnu.org/install/configure.html
>
> -----------------
> Siemens Electronic Design Automation GmbH; Anschrift: Arnulfstraße 201, 80634
> München; Gesellschaft mit beschränkter Haftung; Geschäftsführer: Thomas
> Heurung, Frank Thürauf; Sitz der Gesellschaft: München; Registergericht
> München, HRB 106955
> libgomp.texi: Add OpenMP Implementation Status
>
> libgomp/
> * libgomp.texi (Enabling OpenMP): Refer to OMP spec in general
> not to 4.5; link to new section.
> (OpenMP Implementation Status): New.
Ok. I'll try to provide the 5.0 implementation status soon.
Jakub
