Some comments

[SVN r27982]

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) ;

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 ] 
         {