From fc56544da49bd84730f72120b21148424007d1e6 Mon Sep 17 00:00:00 2001
From: Joel de Guzman <djowel@gmail.com>
Date: Mon, 1 Sep 2003 03:12:34 +0000
Subject: [PATCH] added note to use bjam as the preferred build tool

[SVN r19889]
---
 doc/tutorial/doc/building_hello_world.html | 15 +++++++++------
 doc/tutorial/doc/quickstart.txt            |  5 +++++
 2 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/doc/tutorial/doc/building_hello_world.html b/doc/tutorial/doc/building_hello_world.html
index 09b7ba93..5e1bf4e7 100644
--- a/doc/tutorial/doc/building_hello_world.html
+++ b/doc/tutorial/doc/building_hello_world.html
@@ -32,12 +32,15 @@ with every boost distribution: <b>bjam</b>.</p>
 <table width="80%" border="0" align="center">
   <tr>
     <td class="note_box">
-<img src="theme/lens.gif"></img> <b>Building without bjam</b><br><br>
-
-Besides bjam, there are of course other ways to get your module built.
-What's written here should not be taken as &quot;the one and only way&quot;.
-There are of course other build tools apart from <tt>bjam</tt>.
-    </td>
+<p><img src="theme/lens.gif"></img> <b>Building without bjam</b><br>
+        <br>
+        Besides bjam, there are of course other ways to get your module built. 
+        What's written here should not be taken as &quot;the one and only way&quot;. 
+        There are of course other build tools apart from <tt>bjam</tt>. </p>
+      <p>Take note however that the preferred build tool for Boost.Python is <tt>bjam</tt>. 
+        There are so many ways to set up the build incorrectly. Experience shows 
+        that 90% of the &quot;I can't build Boost.Python&quot; problems come from 
+        people who had to use a different tool<tt></tt>.</p></td>
   </tr>
 </table>
 <p>
diff --git a/doc/tutorial/doc/quickstart.txt b/doc/tutorial/doc/quickstart.txt
index 9e64ecac..cf75c565 100644
--- a/doc/tutorial/doc/quickstart.txt
+++ b/doc/tutorial/doc/quickstart.txt
@@ -62,6 +62,11 @@ with every boost distribution: [*bjam].
 Besides bjam, there are of course other ways to get your module built.
 What's written here should not be taken as "the one and only way".
 There are of course other build tools apart from [^bjam].
+
+Take note however that the preferred build tool for Boost.Python is bjam. 
+There are so many ways to set up the build incorrectly. Experience shows 
+that 90% of the "I can't build Boost.Python" problems come from people 
+who had to use a different tool.
 ]
 
 We shall skip over the details. Our objective will be to simply create the