From 071d324b5842c57eb886194da042bb3bbe486e55 Mon Sep 17 00:00:00 2001 From: Dave Abrahams Date: Thu, 8 Nov 2001 13:07:23 +0000 Subject: [PATCH] updated instructions [SVN r11630] --- index.html | 70 +++++++++++++++++++++++++++++++++++++++------------ v1/index.html | 70 +++++++++++++++++++++++++++++++++++++++------------ 2 files changed, 108 insertions(+), 32 deletions(-) diff --git a/index.html b/index.html index 7b1fde944..5e5155fa4 100644 --- a/index.html +++ b/index.html @@ -28,7 +28,7 @@ Boost Libraries your favorite compiler, consider contributing one. Secondary tasks like copying libraries to installation specific directories are also weak.

Note that the underlying Jam build engine is mature software, and has - been widely used for many years.  The FTJam and Boost specific + been widely used for many years.  The Boost specific extensions are well on their way to becoming stable, and have begun to attract interest and use outside of Boost. @@ -51,16 +51,47 @@ Expression, and Thread libraries.

-
+ +

+ +

  • Download FTJam and install the binary executable where it will be found + when invoked from the command line.

    • + + +

    + +

  • If you acquired FTJam in the previous step, go to the tools/build/jam_src + subdirectory and invoke + +
    +jam -sBOOST_ROOT= -sBOOST_BUILD_PATH= -sJAMBASE=
+
    + +which will build a new copy of Jam with the Boost extensions enabled. If FTJam +complains about a missing toolset variable, follow its directions by adding the +appropriate settings, e.g.: + +
    +jam -sBOOST_ROOT= -sBOOST_BUILD_PATH= -sJAMBASE= -sJAM_TOOLSET=VISUALC -sVISUALC=c:/tools/msvc 
+
    + +
  • Replace the FTJam executable with the one in the newly-created +bin.platform subdirectory. + + +
    • Set any environmental variables required to run your compiler and related @@ -75,22 +106,25 @@ steps.  The sample commands given will work for both UNIX and Windows.

    • Change to the Boost root directory.  (The directory you unpacked the distribution into.  Among others, it contain the file c++boost.gif, subdirectories boost, libs, more, etc.)
      • -
    -

    chdir my_boost

    -
    -
      + +

      +

    • Build the Boost libraries for your tools. The example is for the GNU and Metrowerks compilers.
      • -
    -
    -

    jam -ftools/build/allyourbase.jam -sTOOLS="gcc - metrowerks"

    +

    jam -sBOOST_ROOT=. -sTOOLS="gcc metrowerks"

    -
    + +

    + +

  • If you don't want to specify BOOST_ROOT on the command-line, + you can instead set the BOOST_ROOT environment variable (an + absolute path is recommended). + +

    More on using the tools

    The build system's toolsets are designed to work in either of two ways:

      @@ -148,6 +182,10 @@ steps.  The sample commands given will work for both UNIX and Windows.

      msvc Microsoft Visual C++ command line compiler tools + + msvc-stlport + Microsoft Visual C++ command line compiler tools, using the STLport library + vacpp IBM Visual Age C++ command line compiler tools @@ -160,7 +198,7 @@ to the tools/build subdirectory, where xxxx is the name of the tool being added.  If you write an additional toolset file, please submit it to Boost so others may benefit from your work.

      -

      Revised 02 November, 2001 +

      Revised 08 November, 2001

      © Copyright 2001 Beman Dawes

       

      diff --git a/v1/index.html b/v1/index.html index 7b1fde944..5e5155fa4 100644 --- a/v1/index.html +++ b/v1/index.html @@ -28,7 +28,7 @@ Boost Libraries your favorite compiler, consider contributing one. Secondary tasks like copying libraries to installation specific directories are also weak.

      Note that the underlying Jam build engine is mature software, and has - been widely used for many years.  The FTJam and Boost specific + been widely used for many years.  The Boost specific extensions are well on their way to becoming stable, and have begun to attract interest and use outside of Boost. @@ -51,16 +51,47 @@ Expression, and Thread libraries.

      • Download Boost, and unpack the full directory structure into some root directory.
        • -
      • Download FTJam, and install the binary executable where it will be found - when invoked from the command line.
        • -
      -
      + +

      + +

    1. Download FTJam and install the binary executable where it will be found + when invoked from the command line.

      2. +
      • For easy-to-build source files, see the FTJam site on SourceForge.
        • +
      • For Linux and Win32 pre-built executables, see the ftjam - section of the FreeType file list.
        • + section of the FreeType file list. + +
      • If there is no pre-built FTJam executable for your platform, don't + bother downloading the source. Instead, read the Jam build instructions and + apply them directly to the Boost Jam sources in the + tools/build/jam_src subdirectory.
      + +

      + +

    2. If you acquired FTJam in the previous step, go to the tools/build/jam_src + subdirectory and invoke + +
      +jam -sBOOST_ROOT= -sBOOST_BUILD_PATH= -sJAMBASE=
+
      + +which will build a new copy of Jam with the Boost extensions enabled. If FTJam +complains about a missing toolset variable, follow its directions by adding the +appropriate settings, e.g.: + +
      +jam -sBOOST_ROOT= -sBOOST_BUILD_PATH= -sJAMBASE= -sJAM_TOOLSET=VISUALC -sVISUALC=c:/tools/msvc 
+
      + +
    3. Replace the FTJam executable with the one in the newly-created +bin.platform subdirectory. + + +
      • Set any environmental variables required to run your compiler and related @@ -75,22 +106,25 @@ steps.  The sample commands given will work for both UNIX and Windows.

      • Change to the Boost root directory.  (The directory you unpacked the distribution into.  Among others, it contain the file c++boost.gif, subdirectories boost, libs, more, etc.)
        • -
      -

      chdir my_boost

      -
      -
        + +

        +

      • Build the Boost libraries for your tools. The example is for the GNU and Metrowerks compilers.
        • -
      -
      -

      jam -ftools/build/allyourbase.jam -sTOOLS="gcc - metrowerks"

      +

      jam -sBOOST_ROOT=. -sTOOLS="gcc metrowerks"

      -
      + +

      + +

    4. If you don't want to specify BOOST_ROOT on the command-line, + you can instead set the BOOST_ROOT environment variable (an + absolute path is recommended). + +

      More on using the tools

      The build system's toolsets are designed to work in either of two ways:

        @@ -148,6 +182,10 @@ steps.  The sample commands given will work for both UNIX and Windows.

        msvc Microsoft Visual C++ command line compiler tools + + msvc-stlport + Microsoft Visual C++ command line compiler tools, using the STLport library + vacpp IBM Visual Age C++ command line compiler tools @@ -160,7 +198,7 @@ to the tools/build subdirectory, where xxxx is the name of the tool being added.  If you write an additional toolset file, please submit it to Boost so others may benefit from your work.

        -

        Revised 02 November, 2001 +

        Revised 08 November, 2001

        © Copyright 2001 Beman Dawes