implement ticket 381 with revision history

Changes.log

@@ -23,10 +23,32 @@ Example_SIMD.7f.f
 Example_SIMD.8c.c
 Example_SIMD.8f.f
 
-3. Other changes
+3. Misc modifications to examples (Tickets #180 and #295)
+
+- Use C++ only header for the following C++ specific examples:
+      threadprivate.4c
+      threadprivate.5c
+      pra_iterator.1c
+      declare_target.2c
+
+- Text description change in
+      Examples_lock_owner.tex
+      Examples_default_none.tex
+
+4. Other changes (Ticket #381)
+
+- openmp.sty
+   use mnemonics for example naming
+   added the \cppexample macro
 
 - Move task depedence examples from tasking to a separate chapter.
-   tasking.15-19 -> task_dep.1-5
+    tasking.15-19 -> task_dep.1-5
+
+  Rename chapters:
+    "Tasking Constructs" to "The task and taskwait Constructs"
+    "The taskyield Directive" to "The taskyield Consutrcts"
+
+- Add revision history
 
 - Fix broken links
    -Chap-4 (icv), page 11: "According to $"

Examples_default_none.tex

@@ -4,12 +4,15 @@
 
 The following example distinguishes the variables that are affected by the \code{default(none)} 
 clause from those that are not. 
+
+\ccppspecificstart
 Beginning with OpenMP 4.0, variables with \code{const}-qualified type and no mutable member 
 are no longer predetermined shared.  Thus, these variables (variable \plc{c} in the example) 
 need to be explicitly listed
 in data-sharing attribute clauses when the \code{default(none)} clause is specified.
 
-\cexample{default_none}{1c}
+\cnexample{default_none}{1c}
+\ccppspecificend
 
 \fexample{default_none}{1f}
 

Examples_lock_owner.tex

@@ -12,7 +12,7 @@ This change in ownership requires extra care when using locks. The following pro
 is conforming in OpenMP 2.5 because the thread that releases the lock \code{lck} 
 in the parallel region is the same thread that acquired the lock in the sequential 
 part of the program (master thread of parallel region and the initial thread are 
-the same). However, it is not conforming after OpenMP 2.5, because the task 
+the same). However, it is not conforming beginning with OpenMP 3.0, because the task 
 region that releases the lock \code{lck} is different from the task region that 
 acquires the lock.
 

Examples_tasking.tex

@@ -1,5 +1,5 @@
 \pagebreak
-\chapter{Tasking Constructs}
+\chapter{The \code{task} and \code{taskwait} Constructs}
 \label{chap:tasking}
 
 The following example shows how to traverse a tree-like structure using explicit 

Examples_taskyield.tex

@@ -1,5 +1,5 @@
 \pagebreak
-\chapter{The \code{taskyield} Directive}
+\chapter{The \code{taskyield} Construct}
 \label{chap:taskyield}
 
 The following example illustrates the use of the \code{taskyield}  directive. 

History.tex

@@ -0,0 +1,40 @@
+\chapter{Document Revision History}
+\label{chap:history}
+
+\section{Changes from 4.0.1 to 4.0.2}
+
+\begin{itemize}
+\item Names of examples were changed from numbers to mnemonics
+\item Added SIMD examples (\specref{chap:SIMD})
+\item Applied miscellaneous fixes in several source codes
+\item Added the revision history
+\end{itemize}
+
+\section{Changes from 4.0 to 4.0.1}
+
+Added the following new examples:
+\begin{itemize}
+\item the \code{proc\_bind} clause (\specref{chap:affinity})
+\item the \code{taskgroup} construct (\specref{chap:taskgroup})
+\end{itemize}
+
+\section{Changes from 3.1 to 4.0}
+
+Beginning with OpenMP 4.0, examples were placed in a separate document
+from the specification document.
+
+Version 4.0 added the following new examples:
+\begin{itemize}
+\item task dependences (\specref{chap:task_dep})
+\item cancellation constructs (\specref{chap:cancellation})
+\item \code{target} construct (\specref{chap:target})
+\item \code{target} \code{data} construct (\specref{chap:target_data})
+\item \code{target} \code{update} construct (\specref{chap:target_update})
+\item \code{declare} \code{target} construct (\specref{chap:declare_target})
+\item \code{teams} constructs (\specref{chap:teams})
+\item asynchronous execution of a \code{target} region using tasks
+ (\specref{chap:async_target})
+\item array sections in device constructs (\specref{chap:array_sections})
+\item device runtime routines (\specref{chap:device})
+\item Fortran ASSOCIATE construct (\specref{chap:associate})
+\end{itemize}

Makefile

@@ -67,7 +67,8 @@ CHAPTERS=Title_Page.tex \
 	Examples_async_target.tex \
 	Examples_array_sections.tex \
 	Examples_device.tex \
-	Examples_associate.tex
+	Examples_associate.tex \
+	History.tex
 
 INTERMEDIATE_FILES=openmp-examples.pdf \
 		openmp-examples.toc \

README

@@ -53,10 +53,10 @@ For a brief revision history, please see Changes.log.
    \fnexample{<ename>}{<seq-no>f}
 
 - Language h-rules
-   \cspecificbegin, \cspecificend
+   \cspecificstart, \cspecificend
-   \cppspecificbegin, \cppspecificend
+   \cppspecificstart, \cppspecificend
-   \ccppspecificbegin, \ccppspecificend
+   \ccppspecificstart, \ccppspecificend
-   \fortranspecificbegin, \fortranspecificend
+   \fortranspecificstart, \fortranspecificend
 
 - See openmp.sty for more information
 

Title_Page.tex

@@ -17,7 +17,7 @@
 
       \vspace{1.0in}
 
-      \textbf{Version 4.0.2rv1 -- February, 2015}
+      \textbf{Version 4.0.2rv3 -- February, 2015}
     \end{center}
     \end{adjustwidth}
 
@@ -39,6 +39,7 @@ permission of OpenMP Architecture Review Board.\end{adjustwidth}
 \phantom{a}
 \emph{This page intentionally left blank}
 
-This working version enacted the following tickets: 299, 342, and a few other editorial changes.
+This working version enacted the following tickets: 180, 295, 299, 342, 381, 
+and a few other editorial changes.
 \vfill
 

openmp-examples.tex

@@ -135,5 +135,6 @@
     \input{Examples_array_sections}
     \input{Examples_device}
     \input{Examples_associate}
+    \input{History}
 \end{document}