From f2d77d8411a53655e83dde0b714ab74431727ab8 Mon Sep 17 00:00:00 2001
From: stevenknight <stevenknight@fdb21ef1-2011-0410-befe-b5e4ea1792b1>
Date: Sat, 8 Feb 2003 14:31:31 +0000
Subject: [PATCH] Fix the last DESCRIPTION paragraph about default Tool
 selection.

git-svn-id: http://scons.tigris.org/svn/scons/trunk@579 fdb21ef1-2011-0410-befe-b5e4ea1792b1
---
 doc/man/scons.1                   | 43 ++++++++++++++++++++++++-------
 src/engine/SCons/Tool/__init__.py |  2 ++
 2 files changed, 35 insertions(+), 10 deletions(-)

diff --git a/doc/man/scons.1 b/doc/man/scons.1
index c1cb9e00..257dbd65 100644
--- a/doc/man/scons.1
+++ b/doc/man/scons.1
@@ -119,7 +119,9 @@ scons: done building targets.
 $
 .EE
 
-These status messages may be suppressed using the
+The status messages
+(everything except the line that reads "cp foo.in foo.out")
+may be suppressed using the
 .B -Q
 option.
 
@@ -288,16 +290,37 @@ requires Python version 1.5.2 or later.
 There should be no other dependencies or requirements to run
 .B scons.
 
-The default
+.\" The following paragraph reflects the default tool search orders
+.\" currently in SCons/Tool/__init__.py.  If any of those search orders
+.\" change, this documentation should change, too.
+By default,
+.B scons
+knows how to search for available programming tools
+on various systems.
+On WIN32 systems,
+.B scons
+searches in order for the
+Microsoft Visual C++ tools,
+the MinGW tool chain,
+the Intel compiler tools,
+and the PharLap ETS compiler.
+On OS/2 systems,
+.B scons
+searches in order for the 
+OS/2 compiler,
+the GCC tool chain,
+and the Microsoft Visual C++ tools,
+On SGI IRIX systems,
+.B
+searches for the MIPSPro compiler tools
+and the GCC tool chain.
+And on all other platforms,
+including POSIX (Linux and UNIX) platforms,
 .B scons
-configuration assumes
-use of the Microsoft Visual C++ compiler suite on WIN32 systems,
-and assumes a C compiler named
-.B cc
-and a C++ compiler named
-.B c++
-(such as found in the GNU C compiler suite)
-on any other type of system.
+searches in order
+for the GCC tool chain,
+the Microsoft Visual C++ tools,
+and the Intel compiler tools.
 You may, of course, override these default values
 by appropriate configuration of
 Environment construction variables.
diff --git a/src/engine/SCons/Tool/__init__.py b/src/engine/SCons/Tool/__init__.py
index ca591f61..19a3cff4 100644
--- a/src/engine/SCons/Tool/__init__.py
+++ b/src/engine/SCons/Tool/__init__.py
@@ -143,6 +143,8 @@ def tool_list(platform, env):
     # XXX this logic about what tool to prefer on which platform
     #     should be moved into either the platform files or
     #     the tool files themselves.
+    # The search orders here are described in the man page.  If you
+    # change these search orders, update the man page as well.
     if str(platform) == 'win32':
         "prefer Microsoft tools on Windows"
         linkers = ['mslink', 'gnulink', 'ilink', 'linkloc' ]
-- 
2.26.2