GFortran documentation updates merged into 4.2.

[Brooks Moses <brooks dot moses at codesourcery dot com>]

I just merged all of my recent GFortran documentation changes and 
updates into the 4.2 branch.  Rather than attach the quite large diff 
between the pre- and post-commit versions, I'm attaching the much 
smaller diff between the current 4.2 and Mainline versions of the 
documentation files.  This should cover all of the documented 
differences between the two branches -- at present, this is a handful of 
F2003 features, and four new compiler options.

The merged files were tested with "make pdf" and "make info" on 
i686-pc-linux-gnu, and committed under blanket approval from Steve Kargl.

- Brooks
Index: gfortran.texi
===================================================================
--- ../../../svn-source/gcc/fortran/gfortran.texi	2007-01-09 23:39:12.574000000 -0800
+++ gfortran.texi	2007-01-20 17:55:27.936625000 -0800
@@ -763,32 +763,7 @@
 The @code{OPEN} statement supports the @code{ACCESS='STREAM'} specifier,
 allowing I/O without any record structure.
 
-@item
-Namelist input/output for internal files.
-
-@item
-@cindex @code{PROTECTED}
-The @code{PROTECTED} statement and attribute.
-
-@item
-@cindex @code{VALUE}
-The @code{VALUE} statement and attribute.
 
-@item
-@cindex @code{VOLATILE}
-The @code{VOLATILE} statement and attribute.
-
-@item
-@cindex @code{IMPORT}
-The @code{IMPORT} statement, allowing to import
-host-associated derived types.
-
-@item
-@cindex @code{USE, INTRINSIC}
-@cindex @code{ISO_FORTRAN_ENV}
-@code{USE} statement with @code{INTRINSIC} and @code{NON_INTRINSIC}
-attribute; supported intrinsic modules: @code{ISO_FORTRAN_ENV},
-@code{OMP_LIB} and @code{OMP_LIB_KINDS}.
 
 @end itemize
 
Index: invoke.texi
===================================================================
--- ../../../svn-source/gcc/fortran/invoke.texi	2007-01-20 11:31:19.124125000 -0800
+++ invoke.texi	2007-01-20 18:06:29.874125000 -0800
@@ -126,7 +126,7 @@
 @item Error and Warning Options
 @xref{Error and Warning Options,,Options to Request or Suppress Errors
 and Warnings}.
-@gccoptlist{-fmax-errors=@var{n} @gol
+@gccoptlist{
 -fsyntax-only  -pedantic  -pedantic-errors @gol
 -w  -Wall  -Waliasing  -Wampersand  -Wconversion  -Wimplicit-interface @gol
 -Wtabs -Wnonstd-intrinsics -Wsurprising -Wunderflow @gol
@@ -134,8 +134,7 @@
 
 @item Debugging Options
 @xref{Debugging Options,,Options for Debugging Your Program or GCC}.
-@gccoptlist{-fdump-parse-tree  -ffpe-trap=@var{list}
--fdump-core}
+@gccoptlist{-fdump-parse-tree  -ffpe-trap=@var{list}}
 
 @item Directory Options
 @xref{Directory Options,,Options for Directory Search}.
@@ -150,8 +149,7 @@
 @gccoptlist{-fno-automatic  -ff2c  -fno-underscoring
 -fsecond-underscore @gol
 -fbounds-check  -fmax-stack-var-size=@var{n} @gol
--fpack-derived  -frepack-arrays  -fshort-enums  -fexternal-blas @gol
--fblas-matmul-limit=@var{n}}
+-fpack-derived  -frepack-arrays  -fshort-enums}
 @end table
 
 @menu
@@ -366,15 +364,6 @@
 by GNU Fortran:
 
 @table @gcctabopt
-@item -fmax-errors-@var{n}
-@cindex @code{-fmax-errors-}@var{n} option
-@cindex option, @code{-fmax-errors-}@var{n}
-@cindex errors, limiting
-Limits the maximum number of error messages to @var{n}, at which point
-GNU Fortran bails out rather than attempting to continue processing the
-source code.  If @var{n} is 0, there is no limit on the number of error
-messages produced.
-
 @item -fsyntax-only
 @cindex @code{-fsyntax-only} option
 @cindex option, @code{-fsyntax-only}
@@ -560,15 +549,6 @@
 @samp{underflow} (underflow in a floating point operation),
 @samp{precision} (loss of precision during operation) and @samp{denormal}
 (operation produced a denormal value).
-
-@cindex -fdump-core option
-@cindex options, -fdump-core
-@item -fdump-core
-@cindex core
-Request that a core-dump file is written to disk when a runtime error
-is encountered on systems that support core dumps. This option is
-only effective for the compilation of the Fortran main program.
-
 @end table
 
 @xref{Debugging Options,,Options for Debugging Your Program or GCC,
@@ -882,28 +862,6 @@
 GNU Fortran choose the smallest @code{INTEGER} kind a given
 enumerator set will fit in, and give all its enumerators this kind.
 
-@item -fexternal-blas
-@cindex @code{-fexternal-blas} option
-@cindex option, @code{-fexternal-blas}
-This option will make gfortran generate calls to BLAS functions for some
-matrix operations like @code{MATMUL}, instead of using our own
-algorithms, if the size of the matrices involved is larger than a given
-limit (see @option{-fblas-matmul-limit}).  This may be profitable if an
-optimized vendor BLAS library is available.  The BLAS library will have
-to be specified at link time.
-
-@item -fblas-matmul-limit=@var{n}
-@cindex @code{-fblas-matmul-limit} option
-@cindex option, @code{-fblas-matmul-limit}
-Only significant when @option{-fexternal-blas} is in effect.
-Matrix multiplication of matrices with size larger than (or equal to) @var{n}
-will be performed by calls to BLAS functions, while others will be
-handled by @command{gfortran} internal algorithms. If the matrices
-involved are not square, the size comparison is performed using the
-geometric mean of the dimensions of the argument and result matrices.
-
-The default value for @var{n} is 30.
-
 @end table
 
 @xref{Code Gen Options,,Options for Code Generation Conventions,