Re: [Boost-bugs] [Boost C++ Libraries] #1744: Change in default build variants broke "Getting Started" (was: [getting started] No information on building static libraries with bjam under Windows)

Subject: Re: [Boost-bugs] [Boost C++ Libraries] #1744: Change in default build variants broke "Getting Started" (was: [getting started] No information on building static libraries with bjam under Windows)
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2008-07-09 00:04:02

#1744: Change in default build variants broke "Getting Started"
-------------------------------+--------------------------------------------
  Reporter:  tychom_at_[hidden]  |       Owner:  grafik                   
      Type:  Bugs              |      Status:  reopened                 
 Milestone:  Boost 1.36.0      |   Component:  build                    
   Version:  Boost 1.35.0      |    Severity:  Regression               
Resolution:                    |    Keywords:  bjam build static windows
-------------------------------+--------------------------------------------
Changes (by dave):

  * component:  Documentation => build
  * severity:  Problem => Regression


Old description:

> Problem relates to the boost 1.35 with VC++ 8.0.
>
> When using bjam to build the Boost libraries from source there is no
> information provided in an easily accessible manner describing how to
> build static versions of those libraries for which such a thing is
> appropriate - threads, regex etc. As a number of libraries attempt to
> link statically by default this is quite a pain.
>
> The getting started guide for Windows found at
> 'more/getting_started/windows.html#or-build-binaries-from-source'
> provides no information on the bjam setting 'link=static'. In order to
> come across this information currently one needs to follow the link
> 'Boost.Build reference manual' close to the very bottom of the 'Getting
> Started' page, then take the 'Documentation' link and finally 'Static and
> shared libraries'.
>
> If additional information could be put in the bjam section of the getting
> started guide then this will 1) ensure less people wonder why the static
> libraries were not built in the first place 2) ensure less people have to
> hunt through the necessary links to find information on building static
> libraries.

New description:

 Boost.Build no longer builds the same library variants that it used to,
 which caused the instructions in the Getting Started guide to be wrong.

 Original description:

 = [getting started] No information on building static libraries with bjam
 under Windows =

 Problem relates to the boost 1.35 with VC++ 8.0.

 When using bjam to build the Boost libraries from source there is no
 information provided in an easily accessible manner describing how to
 build static versions of those libraries for which such a thing is
 appropriate - threads, regex etc. As a number of libraries attempt to link
 statically by default this is quite a pain.

 The getting started guide for Windows found at
 'more/getting_started/windows.html#or-build-binaries-from-source' provides
 no information on the bjam setting 'link=static'. In order to come across
 this information currently one needs to follow the link 'Boost.Build
 reference manual' close to the very bottom of the 'Getting Started' page,
 then take the 'Documentation' link and finally 'Static and shared
 libraries'.

 If additional information could be put in the bjam section of the getting
 started guide then this will 1) ensure less people wonder why the static
 libraries were not built in the first place 2) ensure less people have to
 hunt through the necessary links to find information on building static
 libraries.

--
-- 
Ticket URL: <http://svn.boost.org/trac/boost/ticket/1744#comment:23>
Boost C++ Libraries <http://www.boost.org/>
Boost provides free peer-reviewed portable C++ source libraries.