Cleaned out flotsam and improved comments

[SVN r36317]

build/Jamfile.v2

@@ -11,23 +11,8 @@ if [ python.configured ] {
     
 
 project boost/python
-    : source-location ../src
-        : requirements 
-        #<include>$(PYTHON_PATH)/include
-        #  $(lib_condition)<library-path>$(PYTHON_PATH)/libs
-        #    <link>shared:<library>$(PYTHON_LIB)
-        #    <define>$(defines)
-        #: usage-requirements # requirement that will be propageted to *users* of this library
-        #  <include>$(PYTHON_PATH)/include
-
-# We have a bug which causes us to conclude that conditionalized
-# properties in this section are not free.
-#          $(lib_condition)<library-path>$(PYTHON_PATH)/lib/python2.2/config
-#            <shared>true:<find-library>$(PYTHON_LIB)
-            
-        # <library-path>$(PYTHON_PATH)/lib/python2.2/config
-        #    <library>$(PYTHON_LIB)
-    ;
+  : source-location ../src
+  ;
 
 lib boost_python
     : # sources
@@ -63,16 +48,21 @@ lib boost_python
     :   # requirements
         <link>static:<define>BOOST_PYTHON_STATIC_LIB 
         <define>BOOST_PYTHON_SOURCE
-        # On Linux, we don't link to Python library itself. If
-        # Boost.Python is used for extension, all Python
-        # symbols are available in Python interpreter.
-        # If Boost.Python is used for extending, client
-        # is required to link to /python//python itself.
-        # On Windows, all code using Python has to link
-        # to python import library. The 'python_for_extension'
-        # is the target that's setup to provide either just
-        # include paths, or import library.  
+      
+        # On Windows, all code using Python has to link to the Python
+        # import library.
+        #
+        # On *nix we never link libboost_python to libpython.  When
+        # extending Python, all Python symbols are provided by the
+        # Python interpreter executable.  When embedding Python, the
+        # client executable is expected to explicitly link to
+        # /python//python (the target representing libpython) itself.
+        #
+        # python_for_extensions is a target defined by Boost.Build to
+        # provide the Python include paths, and on Windows, the Python
+        # import library, as usage requirements.
         <library>/python//python_for_extensions
+      
     :   # default build
         <link>shared
     :   # usage requirements