re PR fortran/37032 (including "file.F90" - no CPP processing)

2008-08-18  Daniel Franke  <franke.daniel@gmail.com>

        PR fortran/37032
        * gfortran.texi: Document decision on include file handling in
        preprocessed files.

From-SVN: r139215

diff --git a/gcc/fortran/ChangeLog b/gcc/fortran/ChangeLog
index 8ca3f84aad7c23cd6a9c4c3ac36fa6786ed22cb8..494e61045c7bc4a3cc402e304e6153e13e323bb8 100644 (file)
--- a/gcc/fortran/ChangeLog
+++ b/gcc/fortran/ChangeLog
@@ -1,3 +1,9 @@
+2008-08-18  Daniel Franke  <franke.daniel@gmail.com>
+
+       PR fortran/37032
+       * gfortran.texi: Document decision on include file handling in
+       preprocessed files.
+
 2008-08-16  Tobias Burnus  <burnus@net-b.de>
 
        PR fortran/36825

diff --git a/gcc/fortran/gfortran.texi b/gcc/fortran/gfortran.texi
index c79a70a407a8b51c56351c03a1759c8e39a669f4..933ed45b5cd3f8e9eaaf32212ea188cbf985a762 100644 (file)
--- a/gcc/fortran/gfortran.texi
+++ b/gcc/fortran/gfortran.texi
@@ -401,6 +401,7 @@ Fortran compiler.
 @cindex FPP
 @cindex Conditional compilation
 @cindex Preprocessing
+@cindex preprocessor, include file handling
 
 Many Fortran compilers including GNU Fortran allow passing the source code
 through a C preprocessor (CPP; sometimes also called the Fortran preprocessor,
@@ -413,7 +414,11 @@ invoke the preprocessor on any file, use @option{-cpp}, to disable
 preprocessing on files where the preprocessor is run automatically, use
 @option{-nocpp}.
 
-If the GNU Fortran invoked the preprocessor, @code{__GFORTRAN__}
+If a preprocessed file includes another file with the Fortran @code{INCLUDE}
+statement, the included file is not preprocessed. To preprocess included
+files, use the equivalent preprocessor statement @code{#include}.
+
+If GNU Fortran invokes the preprocessor, @code{__GFORTRAN__}
 is defined and @code{__GNUC__}, @code{__GNUC_MINOR__} and
 @code{__GNUC_PATCHLEVEL__} can be used to determine the version of the
 compiler. See @ref{Top,,Overview,cpp,The C Preprocessor} for details.