gfortran.texi: Document the GFORTRAN_ERROR_DUMPCORE and GFORTRAN_ERROR_BACKTRACE...

2007-05-26  Tobias Burnus  <burnus@net-b.de>

       * gfortran.texi: Document the GFORTRAN_ERROR_DUMPCORE and
       GFORTRAN_ERROR_BACKTRACE environment variables.

From-SVN: r125091

diff --git a/gcc/fortran/ChangeLog b/gcc/fortran/ChangeLog
index 0d4a8773e5cd1ca81357bd60fa06d2cc228e1b56..2843e99ffd3ceae475a6d80c01d27e386d25b77b 100644 (file)
--- a/gcc/fortran/ChangeLog
+++ b/gcc/fortran/ChangeLog
@@ -1,3 +1,8 @@
+2007-05-26  Tobias Burnus  <burnus@net-b.de>
+
+       * gfortran.texi: Document the GFORTRAN_ERROR_DUMPCORE and
+       GFORTRAN_ERROR_BACKTRACE environment variables.
+
 2007-05-26  Paul Thomas  <pault@gcc.gnu.org>
 
        PR fortran/31219

diff --git a/gcc/fortran/gfortran.texi b/gcc/fortran/gfortran.texi
index 6b604afe46267d576044c8e4f723b39fe3976118..b0165c81bd0645b367a690d41176f28ff72f0c5f 100644 (file)
--- a/gcc/fortran/gfortran.texi
+++ b/gcc/fortran/gfortran.texi
@@ -518,6 +518,8 @@ Malformed environment variables are silently ignored.
 * GFORTRAN_DEFAULT_RECL:: Default record length for new files
 * GFORTRAN_LIST_SEPARATOR::  Separator for list output
 * GFORTRAN_CONVERT_UNIT::  Set endianness for unformatted I/O
+* GFORTRAN_ERROR_DUMPCORE:: Dump core on run-time errors
+* GFORTRAN_ERROR_BACKTRACE:: Show backtrace on run-time errors
 @end menu
 
 @node GFORTRAN_STDIN_UNIT
@@ -673,6 +675,26 @@ environment variable will override the CONVERT specifier in the
 open statement}.  This is to give control over data formats to
 users who do not have the source code of their program available.
 
+@node GFORTRAN_ERROR_DUMPCORE
+@section @env{GFORTRAN_ERROR_DUMPCORE}---Dump core on run-time errors
+
+If the @env{GFORTRAN_ERROR_DUMPCORE} variable is set to
+@samp{y}, @samp{Y} or @samp{1} (only the first letter is relevant)
+then library run-time errors cause core dumps. To disable the core
+dumps, set the variable to @samp{n}, @samp{N}, @samp{0}. Default
+is not to core dump unless the @option{-fdump-core} compile option
+was used.
+
+@node GFORTRAN_ERROR_BACKTRACE
+@section @env{GFORTRAN_ERROR_BACKTRACE}---Show backtrace on run-time errors
+
+If the @env{GFORTRAN_ERROR_BACKTRACE} variable is set to
+@samp{y}, @samp{Y} or @samp{1} (only the first letter is relevant)
+then a backtrace is printed when a run-time error occurs.
+To disable the backtracing, set the variable to
+@samp{n}, @samp{N}, @samp{0}. Default is not to print a backtrace
+unless the @option{-fbacktrace} compile option
+was used.
 
 @c =====================================================================
 @c PART II: LANGUAGE REFERENCE