re PR libgomp/30540 (Document default value of implementation-dependent OpenMP settings)

2007-01-29  Daniel Franke <franke.daniel@gmail.com>

        PR libgomp/30540
        * libgomp.texi: More about implementation-dependent settings.

From-SVN: r121360

2 files changed, 32 insertions, 5 deletions

diff --git a/libgomp/ChangeLog b/libgomp/ChangeLog
index 68f67d40c13..817dce7d765 100644
--- a/libgomp/ChangeLog
+++ b/libgomp/ChangeLog
@@ -1,3 +1,8 @@
+2007-01-29  Daniel Franke <franke.daniel@gmail.com>
+
+	PR libgomp/30540
+	* libgomp.texi: More about implementation-dependent settings.
+
 2007-01-26  Tobias Burnus  <burnus@net-b.de>
 
 	* testsuite/libgomp.fortran/fortran.exp: Support .f03 extension.
diff --git a/libgomp/libgomp.texi b/libgomp/libgomp.texi
index a5a9b1f71e9..a10836a58b8 100644
--- a/libgomp/libgomp.texi
+++ b/libgomp/libgomp.texi
@@ -175,6 +175,11 @@ This function returns @code{true} if enabled, @code{false} otherwise.
 Here, @code{true} and @code{false} represent their language-specific 
 counterparts.
 
+The dynamic team setting may be initialized at startup by the 
+@code{OMP_DYNAMIC} environment variable or at runtime using 
+@code{omp_set_dynamic}. If undefined, dynamic adjustment is 
+disabled by default.
+
 @item @emph{C/C++}:
 @multitable @columnfractions .20 .80
 @item @emph{Prototype}: @tab @code{int omp_get_dynamic();}
@@ -186,7 +191,7 @@ counterparts.
 @end multitable
 
 @item @emph{See also}:
-@ref{omp_set_dynamic}
+@ref{omp_set_dynamic}, @ref{OMP_DYNAMIC}
 
 @item @emph{Reference}:
 @uref{http://www.openmp.org/, OpenMP specifications v2.5}, section 3.2.8.
@@ -228,6 +233,11 @@ This function returns @code{true} if nested parallel regions are
 enabled, @code{false} otherwise. Here, @code{true} and @code{false} 
 represent their language-specific counterparts.
 
+Nested parallel regions may be initialized at startup by the 
+@code{OMP_NESTED} environment variable or at runtime using 
+@code{omp_set_nested}. If undefined, nested parallel regions are
+disabled by default.
+
 @item @emph{C/C++}:
 @multitable @columnfractions .20 .80
 @item @emph{Prototype}: @tab @code{int omp_get_nested();}
@@ -239,7 +249,7 @@ represent their language-specific counterparts.
 @end multitable
 
 @item @emph{See also}:
-@ref{omp_set_nested}
+@ref{omp_set_nested}, @ref{OMP_NESTED}
 
 @item @emph{Reference}:
 @uref{http://www.openmp.org/, OpenMP specifications v2.5}, section 3.2.10.
@@ -276,6 +286,13 @@ Returns the number of processors online.
 The number of threads in the current team. In a sequential section of 
 the program @code{omp_get_num_threads} returns 1.
 
+The default team size may be initialized at startup by the 
+@code{OMP_NUM_THREADS} environment variable. At runtime, the size 
+of the current team may be set either by the @code{NUM_THREADS}
+clause or by @code{omp_set_num_threads}. If none of the above were 
+used to define a specific value and @code{OMP_DYNAMIC} is disabled,
+one thread per CPU online is used.
+
 @item @emph{C/C++}:
 @multitable @columnfractions .20 .80
 @item @emph{Prototype}: @tab @code{int omp_get_num_threads();}
@@ -799,6 +816,7 @@ extensions.
 @node OMP_DYNAMIC
 @section @env{OMP_DYNAMIC} -- Dynamic adjustment of threads
 @cindex Environment Variable
+@cindex Implementation specific setting
 @table @asis
 @item @emph{Description}:
 Enable or disable the dynamic adjustment of the number of threads 
@@ -818,6 +836,7 @@ disabled by default.
 @node OMP_NESTED
 @section @env{OMP_NESTED} -- Nested parallel regions
 @cindex Environment Variable
+@cindex Implementation specific setting
 @table @asis
 @item @emph{Description}:
 Enable or disable nested parallel regions, i. e. whether team members
@@ -837,11 +856,12 @@ regions are disabled by default.
 @node OMP_NUM_THREADS
 @section @env{OMP_NUM_THREADS} -- Specifies the number of threads to use
 @cindex Environment Variable
+@cindex Implementation specific setting
 @table @asis
 @item @emph{Description}:
-Specifies the number of threads to use in parallel regions. If undefined
-one thread per CPU online is used. The value of this variable shall be 
-positive integer. 
+Specifies the default number of threads to use in parallel regions. The 
+value of this variable shall be positive integer. If undefined one thread 
+per CPU online is used.
 
 @item @emph{See also}:
 @ref{omp_set_num_threads}
@@ -855,6 +875,7 @@ positive integer.
 @node OMP_SCHEDULE
 @section @env{OMP_SCHEDULE} -- How threads are scheduled
 @cindex Environment Variable
+@cindex Implementation specific setting
 @table @asis
 @item @emph{Description}:
 Allows to specify @code{schedule type} and @code{chunk size}. 
@@ -889,6 +910,7 @@ GCC Patches Mailinglist}
 @node GOMP_STACKSIZE
 @section @env{GOMP_STACKSIZE} -- Set default thread stack size
 @cindex Environment Variable
+@cindex Implementation specific setting
 @table @asis
 @item @emph{Description}:
 Set the default thread stack size in kilobytes. This is in opposition