3 files changed, 13 insertions, 8 deletions
diff --git a/project/boost/build.py b/project/boost/build.py
index bd4fd6b..a29fb29 100644
--- a/project/boost/build.py
+++ b/project/boost/build.py
@@ -5,8 +5,11 @@
 
 R'''Build Boost.
 
-This script builds the Boost libraries.  Its main utility is setting the
-correct --stagedir parameter value to avoid name clashes.
+The main utility of this script is setting the correct --stagedir parameter
+value to avoid name clashes.
+
+It also facilitates building with different toolsets/for different platforms
+with the help from the --toolset and --platform parameters.
 
 Usage example:
 
diff --git a/project/boost/download.py b/project/boost/download.py
index b5bf684..a3bcf61 100644
--- a/project/boost/download.py
+++ b/project/boost/download.py
@@ -6,7 +6,8 @@
 R'''Download & bootstrap Boost.
 
 This script downloads and unpacks a Boost distribution archive.  Its main
-utility is that it's supposed to be cross-platform.
+utility is that it's cross-platform & supports different Boost versions out of
+the box.
 
 Usage examples:
 
diff --git a/project/build.py b/project/build.py
index ff366c3..f718bea 100644
--- a/project/build.py
+++ b/project/build.py
@@ -5,12 +5,13 @@
 
 R'''Build a CMake project.
 
-This script is used basically to invoke the CMake executable in a
-cross-platform way (provided the platform has Python 3, of course).  The
-motivation was to merge my Travis and AppVeyor build scripts (largely similar,
-but written in bash and PowerShell, respectively).
+This script works nicely with boost-build from this package - it will use the
+correct --stagedir directory automatically.
 
-A simple usage example:
+Also, it facilitates building with different toolsets/for different platforms
+with the help from the --toolset and --platform parameters.
+
+Usage example:
 
     $ project-build --configuration Release --install path/to/somewhere -- examples/simple build/
     ...