From 233ccf88adf19834086c5d3179a32d8a15ccbb52 Mon Sep 17 00:00:00 2001
From: Vladimir Prus <ghost@cs.msu.su>
Date: Tue, 5 Apr 2005 13:37:44 +0000
Subject: [PATCH] Some comments

[SVN r27982]
---
 v2/tools/boostbook.jam | 2 ++
 v2/tools/builtin.jam   | 6 +++++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/v2/tools/boostbook.jam b/v2/tools/boostbook.jam
index beaf93f02..29f1f446e 100644
--- a/v2/tools/boostbook.jam
+++ b/v2/tools/boostbook.jam
@@ -308,11 +308,13 @@ class boostbook-generator : generator
         
         if $(manifest)
         {
+            # Create DOCBOOK file from BOOSTBOOK sources.
             local base-target = [ generators.construct $(project) 
               : DOCBOOK : $(property-set) : $(sources) ] ;
             base-target = $(base-target[2]) ;
             $(base-target).depends $(catalog) ;
             
+            # Generate HTML/PDF/PS from DOCBOOK.
             local target = [ generators.construct $(project) $(manifest)
               : $(type) : $(property-set) : $(base-target) ] ;
             $(target[2]).set-path $(format) ;
diff --git a/v2/tools/builtin.jam b/v2/tools/builtin.jam
index be5981770..161648217 100644
--- a/v2/tools/builtin.jam
+++ b/v2/tools/builtin.jam
@@ -545,7 +545,11 @@ class linking-generator : generator
                 extra += <library-path>$(search) ;
             }
         }
-                   
+
+        # Hardcode dll paths only when linking executables.
+        # Pros: don't need to relinking libraries when installing.
+        # Cons: "standalone" libraries (plugins, python extensions)
+        # can't hardcode paths to dependent libraries.
         if [ $(property-set).get <hardcode-dll-paths> ] = true
          && [ type.is-derived $(self.target-types[1]) EXE ] 
         {