v6.0 release

Author: Henry Jin

Chap_data_environment.tex

@@ -86,6 +86,7 @@
 \input{data_environment/lastprivate}
 \input{data_environment/reduction}
 \input{data_environment/udr}
+\input{data_environment/induction}
 \input{data_environment/scan}
 \input{data_environment/copyin}
 \input{data_environment/copyprivate}

Chap_devices.tex

@@ -73,5 +73,7 @@
 \input{devices/async_target_with_tasks}
 \input{devices/async_target_nowait}
 \input{devices/async_target_nowait_depend}
+\input{devices/async_target_nowait_arg}
 \input{devices/device}
+\input{devices/device_env_traits}
 

Chap_directives.tex

@@ -3,8 +3,8 @@
 \index{directive syntax}
 
 OpenMP \plc{directives} use base-language mechanisms to specify OpenMP program behavior.
-In C code, the directives are formed exclusively with pragmas, whereas in C++
-code, directives are formed from either pragmas or attributes.
+In C/C++ code, the directives are formed with 
+either pragmas or attributes.
 Fortran directives are formed with comments in free form and fixed form sources (codes).
 All of these mechanisms allow the compilation to ignore the OpenMP directives if
 OpenMP is not supported or enabled.
@@ -20,18 +20,27 @@
 
 C/C++ pragmas
 \begin{indentedcodelist}
-\kcode{\#pragma omp} \plc{directive-specification}
+#pragma omp \plc{directive-specification}
 \end{indentedcodelist}
 
-C++ attributes
+C/C++ attribute specifiers
 \begin{indentedcodelist}
-\kcode{[[omp :: directive( \plc{directive-specification} )]]}
-\kcode{[[using omp : directive( \plc{directive-specification} )]]}
+[[omp :: directive( \plc{directive-specification} )]]
+[[omp :: decl( \plc{directive-specification} )]]
 \end{indentedcodelist}
 
+C++ attribute specifiers
+\begin{indentedcodelist}
+[[using omp : directive( \plc{directive-specification} )]]
+[[using omp : decl( \plc{directive-specification} )]]
+\end{indentedcodelist}
+
+where the \kcode{decl} attribute may be used for declarative
+directives alternatively.
+
 Fortran comments
 \begin{indentedcodelist}
-\scode{!$omp} \plc{directive-specification}
+!$omp \plc{directive-specification}
 \end{indentedcodelist}
 
 where \scode{c$omp} and \scode{*$omp} may be used in Fortran fixed form sources.

Chap_loop_transformations.tex

@@ -21,6 +21,7 @@
 
 %===== Examples Sections =====
 \input{loop_transformations/tile}
-\input{loop_transformations/unroll}
 \input{loop_transformations/partial_tile}
+\input{loop_transformations/unroll}
+\input{loop_transformations/apply}
 

Chap_program_control.tex

@@ -105,6 +105,7 @@
 \input{program_control/cancellation}
 \input{program_control/requires}
 \input{program_control/context_based_variants}
+\input{program_control/dispatch}
 \input{program_control/nested_loop}
 \input{program_control/nesting_restrict}
 \input{program_control/target_offload}

Chap_tasking.tex

@@ -59,4 +59,5 @@
 \input{tasking/taskyield}
 \input{tasking/taskloop}
 \input{tasking/parallel_masked_taskloop}
+\input{tasking/taskloop_dep}
 

Contributions.md

@@ -158,9 +158,19 @@ The following describes LaTeX macros defined specifically for examples.
    \cppspecificstart, \cppspecificend
    \ccppspecificstart, \ccppspecificend
    \fortranspecificstart, \fortranspecificend
+   \begin{cspecific}[s] ... \end{cspecific}
+   \begin{cppspecific}[s] ... \end{cppspecific}
+   \begin{ccppspecific}[s] ... \end{ccppspecific}
+   \begin{fortranspecific}[s] ... \end{fortranspecific}
    \topmarker{Lang}
 ```
 
+   Use of the structured `\begin{} .. \end{}` environments is the preferred 
+   way of specifying language-dependent text over the unstructured approach
+   of using `\*specificstart` and `\*specificend`.
+   The option `[s]` to each of the environments can specify a vertical shift 
+   for the beginning rule, such as when followed by a section header.
+
    The macro `\topmarker` puts a dashed blue line floater at top of a page for 
    "Lang (cont.)" where `Lang` can be `C/C++`, `C++`, `Fortran`.
 

Deprecated_Features.tex

@@ -58,6 +58,9 @@
 \tablelasttail{\hline\\[-2ex]}
 \tablecaption{Deprecated Features and Their Replacements\label{tab:Deprecated Features}}
 \begin{supertabular}{p{0.4in} p{2.3in} p{2.2in}}
+6.0 & \kcode{declare reduction(}\plc{reduction-id}: \plc{typename-list}: \plc{combiner}\kcode{)} 
+    & \kcode{declare reduction(}\plc{reduction-id}: \plc{typename-list}\kcode{)} \kcode{combiner(\plc{combiner-exp})} \\ 
+\hline
 5.2 & \kcode{default} clause on metadirectives 
     & \kcode{otherwise} clause \\
 5.2 & delimited \kcode{declare target} directive for C/C++ 
@@ -98,6 +101,32 @@ \section{Updated Examples for Different Versions}
 the prior name of an example when it has been renamed.
 
 
+Table~\ref{tab:Updated Examples 6.0} lists the updated examples for 
+features deprecated in OpenMP 6.0
+in the Examples Document Version
+\href{https://github.com/OpenMP/Examples/tree/v6.0}{6.0}.
+The \emph{Earlier Version} column of the table lists the earlier version
+tags of the examples that can be found in 
+the Examples Document Version 
+\href{https://github.com/OpenMP/Examples/tree/v5.2}{5.2}.
+
+\index{clauses!combiner@\kcode{combiner}}
+\index{combiner clause@\kcode{combiner} clause}
+
+\nolinenumbers
+\dpftable{6.0}
+\begin{supertabular}{p{1.7in} p{1.1in} p{2.2in}}
+  \hexentry{udr.1}[f90]{4.0} &
+    \plc{combiner} expression in \kcode{declare} \\
+  \hexentry{udr.2}[f90]{4.0} & 
+    \kcode{reduction} directive changed to use \\
+  \hexentry{udr.3}[f90]{4.0} & \kcode{combiner} clause \\
+  \hexentry[f90]{udr.4}{4.0} & \\
+  \hexentry[cpp]{udr.5}{4.0} & \\
+  \hexentry[cpp]{udr.6}{4.0} & \\[2pt]
+\end{supertabular}
+
+\linenumbers
 Table~\ref{tab:Updated Examples 5.2} lists the updated examples for
 features deprecated in OpenMP 5.2
 in the Examples Document Version \examplesref{5.2}.
@@ -195,6 +224,7 @@ \section{Updated Examples for Different Versions}
 \end{supertabular}
 
 \linenumbers
+\newpage
 Table~\ref{tab:Updated Examples 5.1} lists the updated examples for
 features deprecated in OpenMP 5.1
 in the Examples Document Version \examplesref{5.1}.

Foreword_Chapt.tex

@@ -2,20 +2,27 @@ \chapter*{Foreword}
 \label{chap:foreword}
 
 The OpenMP Examples document has been updated with new features
-found in the OpenMP \PVER\ Specification. The additional examples and updates
-are referenced in the Document Revision History of the Appendix on page~\pageref{chap:history}.
-
-Text describing an example with a \PVER\ feature specifically states
-that the feature support begins in the OpenMP \PVER\ Specification.  Also,
-an \kcode{\small{}omp_\PVER} keyword is included in the  metadata of the source code.
-
-These distinctions are presented to remind readers that a \PVER\ compliant 
+found in the OpenMP \SVER\ Specification. 
+In order to provide users with new feature examples concurrently
+with the release of the OpenMP 6.0 Specification, 
+the 6.0 Examples document is being released early
+with a caveat that some of the 6.0 features
+(such as \kcode{workdistribute} construct, \kcode{taskgraph} construct,
+\kcode{threadset} clause and free-agent threads) will be covered
+in the next release of the document.
+For a list of the new examples and updates in this release,
+please refer to the Document Revision History of the Appendix on page~\pageref{chap:history}.
+
+Text describing an example with a \SVER\ feature specifically states
+that the feature support begins in the OpenMP \SVER\ Specification.  Also,
+an \kcode{\small{}omp_\SVER} keyword is included in the  metadata of the source code.
+These distinctions are presented to remind readers that a \SVER\ compliant 
 OpenMP implementation is necessary to use these features in codes.
 
-Examples for most of the \PVER\ features are included in this document,
-and incremental releases will become available as more feature examples
+%Examples for most of the \SVER\ features are included in this document,
+%and 
+Incremental releases will become available as more feature examples
 and updates are submitted and approved by the OpenMP Examples Subcommittee.
-
 Examples are accepted for this document after discussions, revisions and reviews
 in the Examples Subcommittee, and two reviews/discussions and two votes
 in the OpenMP Language Committee.

History.tex

@@ -1,6 +1,74 @@
 \cchapter{Document Revision History}{history}
 \label{chap:history}
 
+%=====================================
+\section{Changes from 5.2.2 to 6.0}
+\label{sec:history_522_to_60}
+
+\begin{itemize}
+\item General changes:
+\begin{itemize}
+  \item Added a set of structured LaTeX environments for specifying
+    language-dependent text.  This allows extracting language-specific
+    content of the Examples document.  Refer to the content of
+    \examplesblob{v6.0/Contributions.md} for details.
+\end{itemize}
+
+\item Added the following examples for the 6.0 features:
+\begin{itemize}
+  \item \kcode{omp::decl} attribute for declarative directives in C/C++
+    (\specref{sec:attributes})
+  \item \kcode{transparent} clause on the \kcode{task} construct to enable dependences
+     between non-sibling tasks (\specref{subsec:depend_trans_task})
+  \item Task dependences for \kcode{taskloop} construct
+    (\specref{sec:taskloop_depend})
+  \item \kcode{num_threads} clause that appears inside \kcode{target} region
+    (\specref{subsec:target_teams_num_teams})
+  \item \kcode{nowait} clause with argument on the \kcode{target} construct to control deferment 
+     of target task (\specref{subsec:async_target_nowait_arg})
+  \item Traits for specifying devices (\specref{sec:device_env_traits})
+  \item \kcode{apply} clause with modifier argument to 
+    support selective loop transformations
+    (\specref{sec:apply_clause})
+  \item Reduction on private variables in a \kcode{parallel} region
+    (\specref{subsec:priv_reduction})
+  \item \kcode{induction} clause (\specref{subsec:induction})
+    and user-defined induction (\specref{subsec:user-defined-induction})
+  \item \kcode{init_complete} clause for \kcode{scan} directive to 
+    support initialization phase in scan operation
+    (\specref{sec:scan})
+  \item \kcode{assume} construct with \kcode{no_openmp} and \kcode{no_parallelism} clauses (\specref{sec:assumption})
+  \item \kcode{num_threads} clause with a list
+    (\specref{subsec:icv_nthreads})
+  \item \kcode{dispatch} construct to control variant substitution
+    for a procedure call (\specref{sec:dispatch})
+\end{itemize}
+
+\item Other changes:
+\begin{itemize}
+  \item Changed attribute specifier as a directive form from C++ only to C/C++
+    (\specref{chap:directive_syntax})
+  \item Added missing \bcode{include <omp.h>} in Example \example{atomic.4.c}
+    and \bcode{use omp_lib} in Example \example{atomic.4.f90}
+    (\specref{sec:atomic_hint})
+  \item Fixed the function declaration order for variant functions in
+    Examples \example{selector_scoring.[12].c} and Fortran pointer
+    initialization in Example \example{selector_scoring.2.f90}
+    (\specref{subsec:context_selector_scoring})
+  \item Replaced the deprecated use of \plc{combiner-exp} 
+    in \kcode{declare reduction} directive with \kcode{combiner} clause
+    (\specref{subsec:UDR} and \specref{sec:Updated Examples})
+  \item Fixed the initialization of Fortran pointers 
+    in Example \example{cancellation.2.f90} and changed to
+    use \kcode{atomic write} for performing atomic writes
+    (\specref{sec:cancellation})
+  \item Added missing \kcode{declare target} directive for external procedure
+    called inside \kcode{target} region in Example 
+    \example{requires.1.f90} (\specref{sec:requires})
+\end{itemize}
+
+\end{itemize}
+
 %=====================================
 \section{Changes from 5.2.1 to 5.2.2}
 \label{sec:history_521_to_522}