Changes between Version 4 and Version 5 of CMakeConfigAndBuild

Timestamp:

Jun 12, 2007, 5:31:07 PM (15 years ago)

Author:

troy d. straszheim

Comment:

include a bit more output from the cmake phase, move 'ccmake' business to a separate section on tuning the cmake build (to come)

CMakeConfigAndBuild

@@ -9 +9 @@
 }}}
 
-  Note that it is '''not''' actually necessary to set any environment variable `BOOST`.
+  Note that it is '''not''' actually necessary to set any environment variable `BOOST`, this is a convention used in this document.
  
   * Download Boost with CMake: At present, the CMake build system is developed externally from Boost itself. To get a copy of Boost 1.34.0 with the CMake build system, retrieve it from the [wiki:BoostSubversion  Boost Subversion repository] with the URL http://svn.boost.org/svn/boost/sandbox-branches/boost-cmake/boost_1_34_0].  So,
@@ -38 +38 @@
 cmake $BOOST/src
       }}}
+      You'll see output from `cmake`.  On unix it looks like this:
+      {{{
+% cmake $BOOST/src 
+-- Check for working C compiler: /usr/bin/gcc
+-- Check for working C compiler: /usr/bin/gcc -- works
+-- Check size of void*
+-- Check size of void* - done
+-- Check for working CXX compiler: /usr/bin/c++
+-- Check for working CXX compiler: /usr/bin/c++ -- works
+-- Scanning subdirectories:
+--  + io
+--  + any
+--  + crc
+--  + mpl
+--  + tr1
+--  + bind
+  [snip]
+--  + program_options
+--  + ptr_container
+--  + type_traits
+-- Configuring done
+-- Generating done
+-- Build files have been written to: $BOOST/build
+}}} 
+
+      The directory `$BOOST/build` should now contain a bunch of generated files, including a toplevel `Makefile`, something like this:
+      {{{
+ % ls
+CMakeCache.txt           CPackConfig.cmake    Makefile  
+cmake_install.cmake      libs/                CMakeFiles/     
+CPackSourceConfig.cmake  bin/                 lib/
+}}}
 
   That's it! You've now configured your source tree and are ready to start building Boost.
@@ -43 +75 @@
   * Build Boost: Like configuration, the way in which one builds Boost with CMake differs from one platform to another, depending on your platform and how you configured CMake. Either way, you'll be using the tools provided to you by your compiler or operating system vendor.
     * '''Microsoft Visual Studio''': If you have generated project files for Microsoft Visual Studio, you will need to start up Visual Studio to build Boost. Once Visual Studio has loaded, load the solution or project`Boost` from the Boost binary directory you set in the CMake configuration earlier. Then, just click "Build" to build all of Boost.
-    * '''On Unix''' (and when using makefile variants on Microsoft Windows): If you are on Unix, you will build Boost using standard "make" tools. Change into the binary directory we created and configured earlier, than run `make`:
+    * '''On Unix''' (and when using makefile variants on Microsoft Windows): If you are on Unix, you will build Boost using standard "make" tools. In the directory $BOOST/build (where the generated makefiles are) run `make`:
        {{{
 make