Commit f3f2c465 by Janne Blomqvist

texinfo fixes suggested by Ralf Wildenhues

Co-Authored-By: Ralf Wildenhues <Ralf.Wildenhues@gmx.de>

From-SVN: r169892
parent 0e048a16
2011-02-07 Janne Blomqvist <jb@gcc.gnu.org>
Ralf Wildenhues <Ralf.Wildenhues@gmx.de>
* gfortran.texi (Thread-safety): texinfo styling fixes.
* intrinsic.texi: Likewise.
2011-02-06 Janne Blomqvist <jb@gcc.gnu.org> 2011-02-06 Janne Blomqvist <jb@gcc.gnu.org>
* gfortran.texi (Compiler Characteristics): Add reference to * gfortran.texi (Compiler Characteristics): Add reference to
......
...@@ -1168,25 +1168,25 @@ using OpenMP, by calling OS thread handling functions via the ...@@ -1168,25 +1168,25 @@ using OpenMP, by calling OS thread handling functions via the
@code{ISO_C_BINDING} facility, or by GNU Fortran compiled library code @code{ISO_C_BINDING} facility, or by GNU Fortran compiled library code
being called from a multi-threaded program. being called from a multi-threaded program.
The GNU Fortran runtime library, (@var{libgfortran}), supports being The GNU Fortran runtime library, (@code{libgfortran}), supports being
called concurrently from multiple threads with the following called concurrently from multiple threads with the following
exceptions. exceptions.
During library initialization, the C @code{getenv()} function is used, During library initialization, the C @code{getenv} function is used,
which need not be thread-safe. Similarly, the @code{getenv()} which need not be thread-safe. Similarly, the @code{getenv}
function is used to implement the @code{GET_ENVIRONMENT_VARIABLE} and function is used to implement the @code{GET_ENVIRONMENT_VARIABLE} and
@code{GETENV} intrinsics. It is the responsibility of the user to @code{GETENV} intrinsics. It is the responsibility of the user to
ensure that the environment is not being updated concurrently when any ensure that the environment is not being updated concurrently when any
of these actions are taking place. of these actions are taking place.
The @code{EXECUTE_COMMAND_LINE} and @code{SYSTEM} intrinsics are The @code{EXECUTE_COMMAND_LINE} and @code{SYSTEM} intrinsics are
implemented with the @code{system()} function, which need not be implemented with the @code{system} function, which need not be
thread-safe. It is the responsibility of the user to ensure that thread-safe. It is the responsibility of the user to ensure that
@code{system()} is not called concurrently. @code{system} is not called concurrently.
Finally, for platforms not supporting thread-safe @code{POSIX} Finally, for platforms not supporting thread-safe POSIX functions,
functions, further functionality might not be thread-safe. For further functionality might not be thread-safe. For details, please
details, please consult the documentation for your operating system. consult the documentation for your operating system.
@c --------------------------------------------------------------------- @c ---------------------------------------------------------------------
@c Extensions @c Extensions
......
...@@ -4151,10 +4151,11 @@ end program test_etime ...@@ -4151,10 +4151,11 @@ end program test_etime
asynchronously. asynchronously.
The @code{COMMAND} argument is passed to the shell and executed, using The @code{COMMAND} argument is passed to the shell and executed, using
the C library's @code{system()} call. (The shell is @code{sh} on Unix the C library's @code{system} call. (The shell is @code{sh} on Unix
systems, and @code{cmd.exe} on Windows.) If @code{WAIT} is present and systems, and @code{cmd.exe} on Windows.) If @code{WAIT} is present
has the value false, the execution of the command is asynchronous if the and has the value false, the execution of the command is asynchronous
system supports it; otherwise, the command is executed synchronously. if the system supports it; otherwise, the command is executed
synchronously.
The three last arguments allow the user to get status information. After The three last arguments allow the user to get status information. After
synchronous execution, @code{EXITSTAT} contains the integer exit code of synchronous execution, @code{EXITSTAT} contains the integer exit code of
...@@ -4162,9 +4163,9 @@ the command, as returned by @code{system}. @code{CMDSTAT} is set to zero ...@@ -4162,9 +4163,9 @@ the command, as returned by @code{system}. @code{CMDSTAT} is set to zero
if the command line was executed (whatever its exit status was). if the command line was executed (whatever its exit status was).
@code{CMDMSG} is assigned an error message if an error has occurred. @code{CMDMSG} is assigned an error message if an error has occurred.
Note that the @code{system()} call need not be thread-safe. It is the Note that the @code{system} call need not be thread-safe. It is the
responsibility of the user to ensure that @code{system()} is not responsibility of the user to ensure that @code{system} is not called
called concurrently. concurrently.
@item @emph{Standard}: @item @emph{Standard}:
Fortran 2008 and later Fortran 2008 and later
...@@ -4204,7 +4205,7 @@ end program test_exec ...@@ -4204,7 +4205,7 @@ end program test_exec
@item @emph{Note}: @item @emph{Note}:
Because this intrinsic is implemented in terms of the @code{system()} Because this intrinsic is implemented in terms of the @code{system}
function call, its behavior with respect to signaling is processor function call, its behavior with respect to signaling is processor
dependent. In particular, on POSIX-compliant systems, the SIGINT and dependent. In particular, on POSIX-compliant systems, the SIGINT and
SIGQUIT signals will be ignored, and the SIGCHLD will be blocked. As SIGQUIT signals will be ignored, and the SIGCHLD will be blocked. As
...@@ -11791,9 +11792,9 @@ and environment-dependent. ...@@ -11791,9 +11792,9 @@ and environment-dependent.
This intrinsic is provided in both subroutine and function forms; This intrinsic is provided in both subroutine and function forms;
however, only one form can be used in any given program unit. however, only one form can be used in any given program unit.
Note that the @code{system()} call need not be thread-safe. It is the Note that the @code{system} call need not be thread-safe. It is the
responsibility of the user to ensure that @code{system()} is not responsibility of the user to ensure that @code{system} is not called
called concurrently. concurrently.
@item @emph{Standard}: @item @emph{Standard}:
GNU extension GNU extension
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment