Re: [Boost-bugs] [Boost C++ Libraries] #1744: Change in default build variants broke "Getting Started"

Subject: Re: [Boost-bugs] [Boost C++ Libraries] #1744: Change in default build variants broke "Getting Started"
From: Boost C++ Libraries (noreply_at_[hidden])
Date: 2008-08-16 09:52:29

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

Comment(by dave):

 The flag, if it is required, doesn't need to be explained in the GSG
 as long as the reader is instructed to use it, and in fact I might be
 willing to assert that it shouldn't be explained there.  This document
 is supposed to be a gentle introduction that leaves out many details.

 That said, I hadn't realized someone put square brackets around the
 flag in the example (and in italics, to boot, which is totally
 inconsistent with the conventions used elsewhere in that document).
 That seems to suggest that the flag is optional.  If, as you say, the
 GSG can't be completed without that flag, then by all means it is
 broken.  We need to make a 2-character change (remove the brackets).
 So I will do that and close this ticket.  Please open new tickets
 against any other components you think are broken, OK?  There's
 nothing wrong with referencing this ticket from those others.

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