mirror of
https://github.com/OpenMP/Examples.git
synced 2025-04-04 05:41:33 +01:00
282 lines
10 KiB
TeX
282 lines
10 KiB
TeX
\cchapter{Feature Deprecations and Updates in Examples}{deprecated_features}
|
|
\label{chap:deprecated_features}
|
|
\label{sec:deprecated_features}
|
|
\index{deprecated features}
|
|
|
|
Deprecation of features began in OpenMP 5.0.
|
|
Examples that use a deprecated feature have been updated with an equivalent
|
|
replacement feature.
|
|
|
|
Table~\ref{tab:Deprecated Features} summarizes deprecated features and
|
|
their replacements in each version. Affected examples are updated
|
|
accordingly and listed in Section~\ref{sec:Updated Examples}.
|
|
|
|
\nolinenumbers
|
|
\renewcommand{\arraystretch}{1.4}
|
|
\tablefirsthead{%
|
|
\hline
|
|
\textbf{Version} & \textbf{Deprecated Feature} & \textbf{Replacement}\\
|
|
\hline\\[-3.5ex]
|
|
}
|
|
\tablehead{%
|
|
\multicolumn{2}{l}{\small\slshape table continued from previous page}\\
|
|
\hline
|
|
\textbf{Version} & \textbf{Deprecated Feature} & \textbf{Replacement}\\
|
|
\hline\\[-3ex]
|
|
}
|
|
\tabletail{%
|
|
\hline\\[-4ex]
|
|
\multicolumn{2}{l}{\small\slshape table continued on next page}\\
|
|
}
|
|
\tablelasttail{\hline\\[-2ex]}
|
|
\tablecaption{Deprecated Features and Their Replacements\label{tab:Deprecated Features}}
|
|
\begin{supertabular}{p{0.4in} p{2.3in} p{2.2in}}
|
|
5.2 & \scode{default} clause on metadirectives
|
|
& \scode{otherwise} clause \\
|
|
5.2 & delimited \scode{declare}~\scode{target} directive for C/C++
|
|
& \scode{begin}~\scode{declare}~\scode{target} directive \\
|
|
5.2 & \scode{to} clause on \scode{declare}~\scode{target} directive
|
|
& \scode{enter} clause \\
|
|
5.2 & non-argument \scode{destroy} clause on \scode{depobj} construct
|
|
& \scode{destroy(}\plc{argument}\code{)} \\
|
|
5.2 & \scode{allocate} construct for Fortran \scode{ALLOCATE} statements
|
|
& \scode{allocators} construct \\
|
|
5.2 & \scode{depend} clause on \scode{ordered} construct
|
|
& \scode{doacross} clause \\
|
|
5.2 & \scode{linear(}\plc{modifier(list): linear-step}\code{)} clause
|
|
& \scode{linear(}\plc{list:}~\scode{step(}\plc{linear-step}\scode{)}\plc{, modifier}\scode{)} clause \\
|
|
\hline
|
|
5.1 & \scode{master} construct
|
|
& \scode{masked} construct \\
|
|
5.1 & \scode{master} affinity policy
|
|
& \scode{primary} affinity policy \\
|
|
\hline
|
|
5.0 & \scode{omp_lock_hint_*} constants
|
|
& \scode{omp_sync_hint_*} constants \\[2pt]
|
|
\end{supertabular}
|
|
|
|
\linenumbers
|
|
These replacements appear in examples that illustrate, otherwise, earlier features.
|
|
When using a compiler that is compliant with a version prior to
|
|
the indicated version, the earlier form of an example for a previous
|
|
version is listed as a reference.
|
|
|
|
\newpage
|
|
\section{Updated Examples for Different Versions}
|
|
\label{sec:Updated Examples}
|
|
|
|
The following tables list the updated examples for different versions as
|
|
a result of feature deprecation. The \emph{Earlier Version} column of
|
|
the tables shows the version tag of the earlier version. It also shows
|
|
the prior name of an example when it has been renamed.
|
|
|
|
Table~\ref{tab:Updated Examples 5.2} lists the updated examples for OpenMP 5.2
|
|
in the Examples Document Version
|
|
\href{https://github.com/OpenMP/Examples/tree/v5.2}{5.2}.
|
|
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.1}{5.1}.
|
|
|
|
\index{clauses!default@\code{default}}
|
|
\index{clauses!otherwise@\code{otherwise}}
|
|
\index{clauses!to@\code{to}}
|
|
\index{clauses!enter@\code{enter}}
|
|
\index{clauses!depend@\code{depend}}
|
|
\index{clauses!doacross@\code{doacross}}
|
|
\index{clauses!linear@\code{linear}}
|
|
\index{clauses!destroy@\code{destroy}}
|
|
\index{default clause@\code{default} clause}
|
|
\index{otherwise clause@\code{otherwise} clause}
|
|
\index{to clause@\code{to} clause}
|
|
\index{enter clause@\code{enter} clause}
|
|
\index{depend clause@\code{depend} clause}
|
|
\index{doacross clause@\code{doacross} clause}
|
|
\index{linear clause@\code{linear} clause}
|
|
\index{destroy clause@\code{destroy} clause}
|
|
\index{directives!begin declare target@\code{begin}~\code{declare}~\code{target}}
|
|
\index{begin declare target directive@\code{begin}~\code{declare}~\code{target} directive}
|
|
\index{allocate construct@\code{allocate} construct}
|
|
\index{allocators construct@\code{allocators} construct}
|
|
|
|
\nolinenumbers
|
|
\renewcommand{\arraystretch}{1.0}
|
|
\tablefirsthead{%
|
|
\hline\\[-2ex]
|
|
\textbf{Example Name} & \textbf{Earlier Version} & \textbf{Feature Updated}
|
|
\\[2pt]
|
|
\hline\\[-2ex]
|
|
}
|
|
\tablehead{%
|
|
\multicolumn{2}{l}{\small\slshape table continued from previous page}\\[2pt]
|
|
\hline\\[-2ex]
|
|
\textbf{Example Name} & \textbf{Earlier Version} & \textbf{Feature Updated}\\[2pt]
|
|
\hline\\[-2ex]
|
|
}
|
|
\tabletail{%
|
|
\hline\\[-2.5ex]
|
|
\multicolumn{2}{l}{\small\slshape table continued on next page}\\
|
|
}
|
|
\tablelasttail{\hline\\[-1ex]}
|
|
\tablecaption{Updated Examples for Version 5.2\label{tab:Updated Examples 5.2}}
|
|
\begin{supertabular}{p{1.7in} p{1.2in} p{2.1in}}
|
|
\hexentry{error.1}[f90]{5.1} &
|
|
\scode{default} clause on metadirectives \\
|
|
\hexentry{metadirective.1}[f90]{5.0} &
|
|
replaced with \scode{otherwise} clause \\
|
|
\hexentry{metadirective.2}[f90]{5.0} & \\
|
|
\hexentry{metadirective.3}[f90]{5.0} & \\
|
|
\hexentry{metadirective.4}[f90]{5.1} & \\
|
|
\hexentry{target_ptr_map.4}{5.1} & \\
|
|
\hexentry{target_ptr_map.5}[f90]{5.1} & \\[2pt]
|
|
\hline\\[-2ex]
|
|
\hexentry[f90]{array_shaping.1}{5.0} &
|
|
\scode{to} clause on \scode{declare} \scode{target} \\
|
|
\hexentry{target_reverse_offload.7}{5.0} &
|
|
directive replaced with \scode{enter} clause \\
|
|
\hexentry{target_task_reduction.1}[f90]{5.1} & \\
|
|
\hexentry{target_task_reduction.2a}[f90]{5.0} & \\
|
|
\hexentry{target_task_reduction.2b}[f90]{5.1} &\\[2pt]
|
|
\hline\\[-2ex]
|
|
\hexentry{array_shaping.1}{5.0} &
|
|
delimited \scode{declare}~\scode{target} \\
|
|
\hexentry{async_target.1}{4.0} &
|
|
directive replaced with \\
|
|
\hexentry{async_target.2}{4.0} &
|
|
\scode{begin}~\scode{declare}~\scode{target} \\
|
|
\hexentry{declare_target.1}{4.0} &
|
|
directive for C/C++ \\
|
|
\hexentry[cpp]{declare_target.2c}{4.0} & \\
|
|
\hexentry{declare_target.3}{4.0} & \\
|
|
\hexentry{declare_target.4}{4.0} & \\
|
|
\hexentry{declare_target.5}{4.0} & \\
|
|
\hexentry{declare_target.6}{4.0} & \\
|
|
\hexentry{declare_variant.1}{5.0} & \\
|
|
\hexentry{device.1}{4.0} & \\
|
|
\hexentry{metadirective.3}{5.0} & \\
|
|
\hexentry{target_ptr_map.2}{5.0} & \\
|
|
\hexentry{target_ptr_map.3a}{5.0} & \\
|
|
\hexentry{target_ptr_map.3b}{5.0} & \\
|
|
\hexentry{target_struct_map.1}{5.0} & \\
|
|
\hexentry[cpp]{target_struct_map.2}{5.0} & \\
|
|
\hexentry{target_struct_map.3}{5.0} & \\
|
|
\hexentry{target_struct_map.4}{5.0} & \\[2pt]
|
|
\hline\\[-2ex]
|
|
\hexentry{doacross.1}[f90]{4.5} &
|
|
\scode{depend} clause on \scode{ordered} \\
|
|
\hexentry{doacross.2}[f90]{4.5} &
|
|
construct replaced with \scode{doacross} \\
|
|
\hexentry{doacross.3}[f90]{4.5} &
|
|
clause \\
|
|
\hexentry{doacross.4}[f90]{4.5} & \\[2pt]
|
|
\hline\\[-2ex]
|
|
\hexentry[cpp]{linear_modifier.1}[f90]{4.5} &
|
|
modifier syntax change for \scode{linear} \\
|
|
\hexentry[cpp]{linear_modifier.2}[f90]{4.5} &
|
|
clause on \scode{declare}~\scode{simd} directive \\
|
|
\hexentry{linear_modifier.3}[f90]{4.5} & \\[2pt]
|
|
\hline\\[-2ex]
|
|
\hexentry[f90]{allocators.1}{5.0} &
|
|
\scode{allocate} construct replaced with \scode{allocators} construct
|
|
for Fortran allocate statements \\[2pt]
|
|
\hline\\[-2ex]
|
|
\hexentry{depobj.1}[f90]{5.0} &
|
|
argument added to \scode{destroy} clause on \scode{depobj}
|
|
construct \\[2pt]
|
|
\end{supertabular}
|
|
|
|
\linenumbers
|
|
Table~\ref{tab:Updated Examples 5.1} lists the updated examples for OpenMP 5.1
|
|
in the Examples Document Version
|
|
\href{https://github.com/OpenMP/Examples/tree/v5.1}{5.1}.
|
|
The \emph{Earlier Version} column of the table lists the earlier version
|
|
tags and prior names of the examples that can be found in
|
|
the Examples Document Version
|
|
\href{https://github.com/OpenMP/Examples/tree/v5.0.1}{5.0.1}.
|
|
|
|
\index{affinity!master policy@\code{master} policy}
|
|
\index{affinity!primary policy@\code{primary} policy}
|
|
\index{constructs!master@\code{master}}
|
|
\index{constructs!masked@\code{masked}}
|
|
\index{master construct@\code{master} construct}
|
|
\index{masked construct@\code{masked} construct}
|
|
|
|
\nolinenumbers
|
|
\renewcommand{\arraystretch}{1.0}
|
|
\tablefirsthead{%
|
|
\hline\\[-2ex]
|
|
\textbf{Example Name} & \textbf{Earlier Version} & \textbf{Feature Updated}
|
|
\\[2pt]
|
|
\hline\\[-2ex]
|
|
}
|
|
\tablehead{%
|
|
\multicolumn{2}{l}{\small\slshape table continued from previous page}\\[2pt]
|
|
\hline\\[-2ex]
|
|
\textbf{Example Name} & \textbf{Earlier Version} & \textbf{Feature Updated}\\[2pt]
|
|
\hline\\[-2ex]
|
|
}
|
|
\tabletail{%
|
|
\hline\\[-2.5ex]
|
|
\multicolumn{2}{l}{\small\slshape table continued on next page}\\
|
|
}
|
|
\tablelasttail{\hline\\[-1ex]}
|
|
\tablecaption{Updated Examples for Version 5.1\label{tab:Updated Examples 5.1}}
|
|
\begin{supertabular}{p{1.8in} p{1.4in} p{1.8in}}
|
|
\hexentry{affinity.5}[f]{4.0} &
|
|
\scode{master} affinity policy replaced with \scode{primary} policy \\[2pt]
|
|
\hline\\[-2ex]
|
|
\hexentry{async_target.3}[f90]{5.0} &
|
|
\scode{master} construct replaced \\
|
|
\hexentry{cancellation.2}[f90]{4.0} &
|
|
with \scode{masked} construct \\
|
|
\hexentry{copyprivate.2}[f]{3.0} & \\
|
|
\hexentry[f]{fort_sa_private.5}{3.0} & \\
|
|
\hexentry{lock_owner.1}[f]{3.0} & \\
|
|
\hexmentry{masked.1}[f]{3.0}{master.1} & \\
|
|
\hexmentry{parallel_masked_taskloop.1}[f90]{5.0}{parallel_master_taskloop.1} &\\
|
|
\hexentry{reduction.6}[f]{3.0} & \\
|
|
\hexentry{target_task_reduction.1}[f90]{5.0} & \\
|
|
\hexentry{target_task_reduction.2b}[f90]{5.0} & \\
|
|
\hexentry{taskloop_simd_reduction.1}[f90]{5.0} & \\
|
|
\hexentry{task_detach.1}[f90]{5.0} & \\[2pt]
|
|
\end{supertabular}
|
|
|
|
\linenumbers
|
|
Table~\ref{tab:Updated Examples 5.0} lists the updated examples for OpenMP 5.0
|
|
in the Examples Document Version
|
|
\href{https://github.com/OpenMP/Examples/tree/v5.1}{5.1}.
|
|
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.0.1}{5.0.1}.
|
|
|
|
\nolinenumbers
|
|
\renewcommand{\arraystretch}{1.0}
|
|
\tablefirsthead{%
|
|
\hline\\[-2ex]
|
|
\textbf{Example Name} & \textbf{Earlier Version} & \textbf{Feature Updated}
|
|
\\[2pt]
|
|
\hline\\[-2ex]
|
|
}
|
|
\tablehead{%
|
|
\multicolumn{2}{l}{\small\slshape table continued from previous page}\\[2pt]
|
|
\hline\\[-2ex]
|
|
\textbf{Example Name} & \textbf{Earlier Version} & \textbf{Feature Updated}\\[2pt]
|
|
\hline\\[-2ex]
|
|
}
|
|
\tabletail{%
|
|
\hline\\[-2.5ex]
|
|
\multicolumn{2}{l}{\small\slshape table continued on next page}\\
|
|
}
|
|
\tablelasttail{\hline\\[-1ex]}
|
|
\tablecaption{Updated Examples for Version 5.0\label{tab:Updated Examples 5.0}}
|
|
\begin{supertabular}{p{1.6in} p{1.3in} p{2.1in}}
|
|
\hexentry{critical.2}[f]{4.5} &
|
|
\scode{omp_lock_hint_*} constants \\
|
|
\hexentry[cpp]{init_lock_with_hint.1}[f]{4.5} &
|
|
replaced with \scode{omp_sync_hint_*} constants \\[2pt]
|
|
\end{supertabular}
|
|
|
|
\linenumbers
|
|
|