[committed] Doc patch for config.host

[neroden at twcny dot rr dot com (Nathanael Nerode)]

Passed 'make info'.  Committed.

	* doc/fragments.texi: Mention config.host.
	* doc/sourcebuild.texi: Mention config.host.  Give brief descriptions
	of config.build, config.host, and config.gcc.

Index: fragments.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/doc/fragments.texi,v
retrieving revision 1.6
diff -u -r1.6 fragments.texi
--- fragments.texi	31 Aug 2003 19:00:39 -0000	1.6
+++ fragments.texi	1 Sep 2003 17:41:10 -0000
@@ -13,7 +13,8 @@
 fragments from the @file{config} directory.  These are used to set
 Makefile parameters that are not amenable to being calculated by
 autoconf.  The list of fragments to incorporate is set by
-@file{config.gcc} (and occasionally @file{config.build}); @xref{System Config}.
+@file{config.gcc} (and occasionally @file{config.build}
+and @file{config.host}); @xref{System Config}.
 
 Fragments are named either @file{t-@var{target}} or @file{x-@var{host}},
 depending on whether they are relevant to configuring GCC to produce
Index: sourcebuild.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/doc/sourcebuild.texi,v
retrieving revision 1.29
diff -u -r1.29 sourcebuild.texi
--- sourcebuild.texi	31 Aug 2003 19:00:39 -0000	1.29
+++ sourcebuild.texi	1 Sep 2003 17:41:16 -0000
@@ -175,7 +175,8 @@
 
 @menu
 * Config Fragments::     Scripts used by @file{configure}.
-* System Config::        The @file{config.build} and @file{config.gcc} files.
+* System Config::        The @file{config.build}, @file{config.host}, and
+                         @file{config.gcc} files.
 * Configuration Files::  Files created by running @file{configure}.
 @end menu
 
@@ -191,12 +192,14 @@
 the top level one) used?
 
 @item The file @file{config.gcc} is used to handle configuration
-specific to the particular host or target machine.  The file 
+specific to the particular target machine.  The file 
 @file{config.build} is used to handle configuration specific to the 
-particular build machine.  (In general, these should only be used for 
-features that cannot reasonably be tested in Autoconf feature tests.)
-@xref{System Config, , The @file{config.build} and @file{config.gcc} Files},
-for details of the contents of these files.
+particular build machine.  The file @file{config.host} is used to handle
+configuration specific to the particular host machine.  (In general,
+these should only be used for features that cannot reasonably be tested in
+Autoconf feature tests.)
+@xref{System Config, , The @file{config.build}, @file{config.host},
+and @file{config.gcc} Files}, for details of the contents of these files.
 
 @item Each language subdirectory has a file
 @file{@var{language}/config-lang.in} that is used for
@@ -208,7 +211,20 @@
 @end itemize
 
 @node System Config
-@subsubsection The @file{config.build} and @file{config.gcc} Files
+@subsubsection The @file{config.build}, @file{config.host}, and @file{config.gcc} Files
+
+The @file{config.build} file contains specific rules for particular systems
+which GCC is built on.  This should be used as rarely as possible, as the
+behavior of the build system can always be detected by autoconf.
+
+The @file{config.host} file contains specific rules for particular systems
+which GCC will run on.  This is rarely needed.
+
+The @file{config.gcc} file contains specific rules for particular systems
+which GCC will generate code for.  This is usually needed.
+
+Each file has a list of the shell variables it sets, with descriptions, at the
+top of the file.
 
 FIXME: document the contents of these files, and what variables should
 be set to control build, host and target configuration.

-- 
Nathanael Nerode  <neroden at gcc.gnu.org>
http://home.twcny.rr.com/nerode/neroden/fdl.html