Update documentation about tm_p.h

git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@178618 138bc75d-0d04-0410-961f-82ee72b054a4

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index df48777..3abfc4f 100644 (file)
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,8 @@
+2011-09-06  Michael Meissner  <meissner@linux.vnet.ibm.com>
+
+       * doc/configfiles.texi (Configuration Files): Update documentation
+       about tm_p.h and remove FIXME comment.
+
 2011-09-06  Uros Bizjak  <ubizjak@gmail.com>
 
        * config/i386/i386.c (ix86_function_value_regno_p): Use AX_REG.

diff --git a/gcc/doc/configfiles.texi b/gcc/doc/configfiles.texi
index d122225..d8b15c5 100644 (file)
--- a/gcc/doc/configfiles.texi
+++ b/gcc/doc/configfiles.texi
@@ -59,6 +59,14 @@ these include the autoconfigured headers generated by
 machine.
 @item
 @file{tm_p.h}, which includes the header @file{@var{machine}-protos.h}
-that contains prototypes for functions in the target @file{.c} file.
-FIXME: why is such a separate header necessary?
+that contains prototypes for functions in the target
+@file{@var{machine}.c} file.  The header @file{@var{machine}-protos.h}
+can include prototypes of functions that use rtl and tree data
+structures inside appropriate @code{#ifdef RTX_CODE} and @code{#ifdef
+TREE_CODE} conditional code segements.  The
+@file{@var{machine}-protos.h} is included after the @file{rtl.h}
+and/or @file{tree.h} would have been included.  The @file{tm_p.h} also
+includes the header @file{tm-preds.h} which is generated by
+@file{genpreds} program during the build to define the declarations
+and inline functions for the predicate functions.
 @end itemize